doc/reference/Makefile.am

   1 ## Process this file with automake to produce Makefile.in
   2
   3 # We require automake 1.6 at least.
   4 AUTOMAKE_OPTIONS = 1.6
   5
   6 # This is a blank Makefile.am for using gtk-doc.
   7 # Copy this to your project's API docs directory and modify the variables to
   8 # suit your project. See the GTK+ Makefiles in gtk+/docs/reference for examples
   9 # of using the various options.
  10
  11 # The name of the module, e.g. 'glib'.
  12 DOC_MODULE=$(PACKAGE)
  13
  14 # Uncomment for versioned docs and specify the version of the module, e.g. '2'.
  15 #DOC_MODULE_VERSION=2
  16
  17
  18 # The top-level SGML file. You can change this if you want to.
  19 DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
  20
  21 # Directories containing the source code, relative to $(srcdir).
  22 # gtk-doc will search all .c and .h files beneath these paths
  23 # for inline comments documenting functions and macros.
  24 # e.g. DOC_SOURCE_DIR=../../../gtk ../../../gdk
  25 DOC_SOURCE_DIR=../../lib ../../libextra
  26
  27 # Extra options to pass to gtkdoc-scangobj. Not normally needed.
  28 SCANGOBJ_OPTIONS=
  29
  30 # Extra options to supply to gtkdoc-scan.
  31 # e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED"
  32 SCAN_OPTIONS=--ignore-decorators=ASN1_API \
  33         --deprecated-guards=ASN1_DISABLE_DEPRECATED
  34
  35 # Extra options to supply to gtkdoc-mkdb.
  36 # e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml
  37 MKDB_OPTIONS=--sgml-mode --output-format=xml
  38
  39 # Extra options to supply to gtkdoc-mktmpl
  40 # e.g. MKTMPL_OPTIONS=--only-section-tmpl
  41 MKTMPL_OPTIONS=
  42
  43 # Extra options to supply to gtkdoc-mkhtml
  44 MKHTML_OPTIONS=
  45
  46 # Extra options to supply to gtkdoc-fixref. Not normally needed.
  47 # e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html
  48 FIXXREF_OPTIONS=
  49
  50 # Used for dependencies. The docs will be rebuilt if any of these change.
  51 # e.g. HFILE_GLOB=$(top_srcdir)/gtk/*.h
  52 # e.g. CFILE_GLOB=$(top_srcdir)/gtk/*.c
  53 HFILE_GLOB=$(top_srcdir)/lib/includes/gnutls/*.h \
  54         $(top_builddir)/lib/includes/gnutls/*.h \
  55         $(top_srcdir)/libextra/includes/gnutls/*.h
  56 CFILE_GLOB=$(top_srcdir)/lib/*.c \
  57         $(top_srcdir)/lib/x509/*.c \
  58         $(top_srcdir)/lib/openpgp/*.c \
  59         $(top_srcdir)/libextra/*.c \
  60         $(top_srcdir)/lib/minitasn1/*.c \
  61         $(top_srcdir)/libextra/*.c
  62
  63 # Extra header to include when scanning, which are not under DOC_SOURCE_DIR
  64 # e.g. EXTRA_HFILES=$(top_srcdir}/contrib/extra.h
  65 EXTRA_HFILES=
  66
  67 # Header files to ignore when scanning. Use base file name, no paths
  68 # e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
  69 IGNORE_HFILES=compat.h gnutlsxx.h
  70
  71 # cd lib/ && echo *.h | sed 's/crypto.h//'
  72 IGNORE_HFILES += auth_anon.h auth_cert.h auth_dh_common.h auth_psk.h    \
  73         auth_psk_passwd.h auth_srp.h auth_srp_passwd.h config.h         \
  74         debug.h ext_cert_type.h ext_max_record.h ext_oprfi.h    \
  75         ext_safe_renegotiation.h ext_server_name.h                      \
  76         ext_session_ticket.h ext_signature.h ext_srp.h                  \
  77         gnutls_algorithms.h gnutls_auth.h gnutls_buffers.h              \
  78         gnutls_cert.h gnutls_cipher.h gnutls_cipher_int.h               \
  79         gnutls_compress.h gnutls_constate.h gnutls_cryptodev.h          \
  80         gnutls_datum.h gnutls_db.h gnutls_dh.h gnutls_errors.h          \
  81         gnutls_extensions.h gnutls_global.h gnutls_handshake.h          \
  82         gnutls_hash_int.h gnutls_helper.h gnutls_int.h gnutls_kx.h      \
  83         gnutls_mem.h gnutls_mpi.h gnutls_num.h gnutls_pk.h              \
  84         gnutls_record.h gnutls_rsa_export.h gnutls_session_pack.h       \
  85         gnutls_sig.h gnutls_srp.h gnutls_state.h gnutls_str.h           \
  86         gnutls_supplemental.h gnutls_v2_compat.h gnutls_x509.h          \
  87         random.h x509_b64.h
  88
  89 # cd lib/gl/ && echo *.h
  90 IGNORE_HFILES += alignof.h alloca.h alloca.in.h arg-nonnull.h           \
  91         byteswap.in.h c-ctype.h close-hook.h errno.in.h float+.h        \
  92         float.in.h gettext.h minmax.h netdb.in.h printf-args.h          \
  93         printf-parse.h read-file.h size_max.h sockets.h stdbool.in.h    \
  94         stddef.in.h stdint.in.h stdio.h stdio-impl.h stdio.in.h         \
  95         stdlib.h stdlib.in.h string.h string.in.h strings.h             \
  96         strings.in.h str-two-way.h sys_socket.in.h sys_stat.in.h        \
  97         time.h time.in.h unistd.h unistd.in.h w32sock.h warn-on-use.h   \
  98         vasnprintf.h wchar.h wchar.in.h xsize.h
  99
 100 # cd lib/gl/sys/ && echo *.h
 101 IGNORE_HFILES += socket.h stat.h
 102
 103 # cd lib/minitasn1/ && echo *.h
 104 IGNORE_HFILES += element.h gstr.h int.h libtasn1.h parser_aux.h structure.h
 105
 106 # cd lib/opencdk/ && echo *.h
 107 IGNORE_HFILES += context.h filters.h keydb.h main.h opencdk.h packet.h  \
 108         stream.h types.h
 109
 110 # cd lib/openpgp/ && echo *.h
 111 IGNORE_HFILES += gnutls_openpgp.h openpgp_int.h
 112
 113 # cd lib/x509/ && echo *.h
 114 IGNORE_HFILES += common.h pbkdf2-sha1.h x509_int.h
 115
 116 # cd lib/gl/tests/ && echo *.h
 117 IGNORE_HFILES += arg-nonnull.h c++defs.h intprops.h macros.h            \
 118         signature.h warn-on-use.h verify.h zerosize-ptr.h
 119
 120 # cd libextra/ && echo *.h
 121 IGNORE_HFILES += config.h ext_inner_application.h openssl_compat.h
 122
 123 # cd libextra/gl/ && echo *.h
 124 IGNORE_HFILES += hmac.h md5.h memxor.h
 125
 126 # Images to copy into HTML directory.
 127 # e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
 128 HTML_IMAGES=
 129
 130 # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
 131 # e.g. content_files=running.sgml building.sgml changes-2.0.sgml
 132 content_files=
 133
 134 # SGML files where gtk-doc abbrevations (#GtkWidget) are expanded
 135 # These files must be listed here *and* in content_files
 136 # e.g. expand_content_files=running.sgml
 137 expand_content_files=
 138
 139 # CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
 140 # Only needed if you are using gtkdoc-scangobj to dynamically query widget
 141 # signals and properties.
 142 # e.g. GTKDOC_CFLAGS=-I$(top_srcdir) -I$(top_builddir) $(GTK_DEBUG_FLAGS)
 143 # e.g. GTKDOC_LIBS=$(top_builddir)/gtk/$(gtktargetlib)
 144 GTKDOC_CFLAGS=
 145 GTKDOC_LIBS=
 146
 147 # This includes the standard gtk-doc make rules, copied by gtkdocize.
 148 include $(top_srcdir)/gtk-doc.make
 149
 150 # Other files to distribute
 151 # e.g. EXTRA_DIST += version.xml.in
 152 EXTRA_DIST +=
 153
 154 # Files not to distribute
 155 # for --rebuild-types in $(SCAN_OPTIONS), e.g. $(DOC_MODULE).types
 156 # for --rebuild-sections in $(SCAN_OPTIONS) e.g. $(DOC_MODULE)-sections.txt
 157 #DISTCLEANFILES +=
 158
 159 # Comment this out if you want your docs-status tested during 'make check'
 160 if ENABLE_GTK_DOC
 161 #TESTS_ENVIRONMENT = cd $(srcsrc) &&
 162 #TESTS = $(GTKDOC_CHECK)
 163 endif