maryjane
/
syncevolution
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
syncevolution/src/dbus/interfaces
History
Patrick Ohly 83dcba8486 autotools: fix race condition related to src/dbus/interfaces docs 
Only saw this once in nightly testing and couldn't reproduce it:

$ make -j 16
perl /data/runtests/work/sources/syncevolution/src/syncevo/readme2c.pl
    /data/runtests/work/sources/syncevolution/README.rst
    >src/syncevo/CmdlineHelp.c
/usr/bin/xsltproc -o src/dbus/interfaces/syncevo-server-doc.xml
    /data/runtests/work/sources/syncevolution/src/dbus/interfaces/spec-to-docbook.xsl
    /data/runtests/work/sources/syncevolution/src/dbus/interfaces/syncevo-server-full.xml
/usr/bin/xsltproc -o src/dbus/interfaces/syncevo-connection-doc.xml
    /data/runtests/work/sources/syncevolution/src/dbus/interfaces/spec-to-docbook.xsl
    /data/runtests/work/sources/syncevolution/src/dbus/interfaces/syncevo-connection-full.xml
/usr/bin/xsltproc -o src/dbus/interfaces/syncevo-session-doc.xml
    /data/runtests/work/sources/syncevolution/src/dbus/interfaces/spec-to-docbook.xsl
    /data/runtests/work/sources/syncevolution/src/dbus/interfaces/syncevo-session-full.xml
/usr/bin/glib-genmarshal
    /data/runtests/work/sources/syncevolution/src/dbus/glib/syncevo-marshal.list
    --header --prefix=syncevo_marshal > src/dbus/glib/syncevo-marshal.h
runtime error
xsltApplyStylesheet: saving to src/dbus/interfaces/syncevo-session-doc.xml may
    not be possible
/usr/bin/xsltproc -o src/dbus/glib/syncevo-server.xml
    /data/runtests/work/sources/syncevolution/src/dbus/interfaces/spec-strip-docs.xsl
    /data/runtests/work/sources/syncevolution/src/dbus/interfaces/syncevo-server-full.xml
runtime error
xsltApplyStylesheet: saving to src/dbus/interfaces/syncevo-server-doc.xml may
    not be possible
make: *** [src/dbus/interfaces/syncevo-server-doc.xml] Error 9
make: *** Deleting file `src/dbus/interfaces/syncevo-server-doc.xml'
make: *** Waiting for unfinished jobs....
make: *** [src/dbus/interfaces/syncevo-session-doc.xml] Error 9
make: *** Deleting file `src/dbus/interfaces/syncevo-session-doc.xml'

Looks like multiple xsltproc commands ran in parallel and then stepped on each
others toes while creating the src/dbus/interfaces directory, which does not
exist after an out-of-tree configure.

To address the issue, serialize creating that directory by having make create
it as a prerequisite.
 		2013-09-04 11:09:34 +02:00
..
README Doc: enhanced D-Bus API documentation (MBC #1745) 2010-06-08 17:20:14 +02:00
dbus-introspect-docs.dtd Doc: enhanced D-Bus API documentation (MBC #1745) 2010-06-08 17:20:14 +02:00
interfaces.am autotools: fix race condition related to src/dbus/interfaces docs 2013-09-04 11:09:34 +02:00
spec-strip-docs.xsl D-Bus Qt bindings: remove annotations for glib 2010-06-08 17:06:55 +02:00
spec-to-docbook.xsl Doc: enhanced D-Bus API documentation (MBC #1745) 2010-06-08 17:20:14 +02:00
syncevo-connection-full.xml Revert "Use the newer org.qtproject.QtDBus annotation for DBus interfaces" 2012-07-29 11:20:56 +02:00
syncevo-server-full.xml D-Bus interface XML: avoid "template" as parameter name 2012-07-29 11:27:40 +02:00
syncevo-session-full.xml D-Bus interface XML: fix incorrect numbering of parameter annotation in Session.SetNamedConfig() 2012-07-29 11:39:02 +02:00

README 

The documentation of .xml files follows dbus-introspect-docs.dtd
and uses spec-to-docbook.xsl from William Jon McCann <jmccann@redhat.com>
to convert the documentation into DocBook and then HTML.

See http://cgit.freedesktop.org/ConsoleKit/tree/doc/dbus for latest (?)
copy of the script and http://cgit.freedesktop.org/ConsoleKit/tree/src
for some examples.