docs/Makefile.am
author J. Ali Harlow <ali@juiblex.co.uk>
Sat Oct 04 18:12:58 2014 +0100 (2014-10-04)
changeset 454 56ff755c268c
parent 294 d7ecddf38c3d
permissions -rw-r--r--
Only export symbols starting with razor_ in dynamic library.

Apart from being good practice to avoid clashes with higher-level
libraries and the application, this also fixes an obscure bug: The
gnulib library is used both by librazor (the dynamic library) and
by razor (the executable). In doing so, we want to have two separate
copies of the library despite the code duplication this involves.
Without the explicit limit to export only razor_ symbols, the razor
executable under mingw64 was picking up the getopt_long function
from librazor and the optind variable from libgnu which meant that
it did not see optind changing. Hiding librazor's copy of getopt
causes the linker to find libgnu's copy and everything works.

Note that under mingw librazor-#.dll still contains undocumented
(private) razor_ symbols but these will do no harm as long as nobody
tries to use them.
     1 # The name of the module.
     2 DOC_MODULE=razor
     3 
     4 # The top-level SGML file.
     5 DOC_MAIN_SGML_FILE=razor-docs.xml
     6 
     7 # Extra options to supply to gtkdoc-scan
     8 IGNORE_HFILES = config.h razor-internal.h
     9 
    10 # The directory containing the source code. Relative to $(srcdir)
    11 DOC_SOURCE_DIR=$(top_srcdir)/librazor
    12 
    13 # Used for dependencies
    14 HFILE_GLOB=$(top_srcdir)/librazor/*.h
    15 CFILE_GLOB=$(top_srcdir)/librazor/*.c
    16 
    17 # Extra options to supply to gtkdoc-mkdb
    18 MKDB_OPTIONS=--sgml-mode --output-format=xml
    19 
    20 # Extra options to supply to gtkdoc-mktmpl
    21 MKTMPL_OPTIONS=
    22 
    23 if ENABLE_GTK_DOC
    24 include $(top_srcdir)/gtk-doc.make
    25 else
    26 EXTRA_DIST =
    27 endif
    28 
    29 # Version information for marking the documentation
    30 EXTRA_DIST += version.xml.in
    31 
    32 docsdir = $(datadir)/doc/razor
    33 
    34 content_files =					\
    35 	package-set.xml				\
    36 	solver.xml
    37