summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2013-02-22bump version to 1.7.1Simon McVittie1-3/+9
2013-02-22Imported Upstream version 1.7.0upstream/1.7.0Simon McVittie19-6063/+2189
2013-02-22Prepare release 1.7.0 (and specification 0.20)Simon McVittie1-3/+3
2013-02-18Eliminate unwanted whitespace from the man pages' XML sourceSimon McVittie6-28/+22
As demanded by the git commit hook set up by autogen.sh, this eliminates trailing whitespace on each line, and blank lines at EOF. We might as well do this now, since every line in these files has changed anyway. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de>
2013-02-18Remove doclifter "signature" from Docbook man pages' sourceSimon McVittie6-7/+1
This no longer serves any purpose, and might mislead contributors into thinking that this XML is not the source for the man pages. (The man(7)-formatted man pages used to be the canonical source for the XML, but now it's the other way round.) Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de>
2013-02-14Add @DBUS_VERSION@ to the generated man pagesSimon McVittie5-0/+5
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> [split out of previous patch -smcv] Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-14Turn all man pages' source into configure-generated filesSimon McVittie7-6/+1
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> [dropped whitespace changes per Ralf's review -smcv] Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-14Use Docbook XML as the source for all man pagesSimon McVittie8-1333/+38
This means we no longer need man2html, which is nice. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-14Fill in a manual and source for all man pagesSimon McVittie6-0/+13
I only filled in a version for dbus-daemon, whose XML is already generated by configure. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Ralf Habacker <ralf.habacker@freenet.de> Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-14Updated man docbook xml sources from man page source using doclifter.Ralf Habacker6-282/+651
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2013-02-14Moved docbook sources used by cmake into doc subdir and adapted cmake build ↵Ralf Habacker4-0/+1256
system. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=59805 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2012-11-13Don't include generated documentation in the tarballSimon McVittie1-4/+2
Building it unconditionally causes problems for minimal installations (OSTree), and building it opportunistically means the tarball isn't guaranteed to contain it, depending who releases libdbus and which packages they happen to have installed at the time. If this documentation is important enough that we need to ship it precompiled in tarballs, we should guarantee it; or if it isn't important enough to justify that, we should just drop it. I don't think we really need it in the tarballs at all: most users will get their libdbus from a binary distribution (in which case I expect the distribution's dbus maintainers to set appropriate build-dependencies), and those who build from source can either install xmlto, read the documentation on our website, or at worst, read the source XML. (We don't put the Doxygen-generated API reference HTML in the tarball either, and I haven't heard any complaints.) Bug: https://bugs.freedesktop.org/show_bug.cgi?id=55426 Reviewed-by: Colin Walters <walters@verbum.org>
2012-11-02spec: fix command name REJECT -> REJECTEDPavel Strashkin1-5/+5
Signed-off-by: Pavel Strashkin <pavel.strashkin@nexenta.com> Signed-off-by: Colin Walters <walters@verbum.org>
2012-10-02build: Make --disable-xml-docs build work againColin Walters1-3/+4
We can't build the .html files without xmlto, so don't add them to a dist_ variable. https://bugs.freedesktop.org/show_bug.cgi?id=55426
2012-09-29Imported Upstream version 1.6.8upstream/1.6.8Simon McVittie3-44/+44
2012-09-29Imported Upstream version 1.6.6upstream/1.6.6Simon McVittie3-44/+44
2012-08-09NEWSSimon McVittie1-4/+5
2012-07-18Imported Upstream version 1.6.4upstream/1.6.4Simon McVittie1-1/+1
2012-07-18spec: Mention object path and interface nameColin Walters1-4/+7
We didn't actually have /org/freedesktop/DBus in the spec, nor did we explicitly mention the existence of "org.freedesktop.DBus" as an interface, although it is implicit in the method names. https://bugs.freedesktop.org/show_bug.cgi?id=51865
2012-06-28Merge branch 'dbus-1.6'Simon McVittie1-24/+10
Conflicts: NEWS configure.ac
2012-06-27Imported Upstream version 1.6.2upstream/1.6.2Simon McVittie5-60/+89
2012-06-27Still recommend --exit-with-session in documentation, --exit-with-x11 was ↵Simon McVittie1-4/+4
reverted
2012-06-27Revert "dbus-launch: add --exit-with-x11 option"Simon McVittie1-20/+6
This reverts commit fcc656d430f53ad62c25e41d7e7bd880cbb726a0.
2012-06-15Describe how to marshal arrays, structs, dict-entries, variants in proseSimon McVittie1-17/+62
Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=38252
2012-06-15Promote the marshalling format to a top-level sectionSimon McVittie1-7/+33
Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=38252
2012-06-15Promote the definition of valid object paths and signatures into the type systemSimon McVittie1-125/+126
Also remove the (double!) requirement that signatures be nul-terminated, and turn it into a note about the marshalling format. Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=38252
2012-06-15Define the fixed and string-like types a bit more formallySimon McVittie1-4/+164
Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=38252
2012-06-15Don't claim that all basic types work like INT32: strings don't!Simon McVittie1-3/+3
Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=38252
2012-06-15Define single complete types in the overview of the type systemSimon McVittie1-30/+39
Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=38252
2012-06-15Split Basic and Container types into subsections, promote "Type Signatures" ↵Simon McVittie1-11/+22
to be an intro The "Type Signatures" subsection is basically an introduction to the type system, so it doesn't need a heading of its own. Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=38252
2012-06-15Document that dbus-launch is not dbus-run-sessionSimon McVittie1-0/+13
Architectural assumptions inside dbus-launch mean that it is unsuitable for use in contexts where a particular process's lifetime defines the session, unless there is an out-of-band mechanism (like the X server) which can signal the end of the session. Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=39197
2012-06-15dbus-launch: revise recommendations and put them in an EXAMPLES sectionSimon McVittie1-17/+32
The first thing we should talk about is how to get a D-Bus session in your X session - that's the common case. Secondarily, we can tell command-line addicts how to have a D-Bus session. Do not recommend --exit-with-session here, since that polls (and reads from) stdin, which is harmful to precisely those command-line users! Until we have some better tool, the best we can do here is note that the dbus-daemon is not automatically terminated. Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=39197
2012-06-15dbus-launch: add --exit-with-x11 optionSimon McVittie1-6/+20
This is more suitable for distributions' Xsession scripts: it verifies that X is already available, and so never results in an attempt to poll stdin. Reviewed-by: Will Thompson <will.thompson@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=39197
2012-06-05Imported Upstream version 1.6.0upstream/1.6.0Simon McVittie5-50/+92
2012-06-05Fix distcheck with newer Doxygen: remove *.js, too, during uninstallSimon McVittie1-0/+1
2012-03-27Imported Upstream version 1.5.12upstream/1.5.12Simon McVittie4-27/+121
2012-03-27Merge remote-tracking branch 'alban/own_prefix2'Simon McVittie1-0/+10
Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=46273
2012-03-22doc: update documentation with own_prefix policy rulesAlban Crequy1-0/+10
https://bugs.freedesktop.org/show_bug.cgi?id=46886
2012-03-12spec: document unixexec transportsLennart Poettering1-3/+64
This adds a specification text for the new unixexec: transport. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=35230 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2012-03-12Fix spelling errors in dbus-launch(1)John Bradshaw1-2/+2
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=47076 Bug-Fedora: https://bugzilla.redhat.com/show_bug.cgi?id=675491 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2012-02-21Imported Upstream version 1.5.10upstream/1.5.10Simon McVittie9-154/+484
2012-02-21Prepare 1.5.10Simon McVittie1-1/+10
2012-02-14dbus-send.1: document --reply-timeoutSimon McVittie1-0/+5
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=14005 Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Reviewed-by: Lennart Poettering <lennart@poettering.net>
2012-02-14dbus-send.1, dbus-send: document --print-reply=literal consistentlySimon McVittie1-2/+8
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=14005 Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Reviewed-by: Lennart Poettering <lennart@poettering.net>
2012-02-14dbus-send.1: use bold and italic type consistentlySimon McVittie1-15/+18
According to man-pages(7) * bold is for literal text, the name of the thing being documented, or the name of another man page * italic is for replaceable text, usually in all-caps * normal type (in the SYNOPSIS) is for special syntax like the [] indicating optional things Bug: https://bugs.freedesktop.org/show_bug.cgi?id=14005 Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk> Reviewed-by: Lennart Poettering <lennart@poettering.net>
2012-02-10spec: document systemd transportLennart Poettering1-2/+23
This adds a short section about the systemd transport to the specification. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=35232 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
2012-02-10Merge branch 'system-search-paths-21620'Simon McVittie1-1/+26
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=21620 Reviewed-by: Lennart Poettering <lennart@poettering.net>
2012-02-10Merge branch 'doc-search-paths-35306'Simon McVittie1-3/+19
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=35306 Reviewed-by: Lennart Poettering <lennart@poettering.net>
2012-02-10Merge branch 'reversed-dns-37095'Simon McVittie1-25/+125
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=37095 Reviewed-by: Lennart Poettering <lennart@poettering.net>
2012-02-10bus: introduce --nopidfile switch to disable writing of PID filesLennart Poettering1-0/+4
When used with init systems such as systemd (where PID files are redundant) this allows us to disable PID files even if a path is configured for them in the normal bus configuration files. Make use of this new switch in the systemd unit file. Bug: https://bugs.freedesktop.org/show_bug.cgi?id=45520 Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>