[pulseaudio-discuss] [PATCH] man: Describe optional prefix {string} in server address

[Tanu Kaskinen]

On Sat, 2014-11-15 at 16:10 +0100, Peter Meerwald wrote:
> see https://bugs.freedesktop.org/show_bug.cgi?id=84024
> 
> Signed-off-by: Peter Meerwald <pmeerw at pmeerw.net>
> ---
>  man/pulseaudio.1.xml.in | 4 +++-
>  1 file changed, 3 insertions(+), 1 deletion(-)
> 
> diff --git a/man/pulseaudio.1.xml.in b/man/pulseaudio.1.xml.in
> index 7a97379..dd787bb 100644
> --- a/man/pulseaudio.1.xml.in
> +++ b/man/pulseaudio.1.xml.in
> @@ -459,7 +459,9 @@ USA.
>      server addresses separated by whitespace which are tried in turn. A server
>      address consists of an optional address type specifier (unix:, tcp:, tcp4:,
>      tcp6:), followed by a path or host address. A host address may include an
> -    optional port number.</p>
> +    optional port number. A server address may be prefixed by a string enclosed
> +    in {}. In this case the following server address is ignored unless the prefix
> +    string equals the local hostname or D-Bus machine.</p>

Did you mean to write "the D-Bus machine id"? Note that the machine id
is nowadays not specific to D-Bus, although it originated there. I'd
formulate it this way: "unless the prefix string equals the local
hostname or the machine id (/etc/machine-id)."

-- 
Tanu