Pileus Git - ~andy/gtk/blob - 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=../../../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         gtkmnemonichash.h               \
  47         gtkpathbar.h                    \
  48         gtkplugprivate.h                \
  49         gtkprintbackend.h               \
  50         gtkprinteroption.h              \
  51         gtkprinteroptionset.h           \
  52         gtkprinteroptionwidget.h        \
  53         gtkprinter-private.h            \
  54         gtkprint-win32.h                \
  55         gtkprintutils.h                 \
  56         gtkprintoperation-private.h     \
  57         gtkprivate.h                    \
  58         gtkquery.h                      \
  59         gtkrbtree.h                     \
  60         gtkrecentchooserdefault.h       \
  61         gtkrecentchooserutils.h         \
  62         gtkrecentchooserprivate.h       \
  63         gtksearchengine.h               \
  64         gtksearchenginebeagle.h         \
  65         gtksearchenginetracker.h        \
  66         gtksearchenginesimple.h         \
  67         gtksearchenginequartz.h         \
  68         gtksequence.h                   \
  69         gtksocketprivate.h              \
  70         gtktextbtree.h                  \
  71         gtktextbufferserializ.h         \
  72         gtktextchildprivate.h           \
  73         gtktextdisplay.h                \
  74         gtktextiterprivate.h            \
  75         gtktextlayout.h                 \
  76         gtktextmarkprivate.h            \
  77         gtktextsegment.h                \
  78         gtktexttagprivate.h             \
  79         gtktexttypes.h                  \
  80         gtktextutil.h                   \
  81         gtktimeline.h                   \
  82         gtkthemes.h                     \
  83         gtktrayicon.h                   \
  84         gtktreedatalist.h               \
  85         gtktreeprivate.h                \
  86         gtktoolpaletteprivate.h         \
  87         gtktypebuiltins.h               \
  88         gtkxembed.h                     \
  89         gtkwin32embed.h                 \
  90         gtkwin32embedwidget.h           \
  91         gtkwindow-decorate.h            \
  92         xdgmime                         \
  93         xembed.h
  94
  95 # CFLAGS and LDFLAGS for compiling scan program. Only needed
  96 # if $(DOC_MODULE).types is non-empty.
  97 AM_CPPFLAGS = \
  98         -I$(top_srcdir)         \
  99         -I$(top_builddir)       \
 100         -I$(top_builddir)/gdk   \
 101         -DGTK_ENABLE_BROKEN     \
 102         $(GTK_DEBUG_FLAGS)      \
 103         $(GTK_DEP_CFLAGS)
 104
 105 CPPFLAGS += \
 106         -UGTK_DISABLE_SINGLE_INCLUDES
 107
 108 GTKDOC_LIBS = \
 109         $(top_builddir)/gtk/libgtk-3.la \
 110         $(GTK_DEP_LIBS)
 111
 112
 113 # Extra options to supply to gtkdoc-mkdb
 114 MKDB_OPTIONS=--sgml-mode --output-format=xml --name-space=gtk
 115
 116 # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE)
 117 content_files =                                 \
 118         version.xml                             \
 119         running.sgml                            \
 120         building.sgml                           \
 121         compiling.sgml                          \
 122         drawing-model.xml                       \
 123         glossary.xml                            \
 124         migrating-2to3.xml                      \
 125         migrating-checklist.sgml                \
 126         migrating-GtkApplication.xml            \
 127         migrating-GtkGrid.xml                   \
 128         migrating-GtkStyleContext.xml           \
 129         objects_grouped.sgml                    \
 130         osx.sgml                                \
 131         question_index.sgml                     \
 132         resources.sgml                          \
 133         text_widget.sgml                        \
 134         tree_widget.sgml                        \
 135         windows.sgml                            \
 136         x11.sgml                                \
 137         gtk-query-immodules-3.0.xml             \
 138         gtk-update-icon-cache.xml               \
 139         visual_index.xml                        \
 140         getting_started.xml                     \
 141         overview.xml
 142
 143 expand_content_files =                          \
 144         drawing-model.xml                       \
 145         getting_started.xml                     \
 146         glossary.xml                            \
 147         migrating-2to3.xml                      \
 148         migrating-checklist.sgml                \
 149         migrating-GtkApplication.xml            \
 150         migrating-GtkGrid.xml                   \
 151         migrating-GtkStyleContext.xml           \
 152         question_index.sgml                     \
 153         text_widget.sgml                        \
 154         tree_widget.sgml
 155
 156 # Images to copy into HTML directory
 157 HTML_IMAGES = \
 158         $(top_srcdir)/gtk/stock-icons/24/help-about.png                 \
 159         $(top_srcdir)/gtk/stock-icons/24/list-add.png                   \
 160         $(top_srcdir)/gtk/stock-icons/20/gtk-apply.png                  \
 161         $(top_srcdir)/gtk/stock-icons/24/format-text-bold.png           \
 162         $(top_srcdir)/gtk/stock-icons/20/gtk-cancel.png                 \
 163         $(top_srcdir)/gtk/stock-icons/24/gtk-caps-lock-warning.png      \
 164         $(top_srcdir)/gtk/stock-icons/24/media-optical.png              \
 165         $(top_srcdir)/gtk/stock-icons/24/edit-clear.png                 \
 166         $(top_srcdir)/gtk/stock-icons/24/window-close.png               \
 167         $(top_srcdir)/gtk/stock-icons/24/gtk-connect.png                \
 168         $(top_srcdir)/gtk/stock-icons/24/gtk-convert.png                \
 169         $(top_srcdir)/gtk/stock-icons/24/edit-copy.png                  \
 170         $(top_srcdir)/gtk/stock-icons/24/edit-cut.png                   \
 171         $(top_srcdir)/gtk/stock-icons/24/edit-delete.png                \
 172         $(top_srcdir)/gtk/stock-icons/48/dialog-password.png            \
 173         $(top_srcdir)/gtk/stock-icons/48/dialog-error.png               \
 174         $(top_srcdir)/gtk/stock-icons/48/dialog-information.png         \
 175         $(top_srcdir)/gtk/stock-icons/48/dialog-question.png            \
 176         $(top_srcdir)/gtk/stock-icons/48/dialog-warning.png             \
 177         $(top_srcdir)/gtk/stock-icons/24/folder.png                     \
 178         $(top_srcdir)/gtk/stock-icons/24/gtk-disconnect.png             \
 179         $(top_srcdir)/gtk/stock-icons/32/gtk-dnd.png                    \
 180         $(top_srcdir)/gtk/stock-icons/32/gtk-dnd-multiple.png           \
 181         $(top_srcdir)/gtk/stock-icons/24/gtk-edit.png                   \
 182         $(top_srcdir)/gtk/stock-icons/24/system-run.png                 \
 183         $(top_srcdir)/gtk/stock-icons/24/text-x-generic.png             \
 184         $(top_srcdir)/gtk/stock-icons/24/edit-find.png                  \
 185         $(top_srcdir)/gtk/stock-icons/24/edit-find-replace.png          \
 186         $(top_srcdir)/gtk/stock-icons/24/go-bottom.png                  \
 187         $(top_srcdir)/gtk/stock-icons/24/go-first-ltr.png               \
 188         $(top_srcdir)/gtk/stock-icons/24/go-first-rtl.png               \
 189         $(top_srcdir)/gtk/stock-icons/24/go-last-ltr.png                \
 190         $(top_srcdir)/gtk/stock-icons/24/go-last-rtl.png                \
 191         $(top_srcdir)/gtk/stock-icons/24/go-top.png                     \
 192         $(top_srcdir)/gtk/stock-icons/24/go-previous-ltr.png            \
 193         $(top_srcdir)/gtk/stock-icons/24/go-previous-rtl.png            \
 194         $(top_srcdir)/gtk/stock-icons/24/go-down.png                    \
 195         $(top_srcdir)/gtk/stock-icons/24/go-next-ltr.png                \
 196         $(top_srcdir)/gtk/stock-icons/24/go-next-rtl.png                \
 197         $(top_srcdir)/gtk/stock-icons/24/go-up.png                      \
 198         $(top_srcdir)/gtk/stock-icons/24/drive-harddisk.png             \
 199         $(top_srcdir)/gtk/stock-icons/24/network-idle.png               \
 200         $(top_srcdir)/gtk/stock-icons/24/help-contents.png              \
 201         $(top_srcdir)/gtk/stock-icons/24/go-home.png                    \
 202         $(top_srcdir)/gtk/stock-icons/24/gtk-index.png                  \
 203         $(top_srcdir)/gtk/stock-icons/24/format-indent-more-ltr.png     \
 204         $(top_srcdir)/gtk/stock-icons/24/format-indent-more-rtl.png     \
 205         $(top_srcdir)/gtk/stock-icons/24/format-indent-less-ltr.png     \
 206         $(top_srcdir)/gtk/stock-icons/24/format-indent-less-rtl.png     \
 207         $(top_srcdir)/gtk/stock-icons/24/format-text-italic.png         \
 208         $(top_srcdir)/gtk/stock-icons/24/go-jump-ltr.png                \
 209         $(top_srcdir)/gtk/stock-icons/24/go-jump-rtl.png                \
 210         $(top_srcdir)/gtk/stock-icons/24/format-justify-center.png      \
 211         $(top_srcdir)/gtk/stock-icons/24/format-justify-fill.png        \
 212         $(top_srcdir)/gtk/stock-icons/24/format-justify-left.png        \
 213         $(top_srcdir)/gtk/stock-icons/24/format-justify-right.png       \
 214         $(top_srcdir)/gtk/stock-icons/24/image-missing.png              \
 215         $(top_srcdir)/gtk/stock-icons/24/document-new.png               \
 216         $(top_srcdir)/gtk/stock-icons/20/gtk-no.png                     \
 217         $(top_srcdir)/gtk/stock-icons/20/gtk-ok.png                     \
 218         $(top_srcdir)/gtk/stock-icons/24/document-open.png              \
 219         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-landscape.png  \
 220         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-portrait.png   \
 221         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-reverse-landscape.png \
 222         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-reverse-portrait.png \
 223         $(top_srcdir)/gtk/stock-icons/24/edit-paste.png                 \
 224         $(top_srcdir)/gtk/stock-icons/24/gtk-preferences.png            \
 225         $(top_srcdir)/gtk/stock-icons/24/document-print.png             \
 226         $(top_srcdir)/gtk/stock-icons/24/printer-error.png              \
 227         $(top_srcdir)/gtk/stock-icons/24/printer-paused.png             \
 228         $(top_srcdir)/gtk/stock-icons/24/document-print-preview.png     \
 229         $(top_srcdir)/gtk/stock-icons/24/printer-info.png               \
 230         $(top_srcdir)/gtk/stock-icons/24/printer-warning.png            \
 231         $(top_srcdir)/gtk/stock-icons/24/document-properties.png        \
 232         $(top_srcdir)/gtk/stock-icons/24/application-exit.png           \
 233         $(top_srcdir)/gtk/stock-icons/24/edit-redo-ltr.png              \
 234         $(top_srcdir)/gtk/stock-icons/24/edit-redo-rtl.png              \
 235         $(top_srcdir)/gtk/stock-icons/24/view-refresh.png               \
 236         $(top_srcdir)/gtk/stock-icons/24/list-remove.png                \
 237         $(top_srcdir)/gtk/stock-icons/24/document-revert-ltr.png        \
 238         $(top_srcdir)/gtk/stock-icons/24/document-revert-rtl.png        \
 239         $(top_srcdir)/gtk/stock-icons/24/media-floppy.png               \
 240         $(top_srcdir)/gtk/stock-icons/24/document-save.png              \
 241         $(top_srcdir)/gtk/stock-icons/24/document-save-as.png           \
 242         $(top_srcdir)/gtk/stock-icons/24/edit-select-all.png            \
 243         $(top_srcdir)/gtk/stock-icons/24/gtk-select-color.png           \
 244         $(top_srcdir)/gtk/stock-icons/24/gtk-color-picker.png           \
 245         $(top_srcdir)/gtk/stock-icons/24/gtk-font.png                   \
 246         $(top_srcdir)/gtk/stock-icons/24/view-sort-ascending.png        \
 247         $(top_srcdir)/gtk/stock-icons/24/view-sort-descending.png       \
 248         $(top_srcdir)/gtk/stock-icons/24/tools-check-spelling.png       \
 249         $(top_srcdir)/gtk/stock-icons/24/process-stop.png               \
 250         $(top_srcdir)/gtk/stock-icons/24/format-text-strikethrough.png  \
 251         $(top_srcdir)/gtk/stock-icons/24/gtk-undelete-ltr.png           \
 252         $(top_srcdir)/gtk/stock-icons/24/gtk-undelete-rtl.png           \
 253         $(top_srcdir)/gtk/stock-icons/24/format-text-underline.png      \
 254         $(top_srcdir)/gtk/stock-icons/24/edit-undo-ltr.png              \
 255         $(top_srcdir)/gtk/stock-icons/24/edit-undo-rtl.png              \
 256         $(top_srcdir)/gtk/stock-icons/20/gtk-yes.png                    \
 257         $(top_srcdir)/gtk/stock-icons/24/zoom-original.png              \
 258         $(top_srcdir)/gtk/stock-icons/24/zoom-fit-best.png              \
 259         $(top_srcdir)/gtk/stock-icons/24/zoom-in.png                    \
 260         $(top_srcdir)/gtk/stock-icons/24/zoom-out.png                   \
 261         $(top_srcdir)/gtk/stock-icons/24/media-seek-forward-ltr.png     \
 262         $(top_srcdir)/gtk/stock-icons/24/media-seek-forward-rtl.png     \
 263         $(top_srcdir)/gtk/stock-icons/24/media-skip-forward-ltr.png     \
 264         $(top_srcdir)/gtk/stock-icons/24/media-skip-forward-rtl.png     \
 265         $(top_srcdir)/gtk/stock-icons/24/media-playback-pause.png       \
 266         $(top_srcdir)/gtk/stock-icons/24/media-playback-start-ltr.png   \
 267         $(top_srcdir)/gtk/stock-icons/24/media-playback-start-rtl.png   \
 268         $(top_srcdir)/gtk/stock-icons/24/media-seek-backward-ltr.png    \
 269         $(top_srcdir)/gtk/stock-icons/24/media-seek-backward-rtl.png    \
 270         $(top_srcdir)/gtk/stock-icons/24/media-record.png               \
 271         $(top_srcdir)/gtk/stock-icons/24/media-skip-backward-ltr.png    \
 272         $(top_srcdir)/gtk/stock-icons/24/media-skip-backward-rtl.png    \
 273         $(top_srcdir)/gtk/stock-icons/24/media-playback-stop.png        \
 274         $(top_srcdir)/gtk/stock-icons/24/view-fullscreen.png            \
 275         $(top_srcdir)/gtk/stock-icons/24/view-restore.png               \
 276         $(top_srcdir)/gtk/stock-icons/24/gtk-page-setup.png             \
 277         $(srcdir)/images/aboutdialog.png                                \
 278         $(srcdir)/images/accel-label.png                                \
 279         $(srcdir)/images/appchooserbutton.png                           \
 280         $(srcdir)/images/appchooserdialog.png                           \
 281         $(srcdir)/images/assistant.png                                  \
 282         $(srcdir)/images/box-packing.png                                \
 283         $(srcdir)/images/box-expand.png                         \
 284         $(srcdir)/images/button.png                                     \
 285         $(srcdir)/images/check-button.png                               \
 286         $(srcdir)/images/color-button.png                               \
 287         $(srcdir)/images/colorsel.png                                   \
 288         $(srcdir)/images/combo-box.png                                  \
 289         $(srcdir)/images/combo-box-entry.png                            \
 290         $(srcdir)/images/entry.png                                      \
 291         $(srcdir)/images/figure-hierarchical-drawing.png                \
 292         $(srcdir)/images/figure-windowed-label.png                      \
 293         $(srcdir)/images/file-button.png                                \
 294         $(srcdir)/images/filechooser.png                                \
 295         $(srcdir)/images/font-button.png                                \
 296         $(srcdir)/images/fontsel.png                                    \
 297         $(srcdir)/images/frame.png                                      \
 298         $(srcdir)/images/icon-view.png                                  \
 299         $(srcdir)/images/image.png                                      \
 300         $(srcdir)/images/label.png                                      \
 301         $(srcdir)/images/link-button.png                                \
 302         $(srcdir)/images/list-and-tree.png                              \
 303         $(srcdir)/images/lockbutton.png                         \
 304         $(srcdir)/images/lockbutton-locked.png                          \
 305         $(srcdir)/images/lockbutton-unlocked.png                        \
 306         $(srcdir)/images/lockbutton-sorry.png                           \
 307         $(srcdir)/images/menubar.png                                    \
 308         $(srcdir)/images/messagedialog.png                              \
 309         $(srcdir)/images/multiline-text.png                             \
 310         $(srcdir)/images/notebook.png                                   \
 311         $(srcdir)/images/panes.png                                      \
 312         $(srcdir)/images/pagesetupdialog.png                            \
 313         $(srcdir)/images/printdialog.png                                \
 314         $(srcdir)/images/progressbar.png                                \
 315         $(srcdir)/images/radio-group.png                                \
 316         $(srcdir)/images/recentchooserdialog.png                        \
 317         $(srcdir)/images/scales.png                                     \
 318         $(srcdir)/images/scrolledwindow.png                             \
 319         $(srcdir)/images/separator.png                                  \
 320         $(srcdir)/images/spinbutton.png                                 \
 321         $(srcdir)/images/spinner.png                                    \
 322         $(srcdir)/images/statusbar.png                                  \
 323         $(srcdir)/images/toggle-button.png                              \
 324         $(srcdir)/images/toolbar.png                                    \
 325         $(srcdir)/images/toolpalette.png                                \
 326         $(srcdir)/images/tree-view-coordinates.png                      \
 327         $(srcdir)/images/volumebutton.png                               \
 328         $(srcdir)/images/window.png                                     \
 329         $(srcdir)/images/layout-btlr.png                                \
 330         $(srcdir)/images/layout-btrl.png                                \
 331         $(srcdir)/images/layout-lrbt.png                                \
 332         $(srcdir)/images/layout-lrtb.png                                \
 333         $(srcdir)/images/layout-rlbt.png                                \
 334         $(srcdir)/images/layout-rltb.png                                \
 335         $(srcdir)/images/layout-tblr.png                                \
 336         $(srcdir)/images/layout-tbrl.png                                \
 337         $(srcdir)/images/widget-hvalign.png                             \
 338         $(srcdir)/images/window-default.png                             \
 339         $(srcdir)/images/hello-world.png                                \
 340         $(srcdir)/images/grid-packing.png                               \
 341         $(srcdir)/images/drawing.png                                    \
 342         $(srcdir)/images/switch.png                                     \
 343         $(srcdir)/images/linear.png                                     \
 344         $(srcdir)/images/ease.png                                       \
 345         $(srcdir)/images/ease-in-out.png                                \
 346         $(srcdir)/images/ease-in.png                                    \
 347         $(srcdir)/images/ease-out.png                                   \
 348         $(srcdir)/images/gradient1.png                                  \
 349         $(srcdir)/images/gradient2.png                                  \
 350         $(srcdir)/images/gradient3.png                                  \
 351         $(srcdir)/images/gradient4.png                                  \
 352         $(srcdir)/images/border1.png                                    \
 353         $(srcdir)/images/border2.png                                    \
 354         $(srcdir)/images/border3.png                                    \
 355         $(srcdir)/images/slices.png                                     \
 356         $(srcdir)/images/checks.png                                     \
 357         $(srcdir)/images/options.png                                    \
 358         $(srcdir)/images/arrows.png                                     \
 359         $(srcdir)/images/expanders.png                                  \
 360         $(srcdir)/images/background.png                                 \
 361         $(srcdir)/images/frames.png                                     \
 362         $(srcdir)/images/frame-gap.png                                  \
 363         $(srcdir)/images/sliders.png                                    \
 364         $(srcdir)/images/focus.png                                      \
 365         $(srcdir)/images/handles.png                                    \
 366         $(srcdir)/images/extensions.png                                 \
 367         $(srcdir)/images/numerableicon.png                              \
 368         $(srcdir)/images/numerableicon2.png
 369
 370 # Extra options to supply to gtkdoc-fixref
 371 FIXXREF_OPTIONS=--extra-dir=../gdk/html \
 372         --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gobject \
 373         --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/glib \
 374         --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gio \
 375         --extra-dir=$(ATK_PREFIX)/share/gtk-doc/html/atk \
 376         --extra-dir=$(PANGO_PREFIX)/share/gtk-doc/html/pango \
 377         --extra-dir=$(CAIRO_PREFIX)/share/gtk-doc/html/cairo
 378
 379 include $(top_srcdir)/gtk-doc.make
 380
 381 # Other files to distribute
 382 EXTRA_DIST += version.xml.in
 383
 384 ########################################################################
 385
 386 man_MANS =                              \
 387         gtk-query-immodules-3.0.1       \
 388         gtk-update-icon-cache.1
 389
 390 if ENABLE_MAN
 391
 392 .xml.1:
 393         @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
 394
 395 dist-local-check-mans-enabled:
 396         if grep "Man generation disabled" $(man_MANS) >/dev/null; then $(RM) $(man_MANS); fi
 397
 398 else
 399
 400 $(man_MANS):
 401         echo Man generation disabled.  Creating dummy $@.  Configure with --enable-man to enable it.
 402         echo Man generation disabled.  Remove this file, configure with --enable-man, and rebuild > $@
 403
 404 dist-local-check-mans-enabled:
 405         echo "*** --enable-man must be used in order to make dist"
 406         false
 407
 408 endif
 409
 410 MAINTAINERCLEANFILES = $(man_MANS) $(BUILT_SOURCES)
 411
 412 EXTRA_DIST += $(man_MANS)
 413
 414 dist-hook-local: dist-local-check-mans-enabled all-local
 415
 416 gtk-docs-clean: clean
 417         cd $(srcdir) && rm -rf xml html
 418
 419 -include $(top_srcdir)/git.mk