[patch][dbus] Replace Python section of tutorial with a
pointer to the dbus-python tutorial
John (J5) Palmieri
johnp at redhat.com
Thu Jan 25 08:28:11 PST 2007
On Thu, 2007-01-25 at 13:25 +0000, Simon McVittie wrote:
> Not *exactly* a patch (sending all the removed lines to the list seems
> a little pointless :-) but I propose to replace the Python client and
> server sections of D-Bus core's tutorial.xml with a pointer to the
> separate tutorial in dbus-python. It's not finished, but is already more
> complete than the Python parts of the D-Bus core tutorial, I think.
>
> Any review of, or additions to, the dbus-python tutorial would also be
> much appreciated. The source is doc/tutorial.txt.in in dbus-python git
> (the only reason it's a .in is to substitute @VERSION@, which I think
> I'll just take out in the next release anyway) and is in
> reStructuredText (http://docutils.sf.net/docs/user/rst/quickstart.html -
> if you just write plain text it'll usually do the right thing).
>
> Simon
>
> Pseudo-patch:
> </sect1>
>
> <sect1 id="python-client">
> - <title>Python API: Using Remote Objects</title>
> + <title>Python API</title>
> <para>
> - The Python bindings provide a simple to use interface for talking over D-Bus.
> - Where possible much of the inner-workings of D-Bus are hidden behind what looks
> - like normal Python objects.
> + The Python API, dbus-python, is now documented separately in
> + <ulink url="http://dbus.freedesktop.org/doc/dbus-python/doc/tutorial.html">the dbus-python tutorial</ulink> (also available in doc/tutorial.txt,
> + and doc/tutorial.html if built with python-docutils, in the dbus-python
> + source distribution).
> </para>
> [... the rest of python-client, and all of python-server, deleted ...]
> </sect1>
>
> <sect1 id="qt-client">
Looks good. Feel free to commit.
--
John (J5) Palmieri <johnp at redhat.com>
More information about the dbus
mailing list