Bug 59808

Summary:	Platform related overhaul of dbus documentation
Product:	dbus	Reporter:	Ralf Habacker <ralf.habacker>
Component:	core	Assignee:	D-Bus Maintainers <dbus>
Status:	RESOLVED MOVED	QA Contact:	D-Bus Maintainers <dbus>
Severity:	enhancement
Priority:	medium	CC:	msniko14
Version:	1.5
Hardware:	All
OS:	All
Whiteboard:
i915 platform:		i915 features:

Description Ralf Habacker 2013-01-24 13:59:28 UTC

Here required changes of the platform related doc changes may be collected. 

from bug 42441: 

How about this for some installation-neutral wording which could go in the man page, avoiding having to do the dbus-daemon.1.in -> dbus-daemon.1 dance?

"""
The --session option is equivalent to using --config-file to select the standard configuration file session.conf provided with D-Bus. Similarly, the --system option is equivalent to using --config-file to select system.conf. These files are typically found in /etc/dbus-1 on Unix systems, or in the etc/dbus-1 subdirectory of the installation root on Windows systems.
"""

Comment 1 Ralf Habacker 2013-02-04 20:05:21 UTC

(In reply to comment #0)
> Here required changes of the platform related doc changes may be collected. 
> 
> from bug 42441: 
> 
> How about this for some installation-neutral wording which could go in the
> man page, avoiding having to do the dbus-daemon.1.in -> dbus-daemon.1 dance?
> 
> """
> The --session option is equivalent to using --config-file to select the
> standard configuration file session.conf provided with D-Bus. Similarly, the
> --system option is equivalent to using --config-file to select system.conf.
> These files are typically found in /etc/dbus-1 on Unix systems, or in the
> etc/dbus-1 subdirectory of the installation root on Windows systems.
> """

Do you have noticed that there are a few more references to @EXPANDED_SYSCONFDIR@ ? 

30:"\-\-config\-file=@EXPANDED_SYSCONFDIR@/dbus\-1/session.conf" and the \-\-system
32:"\-\-config\-file=@EXPANDED_SYSCONFDIR@/dbus\-1/system.conf". By creating
117:configured in the files "@EXPANDED_SYSCONFDIR@/dbus\-1/system.conf" and
118:"@EXPANDED_SYSCONFDIR@/dbus\-1/session.conf".  These files normally
194:@EXPANDED_SYSCONFDIR@/dbus\-1/system.d that allowed all apps to receive
330:@EXPANDED_SYSCONFDIR@/dbus\-1/session.conf. Putting it in any other
339:This option defaults to @EXPANDED_DATADIR@/dbus\-1/system\-services.
344:@EXPANDED_SYSCONFDIR@/dbus\-1/system.conf. Putting it in any other
357:defined in @EXPANDED_SYSCONFDIR@/dbus\-1/system.conf. Putting it in any other

Comment 2 Simon McVittie 2013-02-12 11:22:14 UTC

(In reply to comment #1)
> Do you have noticed that there are a few more references to
> @EXPANDED_SYSCONFDIR@ ? 

I hadn't. I think I'd still prefer the man page to be platform-neutral (so it's something we can sensibly publish on the web) but it'll be more work to come up with platform-neutral wording for those bits.

Comment 3 GitLab Migration User 2018-10-12 21:15:25 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/dbus/dbus/issues/78.

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.