diff --git a/doc/Doxyfile.in b/doc/Doxyfile.in index e233181e..e7abe324 100644 --- a/doc/Doxyfile.in +++ b/doc/Doxyfile.in @@ -793,7 +793,8 @@ INPUT = @top_srcdir@/src/ \ @top_srcdir@/tagmanager/src/tm_source_file.c \ @top_srcdir@/tagmanager/src/tm_source_file.h \ @top_srcdir@/tagmanager/src/tm_workspace.c \ - @top_srcdir@/tagmanager/src/tm_workspace.h + @top_srcdir@/tagmanager/src/tm_workspace.h \ + @top_srcdir@/tagmanager/src/tm_parser.h # This tag can be used to specify the character encoding of the source files # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses diff --git a/scripts/gen-api-gtkdoc.py b/scripts/gen-api-gtkdoc.py index cbc2f4c5..d3ae4ef7 100755 --- a/scripts/gen-api-gtkdoc.py +++ b/scripts/gen-api-gtkdoc.py @@ -399,11 +399,9 @@ def main(args): try: outfile.write("/*\n * Automatically generated file - do not edit\n */\n\n") - outfile.write("#include \n") - outfile.write("#include \n\n") - outfile.write("typedef struct _ScintillaObject ScintillaObject;\n") - outfile.write("typedef struct TMSourceFile TMSourceFile;\n") - outfile.write("typedef struct TMWorkspace TMWorkspace;\n") + outfile.write("#include \"gtkcompat.h\"\n") + outfile.write("#include \"Scintilla.h\"\n") + outfile.write("#include \"ScintillaWidget.h\"\n") # write enums first, so typedefs to them are valid (as forward enum declaration # is invalid). It's fine as an enum can't contain reference to other types. diff --git a/tagmanager/src/tm_parser.h b/tagmanager/src/tm_parser.h index 9b3c2374..fb481f77 100644 --- a/tagmanager/src/tm_parser.h +++ b/tagmanager/src/tm_parser.h @@ -10,6 +10,9 @@ #ifndef TM_PARSER_H #define TM_PARSER_H +/** @gironly + * A integral type which can hold known parser type IDs + **/ typedef gint TMParserType; diff --git a/tagmanager/src/tm_source_file.h b/tagmanager/src/tm_source_file.h index 2ecd9d7b..ae901587 100644 --- a/tagmanager/src/tm_source_file.h +++ b/tagmanager/src/tm_source_file.h @@ -33,9 +33,9 @@ extern "C" /** - The TMSourceFile structure represents the source file and its tags in the tag manager. -*/ -typedef struct + * The TMSourceFile structure represents the source file and its tags in the tag manager. + **/ +typedef struct TMSourceFile { TMParserType lang; /* Programming language used */ char *file_name; /**< Full file name (inc. path) */ diff --git a/tagmanager/src/tm_workspace.h b/tagmanager/src/tm_workspace.h index 173766b9..e4743fd3 100644 --- a/tagmanager/src/tm_workspace.h +++ b/tagmanager/src/tm_workspace.h @@ -22,11 +22,11 @@ extern "C" /** The Tag Manager Workspace. This is a singleton object containing a list - of individual source files. There is also a global tag list - which can be loaded or created. This contains global tags gleaned from - /usr/include, etc. and should be used for autocompletion, calltips, etc. -*/ -typedef struct + * of individual source files. There is also a global tag list + * which can be loaded or created. This contains global tags gleaned from + * /usr/include, etc. and should be used for autocompletion, calltips, etc. + **/ +typedef struct TMWorkspace { GPtrArray *global_tags; /**< Global tags loaded at startup */ GPtrArray *source_files; /**< An array of TMSourceFile pointers */