Bug 84024 - Doc for server strings differs between pulseaudio.1 and Wiki
Summary: Doc for server strings differs between pulseaudio.1 and Wiki
Status: RESOLVED MOVED
Alias: None
Product: PulseAudio
Classification: Unclassified
Component: misc (show other bugs)
Version: unspecified
Hardware: Other All
: medium normal
Assignee: pulseaudio-bugs
QA Contact: pulseaudio-bugs
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-09-17 23:08 UTC by hortplumber
Modified: 2018-07-30 10:19 UTC (History)
1 user (show)

See Also:
i915 platform:
i915 features:


Attachments
add description of prefix string (1.24 KB, patch)
2014-11-15 15:09 UTC, Peter Meerwald
Details | Splinter Review

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.