[patch] C99 restrict support

[Roger Leigh <rleigh whinlatter ukfsn org>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi folks,

I've made a patch to add support for the C99 "restrict" keyword.  It's
here: http://bugzilla.gnome.org/attachment.cgi?id=36601&action=view
(against version 1.2; I can redo against the current CVS if needed).

With the patch, gtkdoc-mktmpl and gtkdoc-mkdb now correctly parse C99
source and generate correct documentation.  However, some functions
are not correctly parsed.  Since I'm not a gtk-doc expert, could
anyone tell me if this is due to the patch or a problem with my use of
gtk-doc in the source tree?

When the docs are generated, I get this:

*** Rebuilding template files ***
cd . && gtkdoc-mktmpl --module=uterm
WARNING: No declaration for: uterm_code_table_get_start_char
WARNING: No declaration for: uterm_code_table_get_num_chars
WARNING: No declaration for: uterm_code_table_get_map_start_char
WARNING: No declaration for: uterm_code_table_get_map_num_chars
WARNING: No declaration for: uterm_code_table_map_get_start_char
WARNING: No declaration for: uterm_code_table_map_get_num_chars
WARNING: No declaration for: uterm_code_table_map_get_map_start_char
touch tmpl-build.stamp
*** Building XML ***
cd . && \
gtkdoc-mkdb --module=uterm --source-dir=../../../uterm --output-format=xml
WARNING: No declaration for: uterm_code_table_get_start_char
WARNING: No declaration for: uterm_code_table_get_num_chars
WARNING: No declaration for: uterm_code_table_get_map_start_char
WARNING: No declaration for: uterm_code_table_get_map_num_chars
WARNING: Parameter description missing in source code comment block -
         Func: uterm_code_table_map_get_table Param: Returns.
WARNING: Parameter described in source code comment block but does not exist -
         Func: uterm_code_table_map_get_table Param: table.
WARNING: Parameter described in source code comment block but does not exist -
         Func: uterm_code_table_map_new Param: map_start_char.
WARNING: Parameter described in source code comment block but does not exist -
         Func: uterm_code_table_map_new Param: num_chars.
WARNING: Parameter description missing in source code comment block -
         Func: uterm_code_table_map_lookup_char Param: code_table.
WARNING: Parameter description missing in source code comment block -
         Func: uterm_code_table_map_lookup_char Param: Returns.
WARNING: Parameter described in source code comment block but does not exist -
         Func: uterm_code_table_map_lookup_char Param: map.
WARNING: No declaration for: uterm_code_table_map_get_start_char
WARNING: No declaration for: uterm_code_table_map_get_num_chars
WARNING: No declaration for: uterm_code_table_map_get_map_start_char
WARNING: Parameter description missing in source code comment block -
         Func: uterm_code_structure_set_c1_element Param: cr_area.
49% symbol docs coverage (56 symbols documented, 59 not documented)

It's the "WARNING: No declaration for: xxx" messages that worry me
most (the others are due to the docs being incomplete).  What is
causing these warnings?

The source code that shows this problem can be found here:
http://www.whinlatter.ukfsn.org/gtk/uterm-0.1.0.tar.bz2


Many thanks!
Roger

- -- 
Roger Leigh
                Printing on GNU/Linux?  http://gimp-print.sourceforge.net/
                Debian GNU/Linux        http://www.debian.org/
                GPG Public Key: 0x25BFB848.  Please sign and encrypt your mail.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.5 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.8 <http://mailcrypt.sourceforge.net/>

iD8DBQFB+RLlVcFcaSW/uEgRAmipAKCxeTibnbmC5k0LhVz9AEQi1SxH7ACgvyFR
EdOrk9oAluv5EbztELLucsU=
=xVNx
-----END PGP SIGNATURE-----