Pileus Git - ~andy/gtk/blob - 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         fnmatch.h                       \
  25         gtk9slice.h                     \
  26         gtkanimationdescription.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         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 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/$(gdktargetlib)                             \
 111         $(top_builddir)/gtk/$(gtktargetlib)                             \
 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-GtkApplication.xml            \
 129         migrating-GtkStyleContext.xml           \
 130         objects_grouped.sgml                    \
 131         osx.sgml                                \
 132         question_index.sgml                     \
 133         resources.sgml                          \
 134         text_widget.sgml                        \
 135         tree_widget.sgml                        \
 136         windows.sgml                            \
 137         x11.sgml                                \
 138         gtk-query-immodules-3.0.xml             \
 139         gtk-update-icon-cache-3.0.xml           \
 140         gtk-builder-convert-3.0.xml             \
 141         visual_index.xml                        \
 142         getting_started.xml                     \
 143         overview.xml
 144
 145 expand_content_files =                          \
 146         drawing-model.xml                       \
 147         getting_started.xml                     \
 148         glossary.xml                            \
 149         migrating-2to3.xml                      \
 150         migrating-checklist.sgml                \
 151         migrating-GtkApplication.xml            \
 152         migrating-GtkStyleContext.xml           \
 153         question_index.sgml                     \
 154         text_widget.sgml                        \
 155         tree_widget.sgml
 156
 157 # Images to copy into HTML directory
 158 HTML_IMAGES = \
 159         $(top_srcdir)/gtk/stock-icons/24/help-about.png                 \
 160         $(top_srcdir)/gtk/stock-icons/24/list-add.png                   \
 161         $(top_srcdir)/gtk/stock-icons/20/gtk-apply.png                  \
 162         $(top_srcdir)/gtk/stock-icons/24/format-text-bold.png           \
 163         $(top_srcdir)/gtk/stock-icons/20/gtk-cancel.png                 \
 164         $(top_srcdir)/gtk/stock-icons/24/gtk-caps-lock-warning.png      \
 165         $(top_srcdir)/gtk/stock-icons/24/media-optical.png              \
 166         $(top_srcdir)/gtk/stock-icons/24/edit-clear.png                 \
 167         $(top_srcdir)/gtk/stock-icons/24/window-close.png               \
 168         $(top_srcdir)/gtk/stock-icons/24/gtk-connect.png                \
 169         $(top_srcdir)/gtk/stock-icons/24/gtk-convert.png                \
 170         $(top_srcdir)/gtk/stock-icons/24/edit-copy.png                  \
 171         $(top_srcdir)/gtk/stock-icons/24/edit-cut.png                   \
 172         $(top_srcdir)/gtk/stock-icons/24/edit-delete.png                \
 173         $(top_srcdir)/gtk/stock-icons/48/dialog-password.png            \
 174         $(top_srcdir)/gtk/stock-icons/48/dialog-error.png               \
 175         $(top_srcdir)/gtk/stock-icons/48/dialog-information.png         \
 176         $(top_srcdir)/gtk/stock-icons/48/dialog-question.png            \
 177         $(top_srcdir)/gtk/stock-icons/48/dialog-warning.png             \
 178         $(top_srcdir)/gtk/stock-icons/24/folder.png                     \
 179         $(top_srcdir)/gtk/stock-icons/24/gtk-disconnect.png             \
 180         $(top_srcdir)/gtk/stock-icons/32/gtk-dnd.png                    \
 181         $(top_srcdir)/gtk/stock-icons/32/gtk-dnd-multiple.png           \
 182         $(top_srcdir)/gtk/stock-icons/24/gtk-edit.png                   \
 183         $(top_srcdir)/gtk/stock-icons/24/system-run.png                 \
 184         $(top_srcdir)/gtk/stock-icons/24/document-x-generic.png         \
 185         $(top_srcdir)/gtk/stock-icons/24/edit-find.png                  \
 186         $(top_srcdir)/gtk/stock-icons/24/edit-find-replace.png          \
 187         $(top_srcdir)/gtk/stock-icons/24/go-bottom.png                  \
 188         $(top_srcdir)/gtk/stock-icons/24/go-first-ltr.png               \
 189         $(top_srcdir)/gtk/stock-icons/24/go-first-rtl.png               \
 190         $(top_srcdir)/gtk/stock-icons/24/go-last-ltr.png                \
 191         $(top_srcdir)/gtk/stock-icons/24/go-last-rtl.png                \
 192         $(top_srcdir)/gtk/stock-icons/24/go-top.png                     \
 193         $(top_srcdir)/gtk/stock-icons/24/go-previous-ltr.png            \
 194         $(top_srcdir)/gtk/stock-icons/24/go-previous-rtl.png            \
 195         $(top_srcdir)/gtk/stock-icons/24/go-down.png                    \
 196         $(top_srcdir)/gtk/stock-icons/24/go-next-ltr.png                \
 197         $(top_srcdir)/gtk/stock-icons/24/go-next-rtl.png                \
 198         $(top_srcdir)/gtk/stock-icons/24/go-up.png                      \
 199         $(top_srcdir)/gtk/stock-icons/24/drive-harddisk.png             \
 200         $(top_srcdir)/gtk/stock-icons/24/network-idle.png               \
 201         $(top_srcdir)/gtk/stock-icons/24/help-contents.png              \
 202         $(top_srcdir)/gtk/stock-icons/24/go-home.png                    \
 203         $(top_srcdir)/gtk/stock-icons/24/gtk-index.png                  \
 204         $(top_srcdir)/gtk/stock-icons/24/format-indent-more-ltr.png     \
 205         $(top_srcdir)/gtk/stock-icons/24/format-indent-more-rtl.png     \
 206         $(top_srcdir)/gtk/stock-icons/24/format-indent-less-ltr.png     \
 207         $(top_srcdir)/gtk/stock-icons/24/format-indent-less-rtl.png     \
 208         $(top_srcdir)/gtk/stock-icons/24/format-text-italic.png         \
 209         $(top_srcdir)/gtk/stock-icons/24/go-jump-ltr.png                \
 210         $(top_srcdir)/gtk/stock-icons/24/go-jump-rtl.png                \
 211         $(top_srcdir)/gtk/stock-icons/24/format-justify-center.png      \
 212         $(top_srcdir)/gtk/stock-icons/24/format-justify-fill.png        \
 213         $(top_srcdir)/gtk/stock-icons/24/format-justify-left.png        \
 214         $(top_srcdir)/gtk/stock-icons/24/format-justify-right.png       \
 215         $(top_srcdir)/gtk/stock-icons/24/image-missing.png              \
 216         $(top_srcdir)/gtk/stock-icons/24/document-new.png               \
 217         $(top_srcdir)/gtk/stock-icons/20/gtk-no.png                     \
 218         $(top_srcdir)/gtk/stock-icons/20/gtk-ok.png                     \
 219         $(top_srcdir)/gtk/stock-icons/24/document-open.png              \
 220         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-landscape.png  \
 221         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-portrait.png   \
 222         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-reverse-landscape.png \
 223         $(top_srcdir)/gtk/stock-icons/24/gtk-orientation-reverse-portrait.png \
 224         $(top_srcdir)/gtk/stock-icons/24/edit-paste.png                 \
 225         $(top_srcdir)/gtk/stock-icons/24/gtk-preferences.png            \
 226         $(top_srcdir)/gtk/stock-icons/24/document-print.png             \
 227         $(top_srcdir)/gtk/stock-icons/24/printer-error.png              \
 228         $(top_srcdir)/gtk/stock-icons/24/printer-paused.png             \
 229         $(top_srcdir)/gtk/stock-icons/24/document-print-preview.png     \
 230         $(top_srcdir)/gtk/stock-icons/24/printer-info.png               \
 231         $(top_srcdir)/gtk/stock-icons/24/printer-warning.png            \
 232         $(top_srcdir)/gtk/stock-icons/24/document-properties.png        \
 233         $(top_srcdir)/gtk/stock-icons/24/application-exit.png           \
 234         $(top_srcdir)/gtk/stock-icons/24/edit-redo-ltr.png              \
 235         $(top_srcdir)/gtk/stock-icons/24/edit-redo-rtl.png              \
 236         $(top_srcdir)/gtk/stock-icons/24/view-refresh.png               \
 237         $(top_srcdir)/gtk/stock-icons/24/list-remove.png                \
 238         $(top_srcdir)/gtk/stock-icons/24/document-revert-ltr.png        \
 239         $(top_srcdir)/gtk/stock-icons/24/document-revert-rtl.png        \
 240         $(top_srcdir)/gtk/stock-icons/24/media-floppy.png               \
 241         $(top_srcdir)/gtk/stock-icons/24/document-save.png              \
 242         $(top_srcdir)/gtk/stock-icons/24/document-save-as.png           \
 243         $(top_srcdir)/gtk/stock-icons/24/edit-select-all.png            \
 244         $(top_srcdir)/gtk/stock-icons/24/gtk-select-color.png           \
 245         $(top_srcdir)/gtk/stock-icons/24/gtk-color-picker.png           \
 246         $(top_srcdir)/gtk/stock-icons/24/gtk-font.png                   \
 247         $(top_srcdir)/gtk/stock-icons/24/view-sort-ascending.png        \
 248         $(top_srcdir)/gtk/stock-icons/24/view-sort-descending.png       \
 249         $(top_srcdir)/gtk/stock-icons/24/tools-check-spelling.png       \
 250         $(top_srcdir)/gtk/stock-icons/24/process-stop.png               \
 251         $(top_srcdir)/gtk/stock-icons/24/format-text-strikethrough.png  \
 252         $(top_srcdir)/gtk/stock-icons/24/gtk-undelete-ltr.png           \
 253         $(top_srcdir)/gtk/stock-icons/24/gtk-undelete-rtl.png           \
 254         $(top_srcdir)/gtk/stock-icons/24/format-text-underline.png      \
 255         $(top_srcdir)/gtk/stock-icons/24/edit-undo-ltr.png              \
 256         $(top_srcdir)/gtk/stock-icons/24/edit-undo-rtl.png              \
 257         $(top_srcdir)/gtk/stock-icons/20/gtk-yes.png                    \
 258         $(top_srcdir)/gtk/stock-icons/24/zoom-original.png              \
 259         $(top_srcdir)/gtk/stock-icons/24/zoom-fit-best.png              \
 260         $(top_srcdir)/gtk/stock-icons/24/zoom-in.png                    \
 261         $(top_srcdir)/gtk/stock-icons/24/zoom-out.png                   \
 262         $(top_srcdir)/gtk/stock-icons/24/media-seek-forward-ltr.png     \
 263         $(top_srcdir)/gtk/stock-icons/24/media-seek-forward-rtl.png     \
 264         $(top_srcdir)/gtk/stock-icons/24/media-skip-forward-ltr.png     \
 265         $(top_srcdir)/gtk/stock-icons/24/media-skip-forward-rtl.png     \
 266         $(top_srcdir)/gtk/stock-icons/24/media-playback-pause.png       \
 267         $(top_srcdir)/gtk/stock-icons/24/media-playback-start-ltr.png   \
 268         $(top_srcdir)/gtk/stock-icons/24/media-playback-start-rtl.png   \
 269         $(top_srcdir)/gtk/stock-icons/24/media-seek-backward-ltr.png    \
 270         $(top_srcdir)/gtk/stock-icons/24/media-seek-backward-rtl.png    \
 271         $(top_srcdir)/gtk/stock-icons/24/media-record.png               \
 272         $(top_srcdir)/gtk/stock-icons/24/media-skip-backward-ltr.png    \
 273         $(top_srcdir)/gtk/stock-icons/24/media-skip-backward-rtl.png    \
 274         $(top_srcdir)/gtk/stock-icons/24/media-playback-stop.png        \
 275         $(top_srcdir)/gtk/stock-icons/24/view-fullscreen.png            \
 276         $(top_srcdir)/gtk/stock-icons/24/view-restore.png               \
 277         $(top_srcdir)/gtk/stock-icons/24/gtk-page-setup.png             \
 278         $(srcdir)/images/aboutdialog.png                                \
 279         $(srcdir)/images/accel-label.png                                \
 280         $(srcdir)/images/assistant.png                                  \
 281         $(srcdir)/images/button.png                                     \
 282         $(srcdir)/images/check-button.png                               \
 283         $(srcdir)/images/color-button.png                               \
 284         $(srcdir)/images/colorsel.png                                   \
 285         $(srcdir)/images/combo-box.png                                  \
 286         $(srcdir)/images/combo-box-entry.png                            \
 287         $(srcdir)/images/entry.png                                      \
 288         $(srcdir)/images/figure-hierarchical-drawing.png                \
 289         $(srcdir)/images/figure-windowed-label.png                      \
 290         $(srcdir)/images/file-button.png                                \
 291         $(srcdir)/images/filechooser.png                                \
 292         $(srcdir)/images/font-button.png                                \
 293         $(srcdir)/images/fontsel.png                                    \
 294         $(srcdir)/images/frame.png                                      \
 295         $(srcdir)/images/icon-view.png                                  \
 296         $(srcdir)/images/image.png                                      \
 297         $(srcdir)/images/label.png                                      \
 298         $(srcdir)/images/link-button.png                                \
 299         $(srcdir)/images/list-and-tree.png                              \
 300         $(srcdir)/images/menubar.png                                    \
 301         $(srcdir)/images/messagedialog.png                              \
 302         $(srcdir)/images/multiline-text.png                             \
 303         $(srcdir)/images/notebook.png                                   \
 304         $(srcdir)/images/panes.png                                      \
 305         $(srcdir)/images/pagesetupdialog.png                            \
 306         $(srcdir)/images/printdialog.png                                \
 307         $(srcdir)/images/progressbar.png                                \
 308         $(srcdir)/images/radio-group.png                                \
 309         $(srcdir)/images/recentchooserdialog.png                        \
 310         $(srcdir)/images/scales.png                                     \
 311         $(srcdir)/images/scrolledwindow.png                             \
 312         $(srcdir)/images/separator.png                                  \
 313         $(srcdir)/images/spinbutton.png                                 \
 314         $(srcdir)/images/spinner.png                                    \
 315         $(srcdir)/images/statusbar.png                                  \
 316         $(srcdir)/images/toggle-button.png                              \
 317         $(srcdir)/images/toolbar.png                                    \
 318         $(srcdir)/images/toolpalette.png                                \
 319         $(srcdir)/images/tree-view-coordinates.png                      \
 320         $(srcdir)/images/volumebutton.png                               \
 321         $(srcdir)/images/window.png                                     \
 322         $(srcdir)/images/layout-btlr.png                                \
 323         $(srcdir)/images/layout-btrl.png                                \
 324         $(srcdir)/images/layout-lrbt.png                                \
 325         $(srcdir)/images/layout-lrtb.png                                \
 326         $(srcdir)/images/layout-rlbt.png                                \
 327         $(srcdir)/images/layout-rltb.png                                \
 328         $(srcdir)/images/layout-tblr.png                                \
 329         $(srcdir)/images/layout-tbrl.png                                \
 330         $(srcdir)/images/window-default.png                             \
 331         $(srcdir)/images/hello-world.png                                \
 332         $(srcdir)/images/switch.png                                     \
 333         $(srcdir)/images/linear.png                                     \
 334         $(srcdir)/images/ease.png                                       \
 335         $(srcdir)/images/ease-in-out.png                                \
 336         $(srcdir)/images/ease-in.png                                    \
 337         $(srcdir)/images/ease-out.png                                   \
 338         $(srcdir)/images/gradient1.png                                  \
 339         $(srcdir)/images/gradient2.png                                  \
 340         $(srcdir)/images/gradient3.png                                  \
 341         $(srcdir)/images/gradient4.png                                  \
 342         $(srcdir)/images/border1.png                                    \
 343         $(srcdir)/images/border2.png                                    \
 344         $(srcdir)/images/border3.png                                    \
 345         $(srcdir)/images/slices.png                                     \
 346         $(srcdir)/images/checks.png                                     \
 347         $(srcdir)/images/options.png                                    \
 348         $(srcdir)/images/arrows.png                                     \
 349         $(srcdir)/images/expanders.png                                  \
 350         $(srcdir)/images/background.png                                 \
 351         $(srcdir)/images/frames.png                                     \
 352         $(srcdir)/images/frame-gap.png                                  \
 353         $(srcdir)/images/sliders.png                                    \
 354         $(srcdir)/images/focus.png                                      \
 355         $(srcdir)/images/handles.png                                    \
 356         $(srcdir)/images/extensions.png
 357
 358 # Extra options to supply to gtkdoc-fixref
 359 FIXXREF_OPTIONS=--extra-dir=../gdk/html \
 360         --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gobject \
 361         --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/glib \
 362         --extra-dir=$(ATK_PREFIX)/share/gtk-doc/html/atk \
 363         --extra-dir=$(PANGO_PREFIX)/share/gtk-doc/html/pango \
 364         --extra-dir=$(CAIRO_PREFIX)/share/gtk-doc/html/cairo
 365
 366 include $(top_srcdir)/gtk-doc.make
 367
 368 # Other files to distribute
 369 EXTRA_DIST += version.xml.in
 370
 371 ########################################################################
 372
 373 man_MANS =                              \
 374         gtk-query-immodules-3.0.1       \
 375         gtk-update-icon-cache-3.0.1     \
 376         gtk-builder-convert-3.0.1
 377
 378 if ENABLE_MAN
 379
 380 .xml.1:
 381         @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
 382
 383 dist-local-check-mans-enabled:
 384         if grep "Man generation disabled" $(man_MANS) >/dev/null; then $(RM) $(man_MANS); fi
 385
 386 else
 387
 388 $(man_MANS):
 389         echo Man generation disabled.  Creating dummy $@.  Configure with --enable-man to enable it.
 390         echo Man generation disabled.  Remove this file, configure with --enable-man, and rebuild > $@
 391
 392 dist-local-check-mans-enabled:
 393         echo "*** --enable-man must be used in order to make dist"
 394         false
 395
 396 endif
 397
 398 MAINTAINERCLEANFILES = $(man_MANS) $(BUILT_SOURCES)
 399
 400 EXTRA_DIST += $(man_MANS)
 401
 402 dist-hook-local: dist-local-check-mans-enabled gtk-docs-clean all-local
 403
 404 gtk-docs-clean: clean
 405         cd $(srcdir) && rm -rf xml html
 406
 407 -include $(top_srcdir)/git.mk