]> Pileus Git - ~andy/gtk/blob - docs/reference/gtk/Makefile.am
Clean up man page handling
[~andy/gtk] / docs / reference / gtk / Makefile.am
1 ## Process this file with automake to produce Makefile.in
2 include $(top_srcdir)/Makefile.decl
3
4 AUTOMAKE_OPTIONS = 1.6
5
6 # The name of the module.
7 DOC_MODULE=gtk3
8
9 # The top-level SGML file.
10 DOC_MAIN_SGML_FILE=gtk-docs.sgml
11
12 # Extra options to supply to gtkdoc-scan
13 SCAN_OPTIONS=--deprecated-guards="GTK_ENABLE_BROKEN|GTK_DISABLE_DEPRECATED"
14
15 # The directory containing the source code. Relative to $(srcdir)
16 DOC_SOURCE_DIR=../../../gtk
17
18 # Used for dependencies
19 HFILE_GLOB=$(top_srcdir)/gtk/*.h
20 CFILE_GLOB=$(top_srcdir)/gtk/*.c
21
22 # Header files to ignore when scanning
23 IGNORE_HFILES=                          \
24         gtkalias.h                      \
25         fnmatch.h                       \
26         gdk-pixbuf-loader.h             \
27         gtkdebug.h                      \
28         gtkbuilderprivate.h             \
29         gtkdndcursors.h                 \
30         gtkentryprivate.h               \
31         gtkfilechooserdefault.h         \
32         gtkfilechooserembed.h           \
33         gtkfilechooserentry.h           \
34         gtkfilechooserprivate.h         \
35         gtkfilechoosersettings.h        \
36         gtkfilechooserutils.h           \
37         gtkfilesystem.h                 \
38         gtkfilesystemmodel.h            \
39         gtkfilesystemunix.h             \
40         gtkfilesystemwin32.h            \
41         gtkiconcache.h                  \
42         gtkiconcachevalidator.h         \
43         gtkiconthemeparser.h            \
44         gtkintl.h                       \
45         gtkkeyhash.h                    \
46         gtkmarshal.h                    \
47         gtkmnemonichash.h               \
48         gtkpathbar.h                    \
49         gtkplugprivate.h                \
50         gtkprintbackend.h               \
51         gtkprinteroption.h              \
52         gtkprinteroptionset.h           \
53         gtkprinteroptionwidget.h        \
54         gtkprinter-private.h            \
55         gtkprint-win32.h                \
56         gtkprintutils.h                 \
57         gtkprintoperation-private.h     \
58         gtkprivate.h                    \
59         gtkquery.h                      \
60         gtkrbtree.h                     \
61         gtkrecentchooserdefault.h       \
62         gtkrecentchooserutils.h         \
63         gtkrecentchooserprivate.h       \
64         gtksearchengine.h               \
65         gtksearchenginebeagle.h         \
66         gtksearchenginetracker.h        \
67         gtksearchenginesimple.h         \
68         gtksearchenginequartz.h         \
69         gtksequence.h                   \
70         gtksocketprivate.h              \
71         gtktextbtree.h                  \
72         gtktextbufferserializ.h         \
73         gtktextchildprivate.h           \
74         gtktextdisplay.h                \
75         gtktextiterprivate.h            \
76         gtktextlayout.h                 \
77         gtktextmarkprivate.h            \
78         gtktextsegment.h                \
79         gtktexttagprivate.h             \
80         gtktexttypes.h                  \
81         gtktextutil.h                   \
82         gtkthemes.h                     \
83         gtktoggleactionprivate.h        \
84         gtktrayicon.h                   \
85         gtktreedatalist.h               \
86         gtktreeprivate.h                \
87         gtktoolpaletteprivate.h         \
88         gtktypebuiltins.h               \
89         gtkxembed.h                     \
90         gtkwin32embed.h                 \
91         gtkwin32embedwidget.h           \
92         gtkwindow-decorate.h            \
93         xdgmime                         \
94         xembed.h
95
96 # CFLAGS and LDFLAGS for compiling scan program. Only needed
97 # if $(DOC_MODULE).types is non-empty.
98 INCLUDES = \
99         -I$(top_srcdir)         \
100         -I$(top_builddir)       \
101         -I$(top_builddir)/gdk   \
102         -DGTK_ENABLE_BROKEN     \
103         $(GTK_DEBUG_FLAGS)      \
104         $(GTK_DEP_CFLAGS)
105
106 CPPFLAGS += \
107         -UGTK_DISABLE_SINGLE_INCLUDES
108
109 GTKDOC_LIBS = \
110         $(top_builddir)/gdk-pixbuf/libgdk_pixbuf-$(GTK_API_VERSION).la  \
111         $(top_builddir)/gdk/$(gdktargetlib)                             \
112         $(top_builddir)/gtk/$(gtktargetlib)
113
114
115 # Extra options to supply to gtkdoc-mkdb
116 MKDB_OPTIONS=--sgml-mode --output-format=xml --name-space=gtk
117
118 # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE)
119 content_files =                                 \
120         version.xml                             \
121         running.sgml                            \
122         building.sgml                           \
123         changes-1.2.sgml                        \
124         changes-2.0.sgml                        \
125         compiling.sgml                          \
126         directfb.sgml                           \
127         drawing-model.xml                       \
128         glossary.xml                            \
129         migrating-checklist.sgml                \
130         migrating-ClientSideWindows.sgml        \
131         migrating-GtkAboutDialog.sgml           \
132         migrating-GtkAction.sgml                \
133         migrating-GtkAssistant.sgml             \
134         migrating-GtkBuilder.sgml               \
135         migrating-GtkColorButton.sgml           \
136         migrating-GtkComboBox.sgml              \
137         migrating-GtkEntry-icons.sgml           \
138         migrating-GtkFileChooser.sgml           \
139         migrating-GtkIconView.sgml              \
140         migrating-GtkLabel-links.sgml           \
141         migrating-GtkLinkButton.sgml            \
142         migrating-GtkRecentChooser.sgml         \
143         migrating-GtkTooltip.sgml               \
144         objects_grouped.sgml                    \
145         osx.sgml                                \
146         question_index.sgml                     \
147         resources.sgml                          \
148         text_widget.sgml                        \
149         tree_widget.sgml                        \
150         windows.sgml                            \
151         x11.sgml                                \
152         gtk-query-immodules-3.0.xml             \
153         gtk-update-icon-cache-3.0.xml           \
154         gtk-builder-convert-3.0.xml             \
155         visual_index.xml
156
157 expand_content_files =                          \
158         drawing-model.xml                       \
159         glossary.xml                            \
160         migrating-checklist.sgml                \
161         migrating-ClientSideWindows.sgml        \
162         migrating-GtkAction.sgml                \
163         migrating-GtkComboBox.sgml              \
164         migrating-GtkEntry-icons.sgml           \
165         migrating-GtkFileChooser.sgml           \
166         migrating-GtkIconView.sgml              \
167         migrating-GtkAboutDialog.sgml           \
168         migrating-GtkColorButton.sgml           \
169         migrating-GtkAssistant.sgml             \
170         migrating-GtkRecentChooser.sgml         \
171         migrating-GtkLabel-links.sgml           \
172         migrating-GtkLinkButton.sgml            \
173         migrating-GtkBuilder.sgml               \
174         migrating-GtkTooltip.sgml               \
175         tree_widget.sgml                        \
176         text_widget.sgml                        \
177         question_index.sgml
178
179 # Images to copy into HTML directory
180 HTML_IMAGES = \
181         $(top_srcdir)/gtk/stock-icons/24/gtk-about.png                  \
182         $(top_srcdir)/gtk/stock-icons/24/gtk-add.png                    \
183         $(top_srcdir)/gtk/stock-icons/20/gtk-apply.png                  \
184         $(top_srcdir)/gtk/stock-icons/24/gtk-bold.png                   \
185         $(top_srcdir)/gtk/stock-icons/20/gtk-cancel.png                 \
186         $(top_srcdir)/gtk/stock-icons/24/gtk-caps-lock-warning.png      \
187         $(top_srcdir)/gtk/stock-icons/24/gtk-cdrom.png                  \
188         $(top_srcdir)/gtk/stock-icons/24/gtk-clear.png                  \
189         $(top_srcdir)/gtk/stock-icons/24/gtk-close.png                  \
190         $(top_srcdir)/gtk/stock-icons/24/gtk-connect.png                \
191         $(top_srcdir)/gtk/stock-icons/24/gtk-convert.png                \
192         $(top_srcdir)/gtk/stock-icons/24/gtk-copy.png                   \
193         $(top_srcdir)/gtk/stock-icons/24/gtk-cut.png                    \
194         $(top_srcdir)/gtk/stock-icons/24/gtk-delete.png                 \
195         $(top_srcdir)/gtk/stock-icons/48/gtk-dialog-authentication.png  \
196         $(top_srcdir)/gtk/stock-icons/48/gtk-dialog-error.png           \
197         $(top_srcdir)/gtk/stock-icons/48/gtk-dialog-info.png            \
198         $(top_srcdir)/gtk/stock-icons/48/gtk-dialog-question.png        \
199         $(top_srcdir)/gtk/stock-icons/48/gtk-dialog-warning.png         \
200         $(top_srcdir)/gtk/stock-icons/24/gtk-directory.png              \
201         $(top_srcdir)/gtk/stock-icons/24/gtk-disconnect.png             \
202         $(top_srcdir)/gtk/stock-icons/32/gtk-dnd.png                    \
203         $(top_srcdir)/gtk/stock-icons/32/gtk-dnd-multiple.png           \
204         $(top_srcdir)/gtk/stock-icons/24/gtk-edit.png                   \
205         $(top_srcdir)/gtk/stock-icons/24/gtk-execute.png                \
206         $(top_srcdir)/gtk/stock-icons/24/gtk-file.png                   \
207         $(top_srcdir)/gtk/stock-icons/24/gtk-find.png                   \
208         $(top_srcdir)/gtk/stock-icons/24/gtk-find-and-replace.png       \
209         $(top_srcdir)/gtk/stock-icons/24/gtk-goto-bottom.png            \
210         $(top_srcdir)/gtk/stock-icons/24/gtk-goto-first-ltr.png         \
211         $(top_srcdir)/gtk/stock-icons/24/gtk-goto-first-rtl.png         \
212         $(top_srcdir)/gtk/stock-icons/24/gtk-goto-last-ltr.png          \
213         $(top_srcdir)/gtk/stock-icons/24/gtk-goto-last-rtl.png          \
214         $(top_srcdir)/gtk/stock-icons/24/gtk-goto-top.png               \
215         $(top_srcdir)/gtk/stock-icons/24/gtk-go-back-ltr.png            \
216         $(top_srcdir)/gtk/stock-icons/24/gtk-go-back-rtl.png            \
217         $(top_srcdir)/gtk/stock-icons/24/gtk-go-down.png                \
218         $(top_srcdir)/gtk/stock-icons/24/gtk-go-forward-ltr.png         \
219         $(top_srcdir)/gtk/stock-icons/24/gtk-go-forward-rtl.png         \
220         $(top_srcdir)/gtk/stock-icons/24/gtk-go-up.png                  \
221         $(top_srcdir)/gtk/stock-icons/24/gtk-harddisk.png               \
222         $(top_srcdir)/gtk/stock-icons/24/gtk-network.png                \
223         $(top_srcdir)/gtk/stock-icons/24/gtk-help.png                   \
224         $(top_srcdir)/gtk/stock-icons/24/gtk-home.png                   \
225         $(top_srcdir)/gtk/stock-icons/24/gtk-index.png                  \
226         $(top_srcdir)/gtk/stock-icons/24/gtk-indent-ltr.png             \
227         $(top_srcdir)/gtk/stock-icons/24/gtk-indent-rtl.png             \
228         $(top_srcdir)/gtk/stock-icons/24/gtk-unindent-ltr.png           \
229         $(top_srcdir)/gtk/stock-icons/24/gtk-unindent-rtl.png           \
230         $(top_srcdir)/gtk/stock-icons/24/gtk-italic.png                 \
231         $(top_srcdir)/gtk/stock-icons/24/gtk-jump-to-ltr.png            \
232         $(top_srcdir)/gtk/stock-icons/24/gtk-jump-to-rtl.png            \
233         $(top_srcdir)/gtk/stock-icons/24/gtk-justify-center.png         \
234         $(top_srcdir)/gtk/stock-icons/24/gtk-justify-fill.png           \
235         $(top_srcdir)/gtk/stock-icons/24/gtk-justify-left.png           \
236         $(top_srcdir)/gtk/stock-icons/24/gtk-justify-right.png          \
237         $(top_srcdir)/gtk/stock-icons/24/gtk-missing-image.png          \
238         $(top_srcdir)/gtk/stock-icons/24/gtk-new.png                    \
239         $(top_srcdir)/gtk/stock-icons/20/gtk-no.png                     \
240         $(top_srcdir)/gtk/stock-icons/20/gtk-ok.png                     \
241         $(top_srcdir)/gtk/stock-icons/24/gtk-open.png                   \
242         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-landscape.png  \
243         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-portrait.png   \
244         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-reverse-landscape.png \
245         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-reverse-portrait.png \
246         $(top_srcdir)/gtk/stock-icons/24/gtk-paste.png                  \
247         $(top_srcdir)/gtk/stock-icons/24/gtk-preferences.png            \
248         $(top_srcdir)/gtk/stock-icons/24/gtk-print.png                  \
249         $(top_srcdir)/gtk/stock-icons/24/gtk-print-error.png            \
250         $(top_srcdir)/gtk/stock-icons/24/gtk-print-paused.png           \
251         $(top_srcdir)/gtk/stock-icons/24/gtk-print-preview.png          \
252         $(top_srcdir)/gtk/stock-icons/24/gtk-print-report.png           \
253         $(top_srcdir)/gtk/stock-icons/24/gtk-print-warning.png          \
254         $(top_srcdir)/gtk/stock-icons/24/gtk-properties.png             \
255         $(top_srcdir)/gtk/stock-icons/24/gtk-quit.png                   \
256         $(top_srcdir)/gtk/stock-icons/24/gtk-redo-ltr.png               \
257         $(top_srcdir)/gtk/stock-icons/24/gtk-redo-rtl.png               \
258         $(top_srcdir)/gtk/stock-icons/24/gtk-refresh.png                \
259         $(top_srcdir)/gtk/stock-icons/24/gtk-remove.png                 \
260         $(top_srcdir)/gtk/stock-icons/24/gtk-revert-to-saved-ltr.png    \
261         $(top_srcdir)/gtk/stock-icons/24/gtk-revert-to-saved-rtl.png    \
262         $(top_srcdir)/gtk/stock-icons/24/gtk-floppy.png                 \
263         $(top_srcdir)/gtk/stock-icons/24/gtk-save.png                   \
264         $(top_srcdir)/gtk/stock-icons/24/gtk-save-as.png                \
265         $(top_srcdir)/gtk/stock-icons/24/gtk-select-all.png             \
266         $(top_srcdir)/gtk/stock-icons/24/gtk-select-color.png           \
267         $(top_srcdir)/gtk/stock-icons/24/gtk-color-picker.png           \
268         $(top_srcdir)/gtk/stock-icons/24/gtk-font.png                   \
269         $(top_srcdir)/gtk/stock-icons/24/gtk-sort-ascending.png         \
270         $(top_srcdir)/gtk/stock-icons/24/gtk-sort-descending.png        \
271         $(top_srcdir)/gtk/stock-icons/24/gtk-spell-check.png            \
272         $(top_srcdir)/gtk/stock-icons/24/gtk-stop.png                   \
273         $(top_srcdir)/gtk/stock-icons/24/gtk-strikethrough.png          \
274         $(top_srcdir)/gtk/stock-icons/24/gtk-undelete-ltr.png           \
275         $(top_srcdir)/gtk/stock-icons/24/gtk-undelete-rtl.png           \
276         $(top_srcdir)/gtk/stock-icons/24/gtk-underline.png              \
277         $(top_srcdir)/gtk/stock-icons/24/gtk-undo-ltr.png               \
278         $(top_srcdir)/gtk/stock-icons/24/gtk-undo-rtl.png               \
279         $(top_srcdir)/gtk/stock-icons/20/gtk-yes.png                    \
280         $(top_srcdir)/gtk/stock-icons/24/gtk-zoom-100.png               \
281         $(top_srcdir)/gtk/stock-icons/24/gtk-zoom-fit.png               \
282         $(top_srcdir)/gtk/stock-icons/24/gtk-zoom-in.png                \
283         $(top_srcdir)/gtk/stock-icons/24/gtk-zoom-out.png               \
284         $(top_srcdir)/gtk/stock-icons/24/gtk-media-forward-ltr.png      \
285         $(top_srcdir)/gtk/stock-icons/24/gtk-media-forward-rtl.png      \
286         $(top_srcdir)/gtk/stock-icons/24/gtk-media-next-ltr.png         \
287         $(top_srcdir)/gtk/stock-icons/24/gtk-media-next-rtl.png         \
288         $(top_srcdir)/gtk/stock-icons/24/gtk-media-pause.png            \
289         $(top_srcdir)/gtk/stock-icons/24/gtk-media-play-ltr.png         \
290         $(top_srcdir)/gtk/stock-icons/24/gtk-media-play-rtl.png         \
291         $(top_srcdir)/gtk/stock-icons/24/gtk-media-previous-ltr.png     \
292         $(top_srcdir)/gtk/stock-icons/24/gtk-media-previous-rtl.png     \
293         $(top_srcdir)/gtk/stock-icons/24/gtk-media-record.png           \
294         $(top_srcdir)/gtk/stock-icons/24/gtk-media-rewind-ltr.png       \
295         $(top_srcdir)/gtk/stock-icons/24/gtk-media-rewind-rtl.png       \
296         $(top_srcdir)/gtk/stock-icons/24/gtk-media-stop.png             \
297         $(top_srcdir)/gtk/stock-icons/24/gtk-fullscreen.png             \
298         $(top_srcdir)/gtk/stock-icons/24/gtk-leave-fullscreen.png       \
299         $(top_srcdir)/gtk/stock-icons/24/gtk-info.png                   \
300         $(srcdir)/images/aboutdialog.png                                \
301         $(srcdir)/images/accel-label.png                                \
302         $(srcdir)/images/assistant.png                                  \
303         $(srcdir)/images/button.png                                     \
304         $(srcdir)/images/check-button.png                               \
305         $(srcdir)/images/color-button.png                               \
306         $(srcdir)/images/colorsel.png                                   \
307         $(srcdir)/images/combo-box.png                                  \
308         $(srcdir)/images/combo-box-entry.png                            \
309         $(srcdir)/images/entry.png                                      \
310         $(srcdir)/images/figure-hierarchical-drawing.png                \
311         $(srcdir)/images/figure-windowed-label.png                      \
312         $(srcdir)/images/file-button.png                                \
313         $(srcdir)/images/filechooser.png                                \
314         $(srcdir)/images/font-button.png                                \
315         $(srcdir)/images/fontsel.png                                    \
316         $(srcdir)/images/frame.png                                      \
317         $(srcdir)/images/icon-view.png                                  \
318         $(srcdir)/images/image.png                                      \
319         $(srcdir)/images/label.png                                      \
320         $(srcdir)/images/link-button.png                                \
321         $(srcdir)/images/list-and-tree.png                              \
322         $(srcdir)/images/menubar.png                                    \
323         $(srcdir)/images/messagedialog.png                              \
324         $(srcdir)/images/multiline-text.png                             \
325         $(srcdir)/images/notebook.png                                   \
326         $(srcdir)/images/panes.png                                      \
327         $(srcdir)/images/pagesetupdialog.png                            \
328         $(srcdir)/images/printdialog.png                                \
329         $(srcdir)/images/progressbar.png                                \
330         $(srcdir)/images/radio-group.png                                \
331         $(srcdir)/images/recentchooserdialog.png                        \
332         $(srcdir)/images/scales.png                                     \
333         $(srcdir)/images/scrolledwindow.png                             \
334         $(srcdir)/images/separator.png                                  \
335         $(srcdir)/images/spinbutton.png                                 \
336         $(srcdir)/images/spinner.png                                    \
337         $(srcdir)/images/statusbar.png                                  \
338         $(srcdir)/images/toggle-button.png                              \
339         $(srcdir)/images/toolbar.png                                    \
340         $(srcdir)/images/toolpalette.png                                \
341         $(srcdir)/images/tree-view-coordinates.png                      \
342         $(srcdir)/images/volumebutton.png                               \
343         $(srcdir)/images/window.png                                     \
344         $(srcdir)/images/layout-btlr.png                                \
345         $(srcdir)/images/layout-btrl.png                                \
346         $(srcdir)/images/layout-lrbt.png                                \
347         $(srcdir)/images/layout-lrtb.png                                \
348         $(srcdir)/images/layout-rlbt.png                                \
349         $(srcdir)/images/layout-rltb.png                                \
350         $(srcdir)/images/layout-tblr.png                                \
351         $(srcdir)/images/layout-tbrl.png
352
353 # Extra options to supply to gtkdoc-fixref
354 FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html \
355         --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gobject \
356         --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/glib \
357         --extra-dir=$(ATK_PREFIX)/share/gtk-doc/html/atk \
358         --extra-dir=$(PANGO_PREFIX)/share/gtk-doc/html/pango \
359         --extra-dir=$(CAIRO_PREFIX)/share/gtk-doc/html/cairo
360
361 include $(top_srcdir)/gtk-doc.make
362
363 # Other files to distribute
364 EXTRA_DIST += version.xml.in
365
366 ########################################################################
367
368 man_MANS =                              \
369         gtk-query-immodules-3.0.1       \
370         gtk-update-icon-cache-3.0.1     \
371         gtk-builder-convert-3.0.1
372
373 if ENABLE_MAN
374
375 .xml.1:
376         @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
377
378 dist-local-check-mans-enabled:
379         if grep "Man generation disabled" $(man_MANS) >/dev/null; then $(RM) $(man_MANS); fi
380
381 else
382
383 $(man_MANS):
384         echo Man generation disabled.  Creating dummy $@.  Configure with --enable-man to enable it.
385         echo Man generation disabled.  Remove this file, configure with --enable-man, and rebuild > $@
386
387 dist-local-check-mans-enabled:
388         echo "*** --enable-man must be used in order to make dist"
389         false
390
391 endif
392
393 MAINTAINERCLEANFILES = $(man_MANS) $(BUILT_SOURCES)
394
395 EXTRA_DIST += $(man_MANS)
396
397 dist-hook-local: dist-local-check-mans-enabled gtk-docs-clean all-local
398
399 gtk-docs-clean: clean
400         cd $(srcdir) && rm -rf xml html
401
402 -include $(top_srcdir)/git.mk