]> Pileus Git - ~andy/gtk/blob - docs/reference/gtk/Makefile.am
New gtk-launch command
[~andy/gtk] / docs / reference / gtk / Makefile.am
1 ## Process this file with automake to produce Makefile.in
2
3 AUTOMAKE_OPTIONS = 1.6
4
5 # The name of the module.
6 DOC_MODULE=gtk3
7
8 # The top-level SGML file.
9 DOC_MAIN_SGML_FILE=gtk-docs.sgml
10
11 # Extra options to supply to gtkdoc-scan
12 SCAN_OPTIONS=--deprecated-guards="GTK_ENABLE_BROKEN|GTK_DISABLE_DEPRECATED"
13
14 # The directory containing the source code. Relative to $(srcdir)
15 DOC_SOURCE_DIR=$(top_srcdir)/gtk
16
17 # Used for dependencies
18 HFILE_GLOB=$(top_srcdir)/gtk/*.h
19 CFILE_GLOB=$(top_srcdir)/gtk/*.c
20
21 # Header files to ignore when scanning
22 IGNORE_HFILES=                          \
23         fnmatch.h                       \
24         gtk9slice.h                     \
25         gtkanimationdescription.h       \
26         gtkdebug.h                      \
27         gtkbuilderprivate.h             \
28         gtkdndcursors.h                 \
29         gtkentryprivate.h               \
30         gtkfilechooserdefault.h         \
31         gtkfilechooserembed.h           \
32         gtkfilechooserentry.h           \
33         gtkfilechooserprivate.h         \
34         gtkfilechoosersettings.h        \
35         gtkfilechooserutils.h           \
36         gtkfilesystem.h                 \
37         gtkfilesystemmodel.h            \
38         gtkfilesystemunix.h             \
39         gtkfilesystemwin32.h            \
40         gtkiconcache.h                  \
41         gtkiconcachevalidator.h         \
42         gtkiconthemeparser.h            \
43         gtkintl.h                       \
44         gtkkeyhash.h                    \
45         gtkmarshal.h                    \
46         gtkmenuprivate.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         gtktimeline.h                   \
83         gtkthemes.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 AM_CPPFLAGS = \
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/libgdk-3.la \
111         $(top_builddir)/gtk/libgtk-3.la \
112         $(GTK_DEP_LIBS)
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         compiling.sgml                          \
124         drawing-model.xml                       \
125         glossary.xml                            \
126         migrating-2to3.xml                      \
127         migrating-checklist.sgml                \
128         migrating-unique-GtkApplication.xml     \
129         migrating-smclient-GtkApplication.xml   \
130         migrating-GtkGrid.xml                   \
131         migrating-GtkStyleContext.xml           \
132         objects_grouped.sgml                    \
133         osx.sgml                                \
134         broadway.xml                            \
135         wayland.xml                             \
136         question_index.sgml                     \
137         resources.sgml                          \
138         text_widget.sgml                        \
139         tree_widget.sgml                        \
140         windows.sgml                            \
141         x11.sgml                                \
142         gtk-query-immodules-3.0.xml             \
143         gtk-update-icon-cache.xml               \
144         gtk-launch.xml                          \
145         visual_index.xml                        \
146         getting_started.xml                     \
147         overview.xml
148
149 expand_content_files =                          \
150         compiling.sgml                          \
151         drawing-model.xml                       \
152         getting_started.xml                     \
153         glossary.xml                            \
154         migrating-2to3.xml                      \
155         migrating-checklist.sgml                \
156         migrating-unique-GtkApplication.xml     \
157         migrating-smclient-GtkApplication.xml   \
158         migrating-GtkGrid.xml                   \
159         migrating-GtkStyleContext.xml           \
160         question_index.sgml                     \
161         text_widget.sgml                        \
162         tree_widget.sgml
163
164 # Images to copy into HTML directory
165 HTML_IMAGES = \
166         $(top_srcdir)/gtk/stock-icons/24/help-about.png                 \
167         $(top_srcdir)/gtk/stock-icons/24/list-add.png                   \
168         $(top_srcdir)/gtk/stock-icons/20/gtk-apply.png                  \
169         $(top_srcdir)/gtk/stock-icons/24/format-text-bold.png           \
170         $(top_srcdir)/gtk/stock-icons/20/gtk-cancel.png                 \
171         $(top_srcdir)/gtk/stock-icons/24/gtk-caps-lock-warning.png      \
172         $(top_srcdir)/gtk/stock-icons/24/media-optical.png              \
173         $(top_srcdir)/gtk/stock-icons/24/edit-clear.png                 \
174         $(top_srcdir)/gtk/stock-icons/24/window-close.png               \
175         $(top_srcdir)/gtk/stock-icons/24/gtk-connect.png                \
176         $(top_srcdir)/gtk/stock-icons/24/gtk-convert.png                \
177         $(top_srcdir)/gtk/stock-icons/24/edit-copy.png                  \
178         $(top_srcdir)/gtk/stock-icons/24/edit-cut.png                   \
179         $(top_srcdir)/gtk/stock-icons/24/edit-delete.png                \
180         $(top_srcdir)/gtk/stock-icons/48/dialog-password.png            \
181         $(top_srcdir)/gtk/stock-icons/48/dialog-error.png               \
182         $(top_srcdir)/gtk/stock-icons/48/dialog-information.png         \
183         $(top_srcdir)/gtk/stock-icons/48/dialog-question.png            \
184         $(top_srcdir)/gtk/stock-icons/48/dialog-warning.png             \
185         $(top_srcdir)/gtk/stock-icons/24/folder.png                     \
186         $(top_srcdir)/gtk/stock-icons/24/gtk-disconnect.png             \
187         $(top_srcdir)/gtk/stock-icons/32/gtk-dnd.png                    \
188         $(top_srcdir)/gtk/stock-icons/32/gtk-dnd-multiple.png           \
189         $(top_srcdir)/gtk/stock-icons/24/gtk-edit.png                   \
190         $(top_srcdir)/gtk/stock-icons/24/system-run.png                 \
191         $(top_srcdir)/gtk/stock-icons/24/text-x-generic.png             \
192         $(top_srcdir)/gtk/stock-icons/24/edit-find.png                  \
193         $(top_srcdir)/gtk/stock-icons/24/edit-find-replace.png          \
194         $(top_srcdir)/gtk/stock-icons/24/go-bottom.png                  \
195         $(top_srcdir)/gtk/stock-icons/24/go-first-ltr.png               \
196         $(top_srcdir)/gtk/stock-icons/24/go-first-rtl.png               \
197         $(top_srcdir)/gtk/stock-icons/24/go-last-ltr.png                \
198         $(top_srcdir)/gtk/stock-icons/24/go-last-rtl.png                \
199         $(top_srcdir)/gtk/stock-icons/24/go-top.png                     \
200         $(top_srcdir)/gtk/stock-icons/24/go-previous-ltr.png            \
201         $(top_srcdir)/gtk/stock-icons/24/go-previous-rtl.png            \
202         $(top_srcdir)/gtk/stock-icons/24/go-down.png                    \
203         $(top_srcdir)/gtk/stock-icons/24/go-next-ltr.png                \
204         $(top_srcdir)/gtk/stock-icons/24/go-next-rtl.png                \
205         $(top_srcdir)/gtk/stock-icons/24/go-up.png                      \
206         $(top_srcdir)/gtk/stock-icons/24/drive-harddisk.png             \
207         $(top_srcdir)/gtk/stock-icons/24/network-idle.png               \
208         $(top_srcdir)/gtk/stock-icons/24/help-contents.png              \
209         $(top_srcdir)/gtk/stock-icons/24/go-home.png                    \
210         $(top_srcdir)/gtk/stock-icons/24/gtk-index.png                  \
211         $(top_srcdir)/gtk/stock-icons/24/format-indent-more-ltr.png     \
212         $(top_srcdir)/gtk/stock-icons/24/format-indent-more-rtl.png     \
213         $(top_srcdir)/gtk/stock-icons/24/format-indent-less-ltr.png     \
214         $(top_srcdir)/gtk/stock-icons/24/format-indent-less-rtl.png     \
215         $(top_srcdir)/gtk/stock-icons/24/format-text-italic.png         \
216         $(top_srcdir)/gtk/stock-icons/24/go-jump-ltr.png                \
217         $(top_srcdir)/gtk/stock-icons/24/go-jump-rtl.png                \
218         $(top_srcdir)/gtk/stock-icons/24/format-justify-center.png      \
219         $(top_srcdir)/gtk/stock-icons/24/format-justify-fill.png        \
220         $(top_srcdir)/gtk/stock-icons/24/format-justify-left.png        \
221         $(top_srcdir)/gtk/stock-icons/24/format-justify-right.png       \
222         $(top_srcdir)/gtk/stock-icons/24/image-missing.png              \
223         $(top_srcdir)/gtk/stock-icons/24/document-new.png               \
224         $(top_srcdir)/gtk/stock-icons/20/gtk-no.png                     \
225         $(top_srcdir)/gtk/stock-icons/20/gtk-ok.png                     \
226         $(top_srcdir)/gtk/stock-icons/24/document-open.png              \
227         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-landscape.png  \
228         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-portrait.png   \
229         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-reverse-landscape.png \
230         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-reverse-portrait.png \
231         $(top_srcdir)/gtk/stock-icons/24/edit-paste.png                 \
232         $(top_srcdir)/gtk/stock-icons/24/gtk-preferences.png            \
233         $(top_srcdir)/gtk/stock-icons/24/document-print.png             \
234         $(top_srcdir)/gtk/stock-icons/24/printer-error.png              \
235         $(top_srcdir)/gtk/stock-icons/24/printer-paused.png             \
236         $(top_srcdir)/gtk/stock-icons/24/document-print-preview.png     \
237         $(top_srcdir)/gtk/stock-icons/24/printer-info.png               \
238         $(top_srcdir)/gtk/stock-icons/24/printer-warning.png            \
239         $(top_srcdir)/gtk/stock-icons/24/document-properties.png        \
240         $(top_srcdir)/gtk/stock-icons/24/application-exit.png           \
241         $(top_srcdir)/gtk/stock-icons/24/edit-redo-ltr.png              \
242         $(top_srcdir)/gtk/stock-icons/24/edit-redo-rtl.png              \
243         $(top_srcdir)/gtk/stock-icons/24/view-refresh.png               \
244         $(top_srcdir)/gtk/stock-icons/24/list-remove.png                \
245         $(top_srcdir)/gtk/stock-icons/24/document-revert-ltr.png        \
246         $(top_srcdir)/gtk/stock-icons/24/document-revert-rtl.png        \
247         $(top_srcdir)/gtk/stock-icons/24/media-floppy.png               \
248         $(top_srcdir)/gtk/stock-icons/24/document-save.png              \
249         $(top_srcdir)/gtk/stock-icons/24/document-save-as.png           \
250         $(top_srcdir)/gtk/stock-icons/24/edit-select-all.png            \
251         $(top_srcdir)/gtk/stock-icons/24/gtk-select-color.png           \
252         $(top_srcdir)/gtk/stock-icons/24/gtk-color-picker.png           \
253         $(top_srcdir)/gtk/stock-icons/24/gtk-font.png                   \
254         $(top_srcdir)/gtk/stock-icons/24/view-sort-ascending.png        \
255         $(top_srcdir)/gtk/stock-icons/24/view-sort-descending.png       \
256         $(top_srcdir)/gtk/stock-icons/24/tools-check-spelling.png       \
257         $(top_srcdir)/gtk/stock-icons/24/process-stop.png               \
258         $(top_srcdir)/gtk/stock-icons/24/format-text-strikethrough.png  \
259         $(top_srcdir)/gtk/stock-icons/24/gtk-undelete-ltr.png           \
260         $(top_srcdir)/gtk/stock-icons/24/gtk-undelete-rtl.png           \
261         $(top_srcdir)/gtk/stock-icons/24/format-text-underline.png      \
262         $(top_srcdir)/gtk/stock-icons/24/edit-undo-ltr.png              \
263         $(top_srcdir)/gtk/stock-icons/24/edit-undo-rtl.png              \
264         $(top_srcdir)/gtk/stock-icons/20/gtk-yes.png                    \
265         $(top_srcdir)/gtk/stock-icons/24/zoom-original.png              \
266         $(top_srcdir)/gtk/stock-icons/24/zoom-fit-best.png              \
267         $(top_srcdir)/gtk/stock-icons/24/zoom-in.png                    \
268         $(top_srcdir)/gtk/stock-icons/24/zoom-out.png                   \
269         $(top_srcdir)/gtk/stock-icons/24/media-seek-forward-ltr.png     \
270         $(top_srcdir)/gtk/stock-icons/24/media-seek-forward-rtl.png     \
271         $(top_srcdir)/gtk/stock-icons/24/media-skip-forward-ltr.png     \
272         $(top_srcdir)/gtk/stock-icons/24/media-skip-forward-rtl.png     \
273         $(top_srcdir)/gtk/stock-icons/24/media-playback-pause.png       \
274         $(top_srcdir)/gtk/stock-icons/24/media-playback-start-ltr.png   \
275         $(top_srcdir)/gtk/stock-icons/24/media-playback-start-rtl.png   \
276         $(top_srcdir)/gtk/stock-icons/24/media-seek-backward-ltr.png    \
277         $(top_srcdir)/gtk/stock-icons/24/media-seek-backward-rtl.png    \
278         $(top_srcdir)/gtk/stock-icons/24/media-record.png               \
279         $(top_srcdir)/gtk/stock-icons/24/media-skip-backward-ltr.png    \
280         $(top_srcdir)/gtk/stock-icons/24/media-skip-backward-rtl.png    \
281         $(top_srcdir)/gtk/stock-icons/24/media-playback-stop.png        \
282         $(top_srcdir)/gtk/stock-icons/24/view-fullscreen.png            \
283         $(top_srcdir)/gtk/stock-icons/24/view-restore.png               \
284         $(top_srcdir)/gtk/stock-icons/24/gtk-page-setup.png             \
285         $(srcdir)/images/aboutdialog.png                                \
286         $(srcdir)/images/accel-label.png                                \
287         $(srcdir)/images/appchooserbutton.png                           \
288         $(srcdir)/images/appchooserdialog.png                           \
289         $(srcdir)/images/assistant.png                                  \
290         $(srcdir)/images/box-packing.png                                \
291         $(srcdir)/images/box-expand.png                         \
292         $(srcdir)/images/button.png                                     \
293         $(srcdir)/images/check-button.png                               \
294         $(srcdir)/images/color-button.png                               \
295         $(srcdir)/images/colorsel.png                                   \
296         $(srcdir)/images/colorchooser.png                               \
297         $(srcdir)/images/combo-box.png                                  \
298         $(srcdir)/images/combo-box-entry.png                            \
299         $(srcdir)/images/entry.png                                      \
300         $(srcdir)/images/search-entry.png                               \
301         $(srcdir)/images/figure-hierarchical-drawing.png                \
302         $(srcdir)/images/figure-windowed-label.png                      \
303         $(srcdir)/images/file-button.png                                \
304         $(srcdir)/images/filechooser.png                                \
305         $(srcdir)/images/font-button.png                                \
306         $(srcdir)/images/fontsel.png                                    \
307         $(srcdir)/images/fontchooser.png                                \
308         $(srcdir)/images/frame.png                                      \
309         $(srcdir)/images/icon-view.png                                  \
310         $(srcdir)/images/image.png                                      \
311         $(srcdir)/images/label.png                                      \
312         $(srcdir)/images/link-button.png                                \
313         $(srcdir)/images/list-and-tree.png                              \
314         $(srcdir)/images/lock-button.png                                \
315         $(srcdir)/images/lockbutton.png                                 \
316         $(srcdir)/images/lockbutton-locked.png                          \
317         $(srcdir)/images/lockbutton-unlocked.png                        \
318         $(srcdir)/images/lockbutton-sorry.png                           \
319         $(srcdir)/images/menubar.png                                    \
320         $(srcdir)/images/menu-button.png                                \
321         $(srcdir)/images/messagedialog.png                              \
322         $(srcdir)/images/multiline-text.png                             \
323         $(srcdir)/images/notebook.png                                   \
324         $(srcdir)/images/panes.png                                      \
325         $(srcdir)/images/pagesetupdialog.png                            \
326         $(srcdir)/images/printdialog.png                                \
327         $(srcdir)/images/progressbar.png                                \
328         $(srcdir)/images/radio-group.png                                \
329         $(srcdir)/images/recentchooserdialog.png                        \
330         $(srcdir)/images/scales.png                                     \
331         $(srcdir)/images/scrolledwindow.png                             \
332         $(srcdir)/images/separator.png                                  \
333         $(srcdir)/images/spinbutton.png                                 \
334         $(srcdir)/images/spinner.png                                    \
335         $(srcdir)/images/statusbar.png                                  \
336         $(srcdir)/images/toggle-button.png                              \
337         $(srcdir)/images/toolbar.png                                    \
338         $(srcdir)/images/toolpalette.png                                \
339         $(srcdir)/images/tree-view-coordinates.png                      \
340         $(srcdir)/images/volumebutton.png                               \
341         $(srcdir)/images/window.png                                     \
342         $(srcdir)/images/layout-btlr.png                                \
343         $(srcdir)/images/layout-btrl.png                                \
344         $(srcdir)/images/layout-lrbt.png                                \
345         $(srcdir)/images/layout-lrtb.png                                \
346         $(srcdir)/images/layout-rlbt.png                                \
347         $(srcdir)/images/layout-rltb.png                                \
348         $(srcdir)/images/layout-tblr.png                                \
349         $(srcdir)/images/layout-tbrl.png                                \
350         $(srcdir)/images/widget-hvalign.png                             \
351         $(srcdir)/images/window-default.png                             \
352         $(srcdir)/images/hello-world.png                                \
353         $(srcdir)/images/grid-packing.png                               \
354         $(srcdir)/images/drawing.png                                    \
355         $(srcdir)/images/switch.png                                     \
356         $(srcdir)/images/linear.png                                     \
357         $(srcdir)/images/ease.png                                       \
358         $(srcdir)/images/ease-in-out.png                                \
359         $(srcdir)/images/ease-in.png                                    \
360         $(srcdir)/images/ease-out.png                                   \
361         $(srcdir)/images/gradient1.png                                  \
362         $(srcdir)/images/gradient2.png                                  \
363         $(srcdir)/images/gradient3.png                                  \
364         $(srcdir)/images/gradient4.png                                  \
365         $(srcdir)/images/border1.png                                    \
366         $(srcdir)/images/border2.png                                    \
367         $(srcdir)/images/border3.png                                    \
368         $(srcdir)/images/slices.png                                     \
369         $(srcdir)/images/checks.png                                     \
370         $(srcdir)/images/options.png                                    \
371         $(srcdir)/images/arrows.png                                     \
372         $(srcdir)/images/expanders.png                                  \
373         $(srcdir)/images/background.png                                 \
374         $(srcdir)/images/frames.png                                     \
375         $(srcdir)/images/frame-gap.png                                  \
376         $(srcdir)/images/sliders.png                                    \
377         $(srcdir)/images/focus.png                                      \
378         $(srcdir)/images/handles.png                                    \
379         $(srcdir)/images/extensions.png                                 \
380         $(srcdir)/images/numerableicon.png                              \
381         $(srcdir)/images/numerableicon2.png                             \
382         $(srcdir)/images/bloatpad-osx.png                               \
383         $(srcdir)/images/bloatpad-gnome.png                             \
384         $(srcdir)/images/bloatpad-xfce.png
385
386 # Extra options to supply to gtkdoc-fixref
387 FIXXREF_OPTIONS=--extra-dir=../gdk/html \
388         --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gobject \
389         --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/glib \
390         --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gio \
391         --extra-dir=$(ATK_PREFIX)/share/gtk-doc/html/atk \
392         --extra-dir=$(PANGO_PREFIX)/share/gtk-doc/html/pango \
393         --extra-dir=$(CAIRO_PREFIX)/share/gtk-doc/html/cairo
394
395 include $(top_srcdir)/gtk-doc.make
396
397 # Other files to distribute
398 EXTRA_DIST += version.xml.in gtk3.types.in
399
400 ########################################################################
401
402 man_MANS =                              \
403         gtk-query-immodules-3.0.1       \
404         gtk-update-icon-cache.1         \
405         gtk-launch.1
406
407 if ENABLE_MAN
408
409 .xml.1:
410         @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
411
412 dist-local-check-mans-enabled:
413         if grep "Man generation disabled" $(man_MANS) >/dev/null; then $(RM) $(man_MANS); fi
414
415 else
416
417 $(man_MANS):
418         echo Man generation disabled.  Creating dummy $@.  Configure with --enable-man to enable it.
419         echo Man generation disabled.  Remove this file, configure with --enable-man, and rebuild > $@
420
421 dist-local-check-mans-enabled:
422         echo "*** --enable-man must be used in order to make dist"
423         false
424
425 endif
426
427 MAINTAINERCLEANFILES = $(man_MANS) $(BUILT_SOURCES)
428
429 EXTRA_DIST += $(man_MANS)
430
431 dist-hook-local: dist-local-check-mans-enabled all-local
432
433 gtk-docs-clean: clean
434         cd $(srcdir) && rm -rf xml html
435
436 -include $(top_srcdir)/git.mk