Fix malformed GTK-Doc comment blocks: don't confuse GTK-Doc parsers.

Found these thanks to the improved gobject-introspection
GTK-Doc comment block/annotation parser.
See https://bugzilla.gnome.org/show_bug.cgi?id=672254

https://bugzilla.gnome.org/show_bug.cgi?id=673385
This commit is contained in:
Dieter Verfaillie 2012-04-03 10:56:29 +02:00 committed by Johan Dahlin
parent 0183c1f8a1
commit ce7f1a0789
3 changed files with 15 additions and 15 deletions

View File

@ -3020,32 +3020,32 @@ _sort_keys_func (gconstpointer a,
* and formatting is subject to change at any time. Typical output
* looks something like this:
* <programlisting>
* Type: method-call
* Flags: none
* Version: 0
* Serial: 4
* Headers:
* Type&colon; method-call
* Flags&colon; none
* Version&colon; 0
* Serial&colon; 4
* Headers&colon;
* path -> objectpath '/org/gtk/GDBus/TestObject'
* interface -> 'org.gtk.GDBus.TestInterface'
* member -> 'GimmeStdout'
* destination -> ':1.146'
* Body: ()
* Body&colon; ()
* UNIX File Descriptors:
* (none)
* </programlisting>
* or
* <programlisting>
* Type: method-return
* Flags: no-reply-expected
* Version: 0
* Serial: 477
* Headers:
* Type&colon; method-return
* Flags&colon; no-reply-expected
* Version&colon; 0
* Serial&colon; 477
* Headers&colon;
* reply-serial -> uint32 4
* destination -> ':1.159'
* sender -> ':1.146'
* num-unix-fds -> uint32 1
* Body: ()
* UNIX File Descriptors:
* Body&colon; ()
* UNIX File Descriptors&colon;
* fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635
* </programlisting>
*

View File

@ -116,7 +116,7 @@
* various functions such as g_io_channel_write_chars() to
* write raw bytes to the channel. Encoding and buffering
* issues are dealt with at a higher level.
* @io_seek: (optional) seeks the channel. This is called from
* @io_seek: &lpar;optional&rpar; seeks the channel. This is called from
* g_io_channel_seek() on channels that support it.
* @io_close: closes the channel. This is called from
* g_io_channel_close() after flushing the buffers.

View File

@ -135,7 +135,7 @@ G_BEGIN_DECLS
* @G_PARAM_DEPRECATED: the parameter is deprecated and will be removed
* in a future version. A warning will be generated if it is used
* while running with G_ENABLE_DIAGNOSTIC=1.
* Since: 2.26
* Since 2.26
*
* Through the #GParamFlags flag values, certain aspects of parameters
* can be configured.