Bug 59808 - Platform related overhaul of dbus documentation
Summary: Platform related overhaul of dbus documentation
Status: RESOLVED MOVED
Alias: None
Product: dbus
Classification: Unclassified
Component: core (show other bugs)
Version: 1.5
Hardware: All All
: medium enhancement
Assignee: D-Bus Maintainers
QA Contact: D-Bus Maintainers
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-01-24 13:59 UTC by Ralf Habacker
Modified: 2018-10-12 21:15 UTC (History)
1 user (show)

See Also:
i915 platform:
i915 features:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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.