mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-03-29 02:50:04 +01:00
Commit ab0e9dbfa76e056f875e969c0d7b6e133ec75431 introduced some changes to the documentation Makefiles designed to clean-up the process of deciding which headers get scanned for the docs. Unfortunately, the gtk-doc Makefile doesn't use HFILE_GLOB for actually generating the docs -- only for knowing when it needs to redo the generation. Because of this, we need to use IGNORE_HFILES or otherwise we get hundreds of symbols in the *-unused.txt files. Revert the changes that that commit made to the docs Makefiles (but leave the generation of the *-public-headers.txt files in place).
This package contains the reference documentation for GLib. For more information about Glib, see: http://www.gtk.org For information about contributing to the GLib/GTK+ reference documentation project, see: http://www.gtk.org/rdp/ The GLib reference documentation is freely redistributable, see the file COPYING for details. REQUIREMENTS ============ To build the documentation, you must have the gtk-doc package installed. To rebuild the template files, you must have the current version of the GLib header files installed. BUILD ===== First, run configure to generate the makefiles for this module. There is one option specific to this package --with-html-dir=DIR top of installed HTML documentation tree The Makefiles for this module define three targets: templates: Scan the headers and merge the results with the current template files sgml: Generate SGML files using the DocBook DTD from the template files html: Generate HTML from the SGML files. To build the documentation, do: make sgml make html You should only run the 'make templates' step if you need to regenerate the templates for a more recent version of the GLib sources. INSTALLATION ============ make install