docs/Makefile.am

   1 REF_VERSION = $(PYGOBJECT_MAJOR_VERSION).$(PYGOBJECT_MINOR_VERSION)
   2 FULL_VERSION = $(REF_VERSION).$(PYGOBJECT_MICRO_VERSION)
   3
   4 BUILDDIR = $(top_builddir)/docs
   5
   6 CSS_FILES = style.css
   7
   8 HTML_FILES =                                    \
   9         html/class-gobjectgboxed.html           \
  10         html/class-gobjectginterface.html       \
  11         html/class-gobjectgpointer.html         \
  12         html/class-gobject.html                 \
  13         html/class-glibmaincontext.html         \
  14         html/class-glibmainloop.html            \
  15         html/glib-constants.html                \
  16         html/glib-functions.html                \
  17         html/gobject-class-reference.html       \
  18         html/glib-class-reference.html          \
  19         html/class-gioapplaunchcontext.html     \
  20         html/class-gioappinfo.html              \
  21         html/class-gioasyncresult.html          \
  22         html/class-giobufferedinputstream.html  \
  23         html/class-giobufferedoutputstream.html \
  24         html/class-giocancellable.html          \
  25         html/class-giodatainputstream.html      \
  26         html/class-giodataoutputstream.html     \
  27         html/class-giodrive.html                \
  28         html/class-gioemblem.html               \
  29         html/class-gioemblemedicon.html         \
  30         html/class-giofile.html                 \
  31         html/class-giofileattributeinfo.html    \
  32         html/class-giofileenumerator.html       \
  33         html/class-giofileicon.html             \
  34         html/class-giofileinfo.html             \
  35         html/class-giofileinputstream.html      \
  36         html/class-giofilemonitor.html          \
  37         html/class-giofileoutputstream.html     \
  38         html/class-giofilterinputstream.html    \
  39         html/class-giofilteroutputstream.html   \
  40         html/class-gioicon.html                 \
  41         html/class-gioinputstream.html          \
  42         html/class-gioloadableicon.html         \
  43         html/class-giomemoryinputstream.html    \
  44         html/class-giomemoryoutputstream.html   \
  45         html/class-giomount.html                \
  46         html/class-giomountoperation.html       \
  47         html/class-giooutputstream.html         \
  48         html/class-gioseekable.html             \
  49         html/class-giosimpleasyncresult.html    \
  50         html/class-giothemedicon.html           \
  51         html/class-giounixinputstream.html      \
  52         html/class-giounixoutputstream.html     \
  53         html/class-giovolume.html               \
  54         html/class-giovolumemonitor.html        \
  55         html/gio-constants.html                 \
  56         html/gio-functions.html                 \
  57         html/gio-class-reference.html           \
  58         html/giounix-class-reference.html       \
  59         html/gobject-constants.html             \
  60         html/gobject-functions.html             \
  61         html/index.html                         \
  62         html/index.sgml                         \
  63         html/pygobject.devhelp                  \
  64         html/pygobject-introduction.html
  65
  66
  67 XML_FILES =                                             \
  68         reference/pygobject.xml                         \
  69         reference/pygobject-introduction.xml            \
  70         reference/pygobject-classes.xml                 \
  71         reference/pygobject-constants.xml               \
  72         reference/pygobject-ref.xml                     \
  73         reference/pygobject-functions.xml               \
  74         reference/pygobject-gboxed.xml                  \
  75         reference/pygobject-ginterface.xml              \
  76         reference/pygobject-gpointer.xml                \
  77         reference/pyglib-classes.xml                    \
  78         reference/pyglib-constants.xml                  \
  79         reference/pyglib-functions.xml                  \
  80         reference/pyglib-maincontext.xml                \
  81         reference/pyglib-mainloop.xml                   \
  82         reference/pygio-classes.xml                     \
  83         reference/pygiounix-classes.xml                 \
  84         reference/pygio-constants.xml                   \
  85         reference/pygio-functions.xml                   \
  86         reference/pygio-applaunchcontext.xml            \
  87         reference/pygio-appinfo.xml                     \
  88         reference/pygio-asyncresult.xml                 \
  89         reference/pygio-bufferedinputstream.xml         \
  90         reference/pygio-bufferedoutputstream.xml        \
  91         reference/pygio-cancellable.xml                 \
  92         reference/pygio-datainputstream.xml             \
  93         reference/pygio-dataoutputstream.xml            \
  94         reference/pygio-drive.xml                       \
  95         reference/pygio-emblem.xml                      \
  96         reference/pygio-emblemedicon.xml                \
  97         reference/pygio-file.xml                        \
  98         reference/pygio-fileattributeinfo.xml           \
  99         reference/pygio-fileenumerator.xml              \
 100         reference/pygio-fileicon.xml                    \
 101         reference/pygio-fileinfo.xml                    \
 102         reference/pygio-fileinputstream.xml             \
 103         reference/pygio-filemonitor.xml                 \
 104         reference/pygio-fileoutputstream.xml            \
 105         reference/pygio-filterinputstream.xml           \
 106         reference/pygio-filteroutputstream.xml          \
 107         reference/pygio-icon.xml                        \
 108         reference/pygio-inputstream.xml                 \
 109         reference/pygio-loadableicon.xml                \
 110         reference/pygio-memoryinputstream.xml           \
 111         reference/pygio-memoryoutputstream.xml          \
 112         reference/pygio-mount.xml                       \
 113         reference/pygio-mountoperation.xml              \
 114         reference/pygio-outputstream.xml                \
 115         reference/pygio-seekable.xml                    \
 116         reference/pygio-simpleasyncresult.xml           \
 117         reference/pygio-themedicon.xml                  \
 118         reference/pygio-unixinputstream.xml             \
 119         reference/pygio-unixoutputstream.xml            \
 120         reference/pygio-volume.xml                      \
 121         reference/pygio-volumemonitor.xml
 122
 123 XSL_FILES =                     \
 124         xsl/common.xsl          \
 125         xsl/devhelp.xsl         \
 126         xsl/html.xsl            \
 127         xsl/pdf-style.xsl       \
 128         xsl/pdf.xsl             \
 129         xsl/ref-html-style.xsl
 130
 131 # fixxref cannot be included in XSL_FILES, because automake is touching it
 132 # so the date is newer then the files in HTML_FILES
 133 FIXXREF = xsl/fixxref.py
 134
 135 TARGET_DIR = $(datadir)/gtk-doc/html/pygobject
 136 CSSdir = $(TARGET_DIR)
 137 CSS_DATA = $(CSS_FILES)
 138
 139
 140 install-data-local:
 141         installfiles=`echo $(srcdir)/html/*`; \
 142         if test "$$installfiles" = '$(srcdir)/html/*'; \
 143         then echo '-- Nothing to install' ; \
 144         else \
 145           $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR); \
 146           for i in $$installfiles; do \
 147             echo '-- Installing '$$i ; \
 148             $(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \
 149           done; \
 150           echo '-- Installing $(srcdir)/html/index.sgml' ; \
 151           $(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR) || :; \
 152         fi
 153
 154 uninstall-local:
 155         rm -f $(DESTDIR)$(TARGET_DIR)/*
 156
 157
 158 XSLdir = $(datadir)/pygobject/xsl
 159 XSL_DATA = $(XSL_FILES) $(FIXXREF)
 160
 161 EXTRA_DIST =            \
 162         $(HTML_FILES)   \
 163         $(XML_FILES)    \
 164         $(XSL_FILES)    \
 165         $(FIXXREF)      \
 166         $(CSS_FILES)
 167
 168 reference/builddate.xml:
 169         @$(PYTHON) -c 'import datetime; print datetime.date.today()' > $@
 170
 171
 172 if ENABLE_DOCS
 173
 174 BUILT_SOURCES = reference/builddate.xml $(HTML_FILES)
 175 CLEANFILES = reference/builddate.xml $(HTML_FILES)
 176
 177
 178 # Do not add a builddate.xml dependency here, because the generated html
 179 # documentation will be included in the tarball so xsltproc is not needed to
 180 # install the documentation. Adding a builddate.xml dependency will force
 181 # the documentation to be rebuilt when it doesn't need to be.
 182 $(HTML_FILES): $(XML_FILES) $(XSL_FILES)
 183         @xsltproc --nonet --xinclude -o $(BUILDDIR)/html/ \
 184                  --path $(BUILDDIR)/reference:$(srcdir)/reference \
 185                  --stringparam gtkdoc.bookname "pygobject" \
 186                  --stringparam gtkdoc.version ${REF_VERSION} \
 187                  $(srcdir)/xsl/ref-html-style.xsl \
 188                  $(srcdir)/reference/pygobject-ref.xml
 189
 190 # pdf: $(REFERENCE_DEPS) reference/builddate.xml
 191 #       xsltproc --nonet --xinclude -o pygobject-ref.fo xsl/pdf-style.xsl \
 192 #               reference/pygobject-ref.xml
 193 #       pdfxmltex pygobject-ref.fo >output </dev/null
 194
 195 endif
 196
 197 -include $(top_srcdir)/git.mk