diff --git a/configure.in b/configure.in index f4cee6226..d33a6e92b 100644 --- a/configure.in +++ b/configure.in @@ -1606,6 +1606,8 @@ gthread/Makefile docs/Makefile docs/glib-config.1 docs/reference/Makefile +docs/reference/glib/Makefile +docs/reference/gobject/Makefile tests/Makefile ],[case "$CONFIG_FILES" in *glib-config-2.0*)chmod +x glib-config-2.0;; diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index caf9f48bc..ef8c5495d 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,8 @@ +Wed Sep 6 10:59:45 2000 Owen Taylor + + * gobject/Makefile.am glib/Makefile.am: Improve + separation of generic non-generic parts and dependencies. + Tue Sep 5 20:03:25 2000 Owen Taylor * Moved into glib source tree, updated glib-sections.txt diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am new file mode 100644 index 000000000..e84e1506b --- /dev/null +++ b/docs/reference/Makefile.am @@ -0,0 +1 @@ +SUBDIRS = glib gobject \ No newline at end of file diff --git a/docs/reference/glib/.cvsignore b/docs/reference/glib/.cvsignore index 4a6f0576a..1932b0fb4 100644 --- a/docs/reference/glib/.cvsignore +++ b/docs/reference/glib/.cvsignore @@ -1,3 +1,5 @@ +Makefile +Makefile.in glib-unused.txt glib-decl-list.txt glib-decl.txt diff --git a/docs/reference/glib/Makefile.am b/docs/reference/glib/Makefile.am index a18fdef75..bc9b9e95d 100644 --- a/docs/reference/glib/Makefile.am +++ b/docs/reference/glib/Makefile.am @@ -6,10 +6,17 @@ DOC_MODULE=glib # The top-level SGML file. DOC_MAIN_SGML_FILE=glib-docs.sgml -# The directory containing the source code (if it contains documentation). +# The directory containing the source code DOC_SOURCE_DIR=$(top_srcdir) -TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE) +# Headers to ignore +IGNORE_HFILES= \ + gobject \ + config.h \ + gmoduleconf.h \ + gunidecomp.h \ + gunichartables.h \ + glibconfig-sysdefs.h tmpl_sources = \ tmpl/allocators.sgml \ @@ -60,33 +67,37 @@ tmpl_sources = \ tmpl/warnings.sgml \ tmpl/windows.sgml -glib_docdir = $(HTML_DIR) -glib_doc_DATA = \ - glib-sections.txt \ - glib-overrides.txt + +#################################### +# Everything below here is generic # +#################################### + +TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE) EXTRA_DIST = \ - $(glib_doc_DATA) + $(DOC_MAIN_SGML_FILE) \ + $(DOC_MODULE)-sections.txt \ + $(DOC_MODULE)-overrides.txt if ENABLE_GTK_DOC all-local: html/index.html -glib-decl.txt: +$(DOC_MODULE)-decl.txt: $(MAKE) scan -$(tmpl_sources): glib-decl.txt glib-sections.txt glib-overrides.txt +$(tmpl_sources): $(DOC_MODULE)-decl.txt $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt $(MAKE) templates -sgml/glib-doc.bottom: $(tmpl_sources) glib-decl.txt +sgml/$(DOC_MODULE)-doc.bottom: $(tmpl_sources) $(DOC_MODULE)-decl.txt $(MAKE) sgml -html/index.html: sgml/glib-doc.bottom +html/index.html: sgml/$(DOC_MODULE)-doc.bottom $(DOC_MAIN_SGML_FILE) $(MAKE) html endif scan: -(cd $(srcdir) \ - && gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="gobject config.h gmoduleconf.h gunidecomp.h gunichartables.h glibconfig-sysdefs.h" ) + && gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" ) templates: cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) @@ -121,7 +132,18 @@ install-data-local: $(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR); \ fi) -dist-hook: +# +# Require gtk-doc when making dist +# +if ENABLE_GTK_DOC +dist-check-gtkdoc: +else +dist-check-gtkdoc: + @echo "*** gtk-doc must be installed and enabled in order to make dist + @false +endif + +dist-hook: dist-check-gtkdoc mkdir $(distdir)/html mkdir $(distdir)/sgml mkdir $(distdir)/tmpl diff --git a/docs/reference/glib/glib-sections.txt b/docs/reference/glib/glib-sections.txt index 960b921ac..2c80eafd0 100644 --- a/docs/reference/glib/glib-sections.txt +++ b/docs/reference/glib/glib-sections.txt @@ -272,12 +272,6 @@ G_GNUC_PRETTY_FUNCTION G_STRLOC -G_GSHORT_FORMAT -G_GUSHORT_FORMAT -G_GINT_FORMAT -G_GUINT_FORMAT -G_GLONG_FORMAT -G_GULONG_FORMAT G_GINT16_FORMAT G_GUINT16_FORMAT G_GINT32_FORMAT @@ -711,7 +705,7 @@ g_strsignal
Date and Time Functions date -G_MICROSEC +G_USEC_PER_SEC GTimeVal g_get_current_time g_usleep diff --git a/docs/reference/glib/tmpl/allocators.sgml b/docs/reference/glib/tmpl/allocators.sgml index cf354ddc2..7b8807eec 100644 --- a/docs/reference/glib/tmpl/allocators.sgml +++ b/docs/reference/glib/tmpl/allocators.sgml @@ -9,13 +9,11 @@ Memory Allocators - - diff --git a/docs/reference/glib/tmpl/arrays.sgml b/docs/reference/glib/tmpl/arrays.sgml index f40e49ed1..bae144152 100644 --- a/docs/reference/glib/tmpl/arrays.sgml +++ b/docs/reference/glib/tmpl/arrays.sgml @@ -9,13 +9,11 @@ Arrays - - diff --git a/docs/reference/glib/tmpl/arrays_byte.sgml b/docs/reference/glib/tmpl/arrays_byte.sgml index c5d5da2ff..acdb74550 100644 --- a/docs/reference/glib/tmpl/arrays_byte.sgml +++ b/docs/reference/glib/tmpl/arrays_byte.sgml @@ -9,13 +9,11 @@ Byte Arrays - - diff --git a/docs/reference/glib/tmpl/arrays_pointer.sgml b/docs/reference/glib/tmpl/arrays_pointer.sgml index 21d7287d5..c969f2eb0 100644 --- a/docs/reference/glib/tmpl/arrays_pointer.sgml +++ b/docs/reference/glib/tmpl/arrays_pointer.sgml @@ -9,13 +9,11 @@ Pointer Arrays - - diff --git a/docs/reference/glib/tmpl/async_queues.sgml b/docs/reference/glib/tmpl/async_queues.sgml index 97a0f41ac..3065103d0 100644 --- a/docs/reference/glib/tmpl/async_queues.sgml +++ b/docs/reference/glib/tmpl/async_queues.sgml @@ -9,13 +9,11 @@ Asynchronous Queues - - diff --git a/docs/reference/glib/tmpl/byte_order.sgml b/docs/reference/glib/tmpl/byte_order.sgml index 87b455a7b..acd833757 100644 --- a/docs/reference/glib/tmpl/byte_order.sgml +++ b/docs/reference/glib/tmpl/byte_order.sgml @@ -9,13 +9,11 @@ Byte Order Macros - - diff --git a/docs/reference/glib/tmpl/caches.sgml b/docs/reference/glib/tmpl/caches.sgml index 1355726fb..ee51d1f7b 100644 --- a/docs/reference/glib/tmpl/caches.sgml +++ b/docs/reference/glib/tmpl/caches.sgml @@ -9,13 +9,11 @@ Caches - - diff --git a/docs/reference/glib/tmpl/completion.sgml b/docs/reference/glib/tmpl/completion.sgml index adba6c3cf..33b8ba99c 100644 --- a/docs/reference/glib/tmpl/completion.sgml +++ b/docs/reference/glib/tmpl/completion.sgml @@ -9,13 +9,11 @@ Automatic String Completion - - diff --git a/docs/reference/glib/tmpl/datalist.sgml b/docs/reference/glib/tmpl/datalist.sgml index 33df5a353..ef17f99f1 100644 --- a/docs/reference/glib/tmpl/datalist.sgml +++ b/docs/reference/glib/tmpl/datalist.sgml @@ -9,13 +9,11 @@ Keyed Data Lists - - diff --git a/docs/reference/glib/tmpl/datasets.sgml b/docs/reference/glib/tmpl/datasets.sgml index f935397b2..b1105253b 100644 --- a/docs/reference/glib/tmpl/datasets.sgml +++ b/docs/reference/glib/tmpl/datasets.sgml @@ -9,13 +9,11 @@ Datasets - - diff --git a/docs/reference/glib/tmpl/date.sgml b/docs/reference/glib/tmpl/date.sgml index 8ed97ce51..f929872be 100644 --- a/docs/reference/glib/tmpl/date.sgml +++ b/docs/reference/glib/tmpl/date.sgml @@ -9,14 +9,12 @@ Date and Time Functions - - - + diff --git a/docs/reference/glib/tmpl/error_reporting.sgml b/docs/reference/glib/tmpl/error_reporting.sgml index 7bcc55904..132d20077 100644 --- a/docs/reference/glib/tmpl/error_reporting.sgml +++ b/docs/reference/glib/tmpl/error_reporting.sgml @@ -9,13 +9,11 @@ Error Reporting - - diff --git a/docs/reference/glib/tmpl/glib-unused.sgml b/docs/reference/glib/tmpl/glib-unused.sgml index e69de29bb..380562c2c 100644 --- a/docs/reference/glib/tmpl/glib-unused.sgml +++ b/docs/reference/glib/tmpl/glib-unused.sgml @@ -0,0 +1,42 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/reference/glib/tmpl/hash_tables.sgml b/docs/reference/glib/tmpl/hash_tables.sgml index 8c0577826..4846b7b96 100644 --- a/docs/reference/glib/tmpl/hash_tables.sgml +++ b/docs/reference/glib/tmpl/hash_tables.sgml @@ -9,13 +9,11 @@ Hash Tables - - diff --git a/docs/reference/glib/tmpl/hooks.sgml b/docs/reference/glib/tmpl/hooks.sgml index bd74101c9..fecd43c49 100644 --- a/docs/reference/glib/tmpl/hooks.sgml +++ b/docs/reference/glib/tmpl/hooks.sgml @@ -9,13 +9,11 @@ Hook Functions - - diff --git a/docs/reference/glib/tmpl/iochannels.sgml b/docs/reference/glib/tmpl/iochannels.sgml index a9365443c..fcdbeef72 100644 --- a/docs/reference/glib/tmpl/iochannels.sgml +++ b/docs/reference/glib/tmpl/iochannels.sgml @@ -9,13 +9,11 @@ IO Channels - - diff --git a/docs/reference/glib/tmpl/limits.sgml b/docs/reference/glib/tmpl/limits.sgml index 57a65293c..1e73eb045 100644 --- a/docs/reference/glib/tmpl/limits.sgml +++ b/docs/reference/glib/tmpl/limits.sgml @@ -9,13 +9,11 @@ Limits of Basic Types - - diff --git a/docs/reference/glib/tmpl/linked_lists_double.sgml b/docs/reference/glib/tmpl/linked_lists_double.sgml index 1b3a9188f..7e907188d 100644 --- a/docs/reference/glib/tmpl/linked_lists_double.sgml +++ b/docs/reference/glib/tmpl/linked_lists_double.sgml @@ -9,13 +9,11 @@ Doubly-Linked Lists - - diff --git a/docs/reference/glib/tmpl/linked_lists_single.sgml b/docs/reference/glib/tmpl/linked_lists_single.sgml index 6467f7e38..dbab524bc 100644 --- a/docs/reference/glib/tmpl/linked_lists_single.sgml +++ b/docs/reference/glib/tmpl/linked_lists_single.sgml @@ -9,13 +9,11 @@ Singly-Linked Lists - - diff --git a/docs/reference/glib/tmpl/macros.sgml b/docs/reference/glib/tmpl/macros.sgml index bf09e3488..c2a4c2fd1 100644 --- a/docs/reference/glib/tmpl/macros.sgml +++ b/docs/reference/glib/tmpl/macros.sgml @@ -9,13 +9,11 @@ Standard Macros - - diff --git a/docs/reference/glib/tmpl/macros_misc.sgml b/docs/reference/glib/tmpl/macros_misc.sgml index ba10972db..43e4b8b93 100644 --- a/docs/reference/glib/tmpl/macros_misc.sgml +++ b/docs/reference/glib/tmpl/macros_misc.sgml @@ -9,13 +9,11 @@ Miscellaneous Macros - - @@ -137,48 +135,6 @@ Miscellaneous Macros - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/docs/reference/glib/tmpl/main.sgml b/docs/reference/glib/tmpl/main.sgml index 7c12f1e8c..212f500ee 100644 --- a/docs/reference/glib/tmpl/main.sgml +++ b/docs/reference/glib/tmpl/main.sgml @@ -9,13 +9,11 @@ The Main Event Loop - - diff --git a/docs/reference/glib/tmpl/memory.sgml b/docs/reference/glib/tmpl/memory.sgml index c1f236d4e..e940bca38 100644 --- a/docs/reference/glib/tmpl/memory.sgml +++ b/docs/reference/glib/tmpl/memory.sgml @@ -9,13 +9,11 @@ Memory Allocation - - diff --git a/docs/reference/glib/tmpl/memory_chunks.sgml b/docs/reference/glib/tmpl/memory_chunks.sgml index 3f2f596d6..17601e611 100644 --- a/docs/reference/glib/tmpl/memory_chunks.sgml +++ b/docs/reference/glib/tmpl/memory_chunks.sgml @@ -9,13 +9,11 @@ Memory Chunks - - diff --git a/docs/reference/glib/tmpl/messages.sgml b/docs/reference/glib/tmpl/messages.sgml index 7d94f128f..d563744f9 100644 --- a/docs/reference/glib/tmpl/messages.sgml +++ b/docs/reference/glib/tmpl/messages.sgml @@ -9,13 +9,11 @@ Message Logging - - diff --git a/docs/reference/glib/tmpl/misc_utils.sgml b/docs/reference/glib/tmpl/misc_utils.sgml index 5576e1a5d..932d4a2c8 100644 --- a/docs/reference/glib/tmpl/misc_utils.sgml +++ b/docs/reference/glib/tmpl/misc_utils.sgml @@ -9,13 +9,11 @@ Miscellaneous Utility Functions - - diff --git a/docs/reference/glib/tmpl/modules.sgml b/docs/reference/glib/tmpl/modules.sgml index ec1f92a23..3a6410dba 100644 --- a/docs/reference/glib/tmpl/modules.sgml +++ b/docs/reference/glib/tmpl/modules.sgml @@ -9,13 +9,11 @@ Dynamic Loading of Modules - - diff --git a/docs/reference/glib/tmpl/numerical.sgml b/docs/reference/glib/tmpl/numerical.sgml index 4600f572d..aa902d3d9 100644 --- a/docs/reference/glib/tmpl/numerical.sgml +++ b/docs/reference/glib/tmpl/numerical.sgml @@ -9,13 +9,11 @@ Numerical Definitions - - diff --git a/docs/reference/glib/tmpl/quarks.sgml b/docs/reference/glib/tmpl/quarks.sgml index 997e336a6..d6644a0ba 100644 --- a/docs/reference/glib/tmpl/quarks.sgml +++ b/docs/reference/glib/tmpl/quarks.sgml @@ -9,13 +9,11 @@ Quarks - - diff --git a/docs/reference/glib/tmpl/queue.sgml b/docs/reference/glib/tmpl/queue.sgml index 72d95f2ce..c178f27fd 100644 --- a/docs/reference/glib/tmpl/queue.sgml +++ b/docs/reference/glib/tmpl/queue.sgml @@ -9,13 +9,11 @@ Double-ended Queues - - diff --git a/docs/reference/glib/tmpl/random_numbers.sgml b/docs/reference/glib/tmpl/random_numbers.sgml index 233538fb1..037992c06 100644 --- a/docs/reference/glib/tmpl/random_numbers.sgml +++ b/docs/reference/glib/tmpl/random_numbers.sgml @@ -9,13 +9,11 @@ Random Numbers - - diff --git a/docs/reference/glib/tmpl/relations.sgml b/docs/reference/glib/tmpl/relations.sgml index 7bf216f54..9a7a8608a 100644 --- a/docs/reference/glib/tmpl/relations.sgml +++ b/docs/reference/glib/tmpl/relations.sgml @@ -9,13 +9,11 @@ Relations and Tuples - - diff --git a/docs/reference/glib/tmpl/scanner.sgml b/docs/reference/glib/tmpl/scanner.sgml index 0b42f475a..496a9416e 100644 --- a/docs/reference/glib/tmpl/scanner.sgml +++ b/docs/reference/glib/tmpl/scanner.sgml @@ -9,13 +9,11 @@ Lexical Scanner - - diff --git a/docs/reference/glib/tmpl/string_chunks.sgml b/docs/reference/glib/tmpl/string_chunks.sgml index de2462828..43a3364cd 100644 --- a/docs/reference/glib/tmpl/string_chunks.sgml +++ b/docs/reference/glib/tmpl/string_chunks.sgml @@ -9,13 +9,11 @@ String Chunks - - diff --git a/docs/reference/glib/tmpl/string_utils.sgml b/docs/reference/glib/tmpl/string_utils.sgml index 2da378827..655f62fdc 100644 --- a/docs/reference/glib/tmpl/string_utils.sgml +++ b/docs/reference/glib/tmpl/string_utils.sgml @@ -9,13 +9,11 @@ String Utility Functions - - diff --git a/docs/reference/glib/tmpl/strings.sgml b/docs/reference/glib/tmpl/strings.sgml index c9167c23e..ff7859d7c 100644 --- a/docs/reference/glib/tmpl/strings.sgml +++ b/docs/reference/glib/tmpl/strings.sgml @@ -9,13 +9,11 @@ Strings - - diff --git a/docs/reference/glib/tmpl/thread_pools.sgml b/docs/reference/glib/tmpl/thread_pools.sgml index fb1454b66..5d4d0dd73 100644 --- a/docs/reference/glib/tmpl/thread_pools.sgml +++ b/docs/reference/glib/tmpl/thread_pools.sgml @@ -9,13 +9,11 @@ Thread Pools - - diff --git a/docs/reference/glib/tmpl/threads.sgml b/docs/reference/glib/tmpl/threads.sgml index dc1c24561..546eed447 100644 --- a/docs/reference/glib/tmpl/threads.sgml +++ b/docs/reference/glib/tmpl/threads.sgml @@ -9,13 +9,11 @@ Threads - - diff --git a/docs/reference/glib/tmpl/timers.sgml b/docs/reference/glib/tmpl/timers.sgml index 621998dc7..0a05d6cc8 100644 --- a/docs/reference/glib/tmpl/timers.sgml +++ b/docs/reference/glib/tmpl/timers.sgml @@ -9,13 +9,11 @@ Timers - - diff --git a/docs/reference/glib/tmpl/trash_stack.sgml b/docs/reference/glib/tmpl/trash_stack.sgml index 875d21963..2d28613d7 100644 --- a/docs/reference/glib/tmpl/trash_stack.sgml +++ b/docs/reference/glib/tmpl/trash_stack.sgml @@ -9,13 +9,11 @@ Trash Stacks - - diff --git a/docs/reference/glib/tmpl/trees-binary.sgml b/docs/reference/glib/tmpl/trees-binary.sgml index 2e9e50fc0..c19ab9342 100644 --- a/docs/reference/glib/tmpl/trees-binary.sgml +++ b/docs/reference/glib/tmpl/trees-binary.sgml @@ -9,13 +9,11 @@ Balanced Binary Trees - - diff --git a/docs/reference/glib/tmpl/trees-nary.sgml b/docs/reference/glib/tmpl/trees-nary.sgml index a7589e1af..c994ac61c 100644 --- a/docs/reference/glib/tmpl/trees-nary.sgml +++ b/docs/reference/glib/tmpl/trees-nary.sgml @@ -9,13 +9,11 @@ N-ary Trees - - diff --git a/docs/reference/glib/tmpl/type_conversion.sgml b/docs/reference/glib/tmpl/type_conversion.sgml index d63aee644..dd4adec70 100644 --- a/docs/reference/glib/tmpl/type_conversion.sgml +++ b/docs/reference/glib/tmpl/type_conversion.sgml @@ -9,13 +9,11 @@ Type Conversion Macros - - diff --git a/docs/reference/glib/tmpl/types.sgml b/docs/reference/glib/tmpl/types.sgml index e64242ec7..92f5b5471 100644 --- a/docs/reference/glib/tmpl/types.sgml +++ b/docs/reference/glib/tmpl/types.sgml @@ -9,13 +9,11 @@ Basic Types - - diff --git a/docs/reference/glib/tmpl/unicode.sgml b/docs/reference/glib/tmpl/unicode.sgml index db8cc03ee..413cc89eb 100644 --- a/docs/reference/glib/tmpl/unicode.sgml +++ b/docs/reference/glib/tmpl/unicode.sgml @@ -9,13 +9,11 @@ Unicode Manipulation - - @@ -326,6 +324,8 @@ Unicode Manipulation @p: @end: @Returns: + +@bound: @@ -367,6 +367,8 @@ Unicode Manipulation @p: @c: @Returns: + +@ch: @@ -377,6 +379,8 @@ Unicode Manipulation @p: @c: @Returns: + +@ch: diff --git a/docs/reference/glib/tmpl/warnings.sgml b/docs/reference/glib/tmpl/warnings.sgml index ca360571e..451d3290d 100644 --- a/docs/reference/glib/tmpl/warnings.sgml +++ b/docs/reference/glib/tmpl/warnings.sgml @@ -9,13 +9,11 @@ Warnings and Assertions - - diff --git a/docs/reference/glib/tmpl/windows.sgml b/docs/reference/glib/tmpl/windows.sgml index 16d841a9b..e07c6a839 100644 --- a/docs/reference/glib/tmpl/windows.sgml +++ b/docs/reference/glib/tmpl/windows.sgml @@ -9,13 +9,11 @@ Windows Compatability Functions - - diff --git a/docs/reference/gobject/.cvsignore b/docs/reference/gobject/.cvsignore index 8702e770e..8136b3153 100644 --- a/docs/reference/gobject/.cvsignore +++ b/docs/reference/gobject/.cvsignore @@ -1,3 +1,5 @@ +Makefile +Makefile.in gobject-decl.txt gobject-unused.txt gobject-decl-list.txt diff --git a/docs/reference/gobject/Makefile.am b/docs/reference/gobject/Makefile.am index 451cdad66..532774d23 100644 --- a/docs/reference/gobject/Makefile.am +++ b/docs/reference/gobject/Makefile.am @@ -9,7 +9,8 @@ DOC_MAIN_SGML_FILE=gobject-docs.sgml # The directory containing the source code (if it contains documentation). DOC_SOURCE_DIR=$(top_srcdir)/gobject -TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE) +# Headers to ignore +IGNORE_HFILES= tmpl_sources = \ tmpl/enumerations_flags.sgml \ @@ -22,35 +23,38 @@ tmpl_sources = \ tmpl/value_collection.sgml \ tmpl/value_types.sgml -gobject_docdir = $(HTML_DIR) -gobject_doc_DATA = \ - gobject-sections.txt +#################################### +# Everything below here is generic # +#################################### +TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE) EXTRA_DIST = \ - $(gobject_doc_DATA) + $(DOC_MAIN_SGML_FILE) \ + $(DOC_MODULE)-sections.txt \ + $(DOC_MODULE)-overrides.txt if ENABLE_GTK_DOC all-local: html/index.html -gobject-decl.txt: +$(DOC_MODULE)-decl.txt: $(MAKE) scan -$(tmpl_sources): gobject-decl.txt gobject-sections.txt +$(tmpl_sources): $(DOC_MODULE)-decl.txt $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt $(MAKE) templates -sgml/gobject-doc.bottom: $(tmpl_sources) gobject-decl.txt +sgml/$(DOC_MODULE)-doc.bottom: $(tmpl_sources) $(DOC_MODULE)-decl.txt $(MAKE) sgml -html/index.html: sgml/gobject-doc.bottom +html/index.html: sgml/$(DOC_MODULE)-doc.bottom $(DOC_MAIN_SGML_FILE) $(MAKE) html endif scan: -(cd $(srcdir) \ - && gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) ) + && gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" ) -templates: +templates: cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) sgml: @@ -60,8 +64,8 @@ sgml: html: test -d $(srcdir)/html || mkdir $(srcdir)/html -cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) - @echo '-- Fixing Crossreferences' - gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) --extra-dir=$(srcdir)/../glib/html + @echo '-- Fixing Crossreferences' + gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) clean-local: rm -f *~ *.bak *.signals *-unused.txt @@ -83,7 +87,18 @@ install-data-local: $(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR); \ fi) -dist-hook: +# +# Require gtk-doc when making dist +# +if ENABLE_GTK_DOC +dist-check-gtkdoc: +else +dist-check-gtkdoc: + @echo "*** gtk-doc must be installed and enabled in order to make dist + @false +endif + +dist-hook: dist-check-gtkdoc mkdir $(distdir)/html mkdir $(distdir)/sgml mkdir $(distdir)/tmpl diff --git a/docs/reference/gobject/gobject-docs.sgml b/docs/reference/gobject/gobject-docs.sgml index bd337060b..c8a907d31 100644 --- a/docs/reference/gobject/gobject-docs.sgml +++ b/docs/reference/gobject/gobject-docs.sgml @@ -16,13 +16,14 @@ API Reference - &gobject-types; - &gobject-objects; - &gobject-enumerations-flags; - &gobject-generic-values; - &gobject-value-types; - &gobject-value-collection; - &gobject-param-specs; - &gobject-standard-params; + &gobject-types; + &gobject-objects; + &gobject-enumerations-flags; + &gobject-generic-values; + &gobject-value-types; + &gobject-value-collection; + &gobject-param-specs; + &gobject-standard-params; + \ No newline at end of file diff --git a/docs/reference/gobject/gobject-overrides.txt b/docs/reference/gobject/gobject-overrides.txt new file mode 100644 index 000000000..e69de29bb diff --git a/docs/reference/gobject/tmpl/enumerations_flags.sgml b/docs/reference/gobject/tmpl/enumerations_flags.sgml index 0c03fc619..971195e5d 100644 --- a/docs/reference/gobject/tmpl/enumerations_flags.sgml +++ b/docs/reference/gobject/tmpl/enumerations_flags.sgml @@ -9,13 +9,11 @@ Enumeration and Flag Types - - diff --git a/docs/reference/gobject/tmpl/generic_values.sgml b/docs/reference/gobject/tmpl/generic_values.sgml index 18f2a2f03..af4cbe6c2 100644 --- a/docs/reference/gobject/tmpl/generic_values.sgml +++ b/docs/reference/gobject/tmpl/generic_values.sgml @@ -9,13 +9,11 @@ Generic values - - diff --git a/docs/reference/gobject/tmpl/objects.sgml b/docs/reference/gobject/tmpl/objects.sgml index ee2a7d21a..a82953c80 100644 --- a/docs/reference/gobject/tmpl/objects.sgml +++ b/docs/reference/gobject/tmpl/objects.sgml @@ -9,13 +9,11 @@ The Base Object Type - - diff --git a/docs/reference/gobject/tmpl/param_specs.sgml b/docs/reference/gobject/tmpl/param_specs.sgml index 7ce7b0922..2401f5e99 100644 --- a/docs/reference/gobject/tmpl/param_specs.sgml +++ b/docs/reference/gobject/tmpl/param_specs.sgml @@ -9,13 +9,11 @@ Object Parameter Specifications - - diff --git a/docs/reference/gobject/tmpl/standard_params.sgml b/docs/reference/gobject/tmpl/standard_params.sgml index 5d297355f..763d4473b 100644 --- a/docs/reference/gobject/tmpl/standard_params.sgml +++ b/docs/reference/gobject/tmpl/standard_params.sgml @@ -9,13 +9,11 @@ Standard Parameter Types - - diff --git a/docs/reference/gobject/tmpl/types.sgml b/docs/reference/gobject/tmpl/types.sgml index dce9f4da5..a42851cf1 100644 --- a/docs/reference/gobject/tmpl/types.sgml +++ b/docs/reference/gobject/tmpl/types.sgml @@ -9,13 +9,11 @@ GType - - diff --git a/docs/reference/gobject/tmpl/value_collection.sgml b/docs/reference/gobject/tmpl/value_collection.sgml index 2066012ba..dfb502d22 100644 --- a/docs/reference/gobject/tmpl/value_collection.sgml +++ b/docs/reference/gobject/tmpl/value_collection.sgml @@ -9,13 +9,11 @@ Varargs Value Collection - - diff --git a/docs/reference/gobject/tmpl/value_types.sgml b/docs/reference/gobject/tmpl/value_types.sgml index 86bca6c1f..e8b37f3bd 100644 --- a/docs/reference/gobject/tmpl/value_types.sgml +++ b/docs/reference/gobject/tmpl/value_types.sgml @@ -9,13 +9,11 @@ Standard value types - -