2008-08-12 08:05:21 +00:00
|
|
|
## Process this file with automake to produce Makefile.in
|
|
|
|
|
AUTOMAKE_OPTIONS = 1.6
|
|
|
|
|
|
|
|
|
|
# The name of the module
|
|
|
|
|
DOC_MODULE=libnm-glib
|
|
|
|
|
|
|
|
|
|
# The top-level SGML file.
|
2011-03-15 15:54:33 -05:00
|
|
|
DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.xml
|
2008-08-12 08:05:21 +00:00
|
|
|
|
|
|
|
|
# The directory containing the source code. Relative to $(srcdir).
|
|
|
|
|
# gtk-doc will search all .c & .h files beneath here for inline comments
|
|
|
|
|
# documenting functions and macros.
|
2012-11-13 22:00:28 +01:00
|
|
|
DOC_SOURCE_DIR=$(top_srcdir)/libnm-glib
|
2008-08-12 08:05:21 +00:00
|
|
|
|
|
|
|
|
# Extra options to supply to gtkdoc-scan.
|
|
|
|
|
SCAN_OPTIONS=
|
|
|
|
|
|
|
|
|
|
# Extra options to supply to gtkdoc-scangobj.
|
|
|
|
|
SCANGOBJ_OPTIONS=--type-init-func 'g_type_init();'
|
|
|
|
|
|
|
|
|
|
# Extra options to supply to gtkdoc-mkdb.
|
|
|
|
|
MKDB_OPTIONS=--sgml-mode --output-format=xml
|
|
|
|
|
|
|
|
|
|
# Extra options to supply to gtkdoc-fixref.
|
|
|
|
|
FIXXREF_OPTIONS=
|
|
|
|
|
|
|
|
|
|
# Used for dependencies.
|
2009-09-28 16:01:21 -07:00
|
|
|
HFILE_GLOB=$(top_srcdir)/libnm-glib/*.h
|
|
|
|
|
CFILE_GLOB=$(top_srcdir)/libnm-glib/*.c
|
2008-08-12 08:05:21 +00:00
|
|
|
|
|
|
|
|
# Header files to ignore when scanning.
|
|
|
|
|
IGNORE_HFILES= \
|
2014-12-18 12:44:57 -05:00
|
|
|
common.h \
|
2014-10-30 16:33:32 +01:00
|
|
|
nm-dbus-helpers-private.h \
|
2008-08-12 08:05:21 +00:00
|
|
|
nm-device-private.h \
|
|
|
|
|
nm-object-cache.h \
|
|
|
|
|
nm-object-private.h \
|
2010-04-08 13:56:37 -07:00
|
|
|
nm-remote-connection-private.h \
|
2008-08-12 08:05:21 +00:00
|
|
|
nm-types-private.h \
|
2012-03-23 19:01:41 -05:00
|
|
|
nm-secret-agent-glue.h \
|
2010-04-08 13:56:37 -07:00
|
|
|
nm-vpn-plugin-glue.h
|
2008-08-12 08:05:21 +00:00
|
|
|
|
|
|
|
|
# Images to copy into HTML directory.
|
2011-03-15 15:54:33 -05:00
|
|
|
HTML_IMAGES = libnm-glib.png
|
2008-08-12 08:05:21 +00:00
|
|
|
|
|
|
|
|
# Extra XML files that are included by $(DOC_MAIN_SGML_FILE).
|
2012-08-06 22:04:06 -05:00
|
|
|
content_files = version.xml
|
2008-08-12 08:05:21 +00:00
|
|
|
|
|
|
|
|
# Other files to distribute.
|
2011-10-03 16:47:26 -05:00
|
|
|
extra_files = libnm-glib.png
|
2008-08-12 08:05:21 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
# CFLAGS and LDFLAGS for compiling scan program. Only needed
|
|
|
|
|
# if $(DOC_MODULE).types is non-empty.
|
|
|
|
|
GTKDOC_CFLAGS = \
|
build: extract version macros from "nm-version.h" to new header file "nm-version-macros.h"
For libnm library, "nm-dbus-interface.h" contains defines like the D-Bus
paths of NetworkManager. It is desirable to have this header usable without
having a dependency on "glib.h", for example for a QT application. For that,
commit c0852964a890cf43cc2dcaeff41ac6edc5028f24 removed that dependancy.
For libnm-glib library, the analog to "nm-dbus-interface.h" is
"NetworkManager.h", and the same applies there. Commit
159e827a72f420048e12d318f8ba1edd3f641fc8 removed that include.
However, that broke build on PackageKit [1] which expected to get the
version macros by including "NetworkManager.h". So at least for libnm-glib,
we need to preserve old behavior so that a user including
"NetworkManager.h" gets the version macros, but not "glib.h".
Extract the version macros to a new header file "nm-version-macros.h".
This header doesn't include "glib.h" and can be included from
"NetworkManager.h". This gives as previous behavior and a glib-free
include.
For libnm we still don't include "nm-version-macros.h" to "nm-dbus-interface.h".
Very few users will actually need the version macros, but not using
libnm.
Users that use libnm, should just include (libnm's) "NetworkManager.h" to
get all headers.
As a special case, a user who doesn't want to use glib/libnm, but still
needs both "nm-dbus-interface.h" and "nm-version-macros.h", can include
them both separately.
[1] https://github.com/hughsie/PackageKit/issues/85
Fixes: 4545a7fe9670ce4d7c259c11c2cc853bfae6729b
(cherry picked from commit 7bf10a75db84655e65fe6216d248f7775c58ca23)
2015-09-25 16:07:50 +02:00
|
|
|
-I$(top_srcdir)/include \
|
|
|
|
|
-I$(top_builddir)/include \
|
2008-08-12 08:05:21 +00:00
|
|
|
-I$(top_srcdir)/libnm-util \
|
2012-11-13 22:00:28 +01:00
|
|
|
-I$(top_builddir)/libnm-util \
|
2008-08-12 08:05:21 +00:00
|
|
|
-I$(top_srcdir)/libnm-glib \
|
2012-11-13 22:00:28 +01:00
|
|
|
-I$(top_builddir)/libnm-glib \
|
2014-02-12 12:28:52 -05:00
|
|
|
-DNM_VERSION_MAX_ALLOWED=NM_VERSION_NEXT_STABLE \
|
2008-08-12 08:05:21 +00:00
|
|
|
$(GLIB_CFLAGS) \
|
|
|
|
|
$(DBUS_CFLAGS)
|
|
|
|
|
|
2011-03-07 09:49:48 -06:00
|
|
|
GTKDOC_LIBS = \
|
|
|
|
|
$(top_builddir)/libnm-glib/libnm-glib.la \
|
|
|
|
|
$(GLIB_LIBS)
|
2008-08-12 08:05:21 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
# include common portion ...
|
|
|
|
|
include $(top_srcdir)/gtk-doc.make
|
|
|
|
|
|
2012-08-06 22:04:06 -05:00
|
|
|
EXTRA_DIST += version.xml.in
|
|
|
|
|
|
2011-01-25 12:40:18 -06:00
|
|
|
CLEANFILES += \
|
|
|
|
|
libnm-glib-sections.txt \
|
2012-11-13 23:13:25 +01:00
|
|
|
libnm-glib-overrides.txt \
|
2011-01-25 12:40:18 -06:00
|
|
|
html/* \
|
|
|
|
|
tmpl/* \
|
|
|
|
|
xml/*
|
2009-09-28 16:01:21 -07:00
|
|
|
|
