Bug 84024

Summary:	Doc for server strings differs between pulseaudio.1 and Wiki
Product:	PulseAudio	Reporter:	hortplumber
Component:	misc	Assignee:	pulseaudio-bugs
Status:	RESOLVED MOVED	QA Contact:	pulseaudio-bugs
Severity:	normal
Priority:	medium	CC:	lennart
Version:	unspecified
Hardware:	Other
OS:	All
Whiteboard:
i915 platform:		i915 features:
Attachments:	add description of prefix string

Description hortplumber 2014-09-17 23:08:39 UTC

NOTE: This may have been fixed by 62444, not sure, just reporting it for completeness.

The pulseaudio.1 man page describes the format of the server strings permitted for $PULSE_SERVER as (e.g.) "tcp4:hostname:port". But the Wiki page

   http://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/ServerStrings/

gives a much richer syntax that also allows server specification via socket path, and also permits conditionalization based on the leading host enclosed in braces.

Not sure which is currently correct, just pointing out the inconsistency.

Comment 1 Peter Meerwald 2014-11-15 14:57:55 UTC

the wording in pulseaudio.1 pretty must describes what is stated in the wiki

what is missing is:
"If it starts with a string enclosed in {} the address string is ignored unless the local hostname or D-Bus machine id equals the string in the {}. Otherwise this prefix is skipped."

Comment 2 Peter Meerwald 2014-11-15 15:08:08 UTC

The sentence "Otherwise this prefix is skipped." is redundant and should be dropped.

Comment 3 Peter Meerwald 2014-11-15 15:09:09 UTC

Created attachment 109524 [details] [review]
add description of prefix string

"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."

Comment 4 GitLab Migration User 2018-07-30 10:19:09 UTC

-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/pulseaudio/pulseaudio/issues/339.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.