luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-03-15 04:05:11 +01:00
Code Issues Packages Projects Releases Wiki Activity

gdbus-codegen: Update man page to reflect how --annotate actually works

Browse Source 
Signed-off-by: David Zeuthen <davidz@redhat.com>
This commit is contained in:
David Zeuthen 2011-09-21 06:57:29 -04:00
parent 70515ffe92
commit 30537b84de
1 changed files with 14 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
docs/reference/gio/gdbus-codegen.xml
View File

@ -22,11 +22,9 @@
<group choice="plain" rep="repeat"> <group choice="plain" rep="repeat">
<arg> <arg>
<option>--annotate</option> <option>--annotate</option>
<replaceable>element</replaceable> <replaceable>ELEMENT</replaceable>
<option>--key</option> <replaceable>KEY</replaceable>
<replaceable>key</replaceable> <replaceable>VALUE</replaceable>
<option>--value</option>
<replaceable>key</replaceable>
</arg> </arg>
</group> </group>
<arg choice="plain">FILE</arg> <arg choice="plain">FILE</arg>
@ -142,34 +140,32 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--annotate</option> <option>--key</option> <replaceable>KEY</replaceable> <option>--value</option> <replaceable>VALUE</replaceable></term> <term><option>--annotate</option> <replaceable>ELEMENT</replaceable> <replaceable>KEY</replaceable> <replaceable>VALUE</replaceable></term>
<listitem> <listitem>
<para> <para>
Used together with <option>--key</option> and Used to inject D-Bus annotations into the given XML
<option>--value</option> to annotate the given XML files (for each <option>--annotate</option>, there must be exactly one <option>--key</option> and <option>--value</option>). It files. It can be used with interfaces, methods, signals,
can be used with interfaces, methods, signals, properties properties and arguments in the following way:
and arguments in the following way:
</para> </para>
<informalexample><programlisting><![CDATA[ <informalexample><programlisting><![CDATA[
gdbus-codegen --c-namespace MyApp \ gdbus-codegen --c-namespace MyApp \
--generate-c-code myapp-generated \ --generate-c-code myapp-generated \
--annotate "org.project.InterfaceName" \ --annotate "org.project.InterfaceName" \
--key org.gtk.GDBus.C.Name --value MyFrobnicator \ org.gtk.GDBus.C.Name MyFrobnicator \
--annotate "org.project.InterfaceName:Property" \ --annotate "org.project.InterfaceName:Property" \
--key bar --value bat \ bar bat \
--annotate "org.project.InterfaceName.Method()" \ --annotate "org.project.InterfaceName.Method()" \
--key org.freedesktop.DBus.Deprecated --value true \ org.freedesktop.DBus.Deprecated true \
--annotate "org.project.InterfaceName.Method()[arg_name]" \ --annotate "org.project.InterfaceName.Method()[arg_name]" \
--key snake --value hiss \ snake hiss \
--annotate "org.project.InterfaceName::Signal" \ --annotate "org.project.InterfaceName::Signal" \
--key cat --value meow \ cat meow \
--annotate "org.project.InterfaceName::Signal[arg_name]" \ --annotate "org.project.InterfaceName::Signal[arg_name]" \
--key dog --value wuff \ dog wuff \
myapp-dbus-interfaces.xml myapp-dbus-interfaces.xml
]]></programlisting></informalexample> ]]></programlisting></informalexample>
<para> <para>
Any UTF-8 string can be used for the value of Any UTF-8 string can be used for <replaceable>KEY</replaceable> and <replaceable>VALUE</replaceable>.
<option>--key</option> and <option>--value</option>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>