1 # -*- mode: makefile -*-
3 ####################################
4 # Everything below here is generic #
5 ####################################
8 GTKDOC_CC
= $(LIBTOOL
) --tag
=CC
--mode
=compile
$(CC
) $(INCLUDES
) $(AM_CPPFLAGS
) $(CPPFLAGS
) $(AM_CFLAGS
) $(CFLAGS
)
9 GTKDOC_LD
= $(LIBTOOL
) --tag
=CC
--mode
=link
$(CC
) $(AM_CFLAGS
) $(CFLAGS
) $(AM_LDFLAGS
) $(LDFLAGS
)
10 GTKDOC_RUN
= $(LIBTOOL
) --mode
=execute
12 GTKDOC_CC
= $(CC
) $(INCLUDES
) $(AM_CPPFLAGS
) $(CPPFLAGS
) $(AM_CFLAGS
) $(CFLAGS
)
13 GTKDOC_LD
= $(CC
) $(AM_CFLAGS
) $(CFLAGS
) $(AM_LDFLAGS
) $(LDFLAGS
)
17 # We set GPATH here; this gives us semantics for GNU make
18 # which are more like other make's VPATH, when it comes to
19 # whether a source that is a target of one rule is then
20 # searched for in VPATH/GPATH.
24 TARGET_DIR
=$(HTML_DIR
)/$(DOC_MODULE
)
29 $(DOC_MAIN_SGML_FILE
) \
30 $(DOC_MODULE
)-sections.txt \
31 $(DOC_MODULE
)-overrides.txt
33 DOC_STAMPS
=setup-build.stamp scan-build.stamp sgml-build.stamp \
34 html-build.stamp pdf-build.stamp \
35 setup.stamp sgml.stamp html.stamp pdf.stamp
39 $(DOC_MODULE
).hierarchy \
40 $(DOC_MODULE
).interfaces \
41 $(DOC_MODULE
).prerequisites \
45 $(DOC_MODULE
)-undocumented.txt \
46 $(DOC_MODULE
)-undeclared.txt \
47 $(DOC_MODULE
)-unused.txt
49 CLEANFILES
= $(SCANOBJ_FILES
) $(REPORT_FILES
) $(DOC_STAMPS
)
53 HTML_BUILD_STAMP
=html-build.stamp
58 PDF_BUILD_STAMP
=pdf-build.stamp
63 all-local
: $(HTML_BUILD_STAMP
) $(PDF_BUILD_STAMP
)
68 docs
: $(HTML_BUILD_STAMP
) $(PDF_BUILD_STAMP
)
70 $(REPORT_FILES
): sgml-build.stamp
75 -@if
test "$(abs_srcdir)" != "$(abs_builddir)" ; then \
76 cp
-a
$(abs_srcdir
)/$(DOC_MAIN_SGML_FILE
) $(abs_builddir
)/; \
77 cp
-a
$(abs_srcdir
)/$(DOC_MODULE
)* $(abs_builddir
)/; \
78 if
test "x$(content_files)" != "x" ; then \
79 for file in
$(content_files
) ; do \
80 test -f
$(abs_srcdir
)/$$file || \
81 cp
-a
$(abs_srcdir
)/$$file $(abs_builddir
)/; \
87 setup.stamp
: setup-build.stamp
93 scan-build.stamp
: $(HFILE_GLOB
) $(CFILE_GLOB
)
94 @echo
'gtk-doc: Scanning header files'
96 for i in
$(DOC_SOURCE_DIR
) ; do \
97 _source_dir
="$${_source_dir} --source-dir=$$i" ; \
99 gtkdoc-scan
--module
=$(DOC_MODULE
) --ignore-headers
="$(IGNORE_HFILES)" $${_source_dir} $(SCAN_OPTIONS
) $(EXTRA_HFILES
)
100 @if grep
-l
'^..*$$' $(DOC_MODULE
).types
> /dev
/null
2>&1 ; then \
101 CC
="$(GTKDOC_CC)" LD
="$(GTKDOC_LD)" RUN
="$(GTKDOC_RUN)" CFLAGS
="$(GTKDOC_CFLAGS) $(CFLAGS)" LDFLAGS
="$(GTKDOC_LIBS) $(LDFLAGS)" gtkdoc-scangobj
$(SCANGOBJ_OPTIONS
) --module
=$(DOC_MODULE
) ; \
103 for i in
$(SCANOBJ_FILES
) ; do \
104 test -f
$$i || touch
$$i ; \
107 @touch scan-build.stamp
109 $(DOC_MODULE
)-decl.txt
$(SCANOBJ_FILES
) $(DOC_MODULE
)-sections.txt
$(DOC_MODULE
)-overrides.txt
: scan-build.stamp
114 sgml-build.stamp
: setup-build.stamp
$(DOC_MODULE
)-decl.txt
$(SCANOBJ_FILES
) $(DOC_MODULE
)-sections.txt
$(DOC_MODULE
)-overrides.txt
$(expand_content_files
)
115 @echo
'gtk-doc: Building XML'
117 for i in
$(DOC_SOURCE_DIR
) ; do \
118 _source_dir
="$${_source_dir} --source-dir=$$i" ; \
120 gtkdoc-mkdb
--module
=$(DOC_MODULE
) --output-format
=xml
--expand-content-files
="$(expand_content_files)" --main-sgml-file
=$(DOC_MAIN_SGML_FILE
) $${_source_dir} $(MKDB_OPTIONS
)
121 @touch sgml-build.stamp
123 sgml.stamp
: sgml-build.stamp
128 html-build.stamp
: sgml.stamp
$(DOC_MAIN_SGML_FILE
) $(content_files
)
129 @echo
'gtk-doc: Building HTML'
132 @mkhtml_options
=""; \
133 gtkdoc-mkhtml
2>&1 --help | grep
>/dev
/null
"\-\-path"; \
134 if
test "$(?)" = "0"; then \
135 mkhtml_options
=--path
="$(abs_srcdir)"; \
137 cd html
&& gtkdoc-mkhtml
$$mkhtml_options $(MKHTML_OPTIONS
) $(DOC_MODULE
) ..
/$(DOC_MAIN_SGML_FILE
)
138 @
test "x$(HTML_IMAGES)" = "x" ||
( cd
$(srcdir) && cp
$(HTML_IMAGES
) $(abs_builddir
)/html
)
139 @echo
'gtk-doc: Fixing cross-references'
140 @gtkdoc-fixxref
--module
=$(DOC_MODULE
) --module-dir
=html
--html-dir
=$(HTML_DIR
) $(FIXXREF_OPTIONS
)
141 @touch html-build.stamp
145 pdf-build.stamp
: sgml.stamp
$(DOC_MAIN_SGML_FILE
) $(content_files
)
146 @echo
'gtk-doc: Building PDF'
147 @
rm -rf
$(DOC_MODULE
).pdf
149 if
test "x$(HTML_IMAGES)" != "x"; then \
150 for img in
$(HTML_IMAGES
); do \
151 part
=`dirname $$img`; \
152 echo
$$mkpdf_imgdirs | grep
>/dev
/null
"\-\-imgdir=$$part "; \
153 if
test $$?
!= 0; then \
154 mkpdf_imgdirs
="$$mkpdf_imgdirs --imgdir=$$part"; \
158 gtkdoc-mkpdf
--path
="$(abs_srcdir)" $$mkpdf_imgdirs $(DOC_MODULE
) $(DOC_MAIN_SGML_FILE
) $(MKPDF_OPTIONS
)
159 @touch pdf-build.stamp
168 rm -rf xml html
$(REPORT_FILES
) $(DOC_MODULE
).pdf \
169 $(DOC_MODULE
)-decl-list.txt
$(DOC_MODULE
)-decl.txt
170 if
test "$(abs_srcdir)" != "$(abs_builddir)" ; then \
171 rm -f
$(DOC_MAIN_SGML_FILE
) $(DOC_MODULE
)*; \
174 maintainer-clean-local
: clean
178 @installfiles
=`echo $(builddir)/html/*`; \
179 if
test "$$installfiles" = '$(srcdir)/html/*'; \
180 then echo
'-- Nothing to install' ; \
182 if
test -n
"$(DOC_MODULE_VERSION)"; then \
183 installdir
="$(DESTDIR)$(TARGET_DIR)-$(DOC_MODULE_VERSION)"; \
185 installdir
="$(DESTDIR)$(TARGET_DIR)"; \
187 $(mkinstalldirs
) $${installdir} ; \
188 for i in
$$installfiles; do \
189 echo
'-- Installing '$$i ; \
190 $(INSTALL_DATA
) $$i $${installdir}; \
192 if
test -n
"$(DOC_MODULE_VERSION)"; then \
193 mv
-f
$${installdir}/$(DOC_MODULE
).devhelp2 \
194 $${installdir}/$(DOC_MODULE
)-$(DOC_MODULE_VERSION
).devhelp2
; \
195 mv
-f
$${installdir}/$(DOC_MODULE
).devhelp \
196 $${installdir}/$(DOC_MODULE
)-$(DOC_MODULE_VERSION
).devhelp
; \
198 $(GTKDOC_REBASE
) --relative
--dest-dir
=$(DESTDIR
) --html-dir
=$${installdir}; \
202 @if
test -n
"$(DOC_MODULE_VERSION)"; then \
203 installdir
="$(DESTDIR)$(TARGET_DIR)-$(DOC_MODULE_VERSION)"; \
205 installdir
="$(DESTDIR)$(TARGET_DIR)"; \
207 rm -rf
$${installdir}
210 # Require gtk-doc when making dist
216 @echo
"*** gtk-doc must be installed and enabled in order to make dist"
220 dist-hook
: dist-check-gtkdoc dist-hook-local
221 mkdir
$(distdir
)/html
222 cp
$(builddir
)/html
/* $(distdir
)/html
223 -cp
$(builddir
)/$(DOC_MODULE
).pdf
$(distdir
)/
224 -cp
$(builddir
)/$(DOC_MODULE
).types
$(distdir
)/
225 -cp
$(builddir
)/$(DOC_MODULE
)-sections.txt
$(distdir
)/
226 cd
$(distdir
) && rm -f
$(DISTCLEANFILES
)
227 $(GTKDOC_REBASE
) --online
--relative
--html-dir
=$(distdir
)/html
229 .PHONY
: dist-hook-local docs