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.
krh@262
     1
# The name of the module.
krh@262
     2
DOC_MODULE=razor
krh@262
     3
krh@262
     4
# The top-level SGML file.
krh@262
     5
DOC_MAIN_SGML_FILE=razor-docs.xml
krh@262
     6
krh@262
     7
# Extra options to supply to gtkdoc-scan
krh@262
     8
IGNORE_HFILES = config.h razor-internal.h
krh@262
     9
krh@262
    10
# The directory containing the source code. Relative to $(srcdir)
krh@262
    11
DOC_SOURCE_DIR=$(top_srcdir)/librazor
krh@262
    12
krh@262
    13
# Used for dependencies
krh@262
    14
HFILE_GLOB=$(top_srcdir)/librazor/*.h
krh@262
    15
CFILE_GLOB=$(top_srcdir)/librazor/*.c
krh@262
    16
krh@262
    17
# Extra options to supply to gtkdoc-mkdb
krh@262
    18
MKDB_OPTIONS=--sgml-mode --output-format=xml
krh@262
    19
krh@262
    20
# Extra options to supply to gtkdoc-mktmpl
krh@262
    21
MKTMPL_OPTIONS=
krh@262
    22
krh@294
    23
if ENABLE_GTK_DOC
krh@262
    24
include $(top_srcdir)/gtk-doc.make
krh@294
    25
else
krh@294
    26
EXTRA_DIST =
krh@294
    27
endif
krh@262
    28
krh@262
    29
# Version information for marking the documentation
krh@262
    30
EXTRA_DIST += version.xml.in
rhughes@241
    31
rhughes@242
    32
docsdir = $(datadir)/doc/razor
rhughes@241
    33
krh@311
    34
content_files =					\
krh@311
    35
	package-set.xml				\
krh@311
    36
	solver.xml
krh@311
    37