Re- set up the gtk-doc system. I'd managed to mutilate it a while back, but now it's fixed. I'll put a copy of the ...
Original commit message from CVS:
Re- set up the gtk-doc system. I'd managed to mutilate it a while back,
but now it's fixed. I'll put a copy of the HTML output somewhere on the
website tonight.
In order to actually generate the docs, you'll have to install all the
DocBook tools, as well as gtk-doc from GNOME cvs. (see
http://developer.gnome.org/arch/doc/tools.html)
Notes (I'll codify these some day):
- Don't believe the Gnome page, always edit the SOURCES when documenting a
given function, never the tmpl file.
- I'll be re-arranging things a lot, but gtk-doc is smart enough to merge
any changes to the tmpl file. However, gtk-doc's merge and CVS's diff are
two entirely separate animals. We should probably have a virtual mutex on
the entire docs/gst/ directory, over and above what CVS does.
- I'm going to try to end up with a book set (docbook terms), where
docs/gst/ is only one book. There'd be another called docs/manual/, and
another docs/plugins/, etc. If you have any comments as to how these
should be done, gstreamer-devel is the place.
2000-02-01 09:16:43 +00:00
|
|
|
## Process this file with automake to produce Makefile.in
|
|
|
|
|
|
2001-12-12 06:08:44 +00:00
|
|
|
# The name of the module, e.g. 'glib'.
|
2003-05-18 15:04:26 +00:00
|
|
|
# DOC_MODULE=gstreamer-@GST_MAJORMINOR@
|
Re- set up the gtk-doc system. I'd managed to mutilate it a while back, but now it's fixed. I'll put a copy of the ...
Original commit message from CVS:
Re- set up the gtk-doc system. I'd managed to mutilate it a while back,
but now it's fixed. I'll put a copy of the HTML output somewhere on the
website tonight.
In order to actually generate the docs, you'll have to install all the
DocBook tools, as well as gtk-doc from GNOME cvs. (see
http://developer.gnome.org/arch/doc/tools.html)
Notes (I'll codify these some day):
- Don't believe the Gnome page, always edit the SOURCES when documenting a
given function, never the tmpl file.
- I'll be re-arranging things a lot, but gtk-doc is smart enough to merge
any changes to the tmpl file. However, gtk-doc's merge and CVS's diff are
two entirely separate animals. We should probably have a virtual mutex on
the entire docs/gst/ directory, over and above what CVS does.
- I'm going to try to end up with a book set (docbook terms), where
docs/gst/ is only one book. There'd be another called docs/manual/, and
another docs/plugins/, etc. If you have any comments as to how these
should be done, gstreamer-devel is the place.
2000-02-01 09:16:43 +00:00
|
|
|
DOC_MODULE=gstreamer
|
|
|
|
|
|
2009-01-27 17:53:01 +00:00
|
|
|
# don't want $(DOC_MODULE)-scan.c to be built with -Werror
|
|
|
|
|
ERROR_CFLAGS=
|
|
|
|
|
|
2005-11-30 19:36:54 +00:00
|
|
|
BUILT_SOURCES=gstreamer.types
|
|
|
|
|
|
2009-06-11 12:16:29 +00:00
|
|
|
# for upload-doc.mak
|
2004-01-28 12:16:51 +00:00
|
|
|
DOC=gstreamer
|
|
|
|
|
FORMATS=html
|
|
|
|
|
html: html-build.stamp
|
2009-06-11 12:16:29 +00:00
|
|
|
include $(top_srcdir)/common/upload-doc.mak
|
2004-01-28 12:16:51 +00:00
|
|
|
|
2003-05-18 15:04:26 +00:00
|
|
|
# generated basefiles
|
|
|
|
|
#basefiles = \
|
|
|
|
|
# gstreamer-@GST_MAJORMINOR@.types \
|
|
|
|
|
# gstreamer-@GST_MAJORMINOR@-sections.txt \
|
|
|
|
|
# gstreamer-@GST_MAJORMINOR@-docs.sgml
|
|
|
|
|
|
|
|
|
|
# ugly hack to make -unused.sgml work
|
|
|
|
|
#unused-build.stamp:
|
|
|
|
|
# BUILDDIR=`pwd` && \
|
|
|
|
|
# cd $(srcdir)/tmpl && \
|
|
|
|
|
# ln -sf gstreamer-unused.sgml \
|
|
|
|
|
# $$BUILDDIR/tmpl/gstreamer-@GST_MAJORMINOR@-unused.sgml
|
|
|
|
|
# touch unused-build.stamp
|
|
|
|
|
|
|
|
|
|
# these rules are added to create parallel docs using GST_MAJORMINOR
|
|
|
|
|
#$(basefiles): gstreamer-@GST_MAJORMINOR@%: gstreamer%
|
|
|
|
|
# cp $< $@
|
|
|
|
|
|
2010-03-25 08:35:13 +00:00
|
|
|
#CLEANFILES += $(basefiles)
|
2003-05-18 15:04:26 +00:00
|
|
|
|
2001-12-12 06:08:44 +00:00
|
|
|
# The top-level SGML file. Change it if you want.
|
2001-01-01 14:06:25 +00:00
|
|
|
DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
|
Re- set up the gtk-doc system. I'd managed to mutilate it a while back, but now it's fixed. I'll put a copy of the ...
Original commit message from CVS:
Re- set up the gtk-doc system. I'd managed to mutilate it a while back,
but now it's fixed. I'll put a copy of the HTML output somewhere on the
website tonight.
In order to actually generate the docs, you'll have to install all the
DocBook tools, as well as gtk-doc from GNOME cvs. (see
http://developer.gnome.org/arch/doc/tools.html)
Notes (I'll codify these some day):
- Don't believe the Gnome page, always edit the SOURCES when documenting a
given function, never the tmpl file.
- I'll be re-arranging things a lot, but gtk-doc is smart enough to merge
any changes to the tmpl file. However, gtk-doc's merge and CVS's diff are
two entirely separate animals. We should probably have a virtual mutex on
the entire docs/gst/ directory, over and above what CVS does.
- I'm going to try to end up with a book set (docbook terms), where
docs/gst/ is only one book. There'd be another called docs/manual/, and
another docs/plugins/, etc. If you have any comments as to how these
should be done, gstreamer-devel is the place.
2000-02-01 09:16:43 +00:00
|
|
|
|
2007-08-10 17:35:30 +00:00
|
|
|
# The files containing the source code. Relative to $(top_srcdir).
|
|
|
|
|
# gtk-doc will search all .c & .h files beneath here for inline comments
|
|
|
|
|
# documenting functions and macros.
|
|
|
|
|
DOC_SOURCE_DIR = $(top_srcdir)/gst
|
|
|
|
|
DOC_BUILD_DIR = $(top_builddir)/gst
|
|
|
|
|
|
2001-12-12 06:08:44 +00:00
|
|
|
# Extra options to supply to gtkdoc-scan.
|
2005-01-21 17:52:50 +00:00
|
|
|
SCAN_OPTIONS=--deprecated-guards="GST_DISABLE_DEPRECATED"
|
2001-12-12 06:08:44 +00:00
|
|
|
|
|
|
|
|
# Extra options to supply to gtkdoc-mkdb.
|
2007-08-10 17:35:30 +00:00
|
|
|
MKDB_OPTIONS=--sgml-mode --output-format=xml --ignore-files=parse
|
2001-12-12 06:08:44 +00:00
|
|
|
|
|
|
|
|
# Extra options to supply to gtkdoc-fixref.
|
2007-07-05 08:42:42 +00:00
|
|
|
FIXXREF_OPTIONS=--extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html
|
2001-12-12 06:08:44 +00:00
|
|
|
|
2007-08-10 17:35:30 +00:00
|
|
|
# Used for dependencies.
|
|
|
|
|
HFILE_GLOB=$(DOC_SOURCE_DIR)/*.h
|
|
|
|
|
CFILE_GLOB=$(DOC_SOURCE_DIR)/*.c
|
2001-12-12 06:08:44 +00:00
|
|
|
|
2008-04-21 10:25:02 +00:00
|
|
|
SCANOBJ_DEPS =
|
2001-12-12 06:08:44 +00:00
|
|
|
|
2004-04-08 14:45:13 +00:00
|
|
|
# Header files to ignore when scanning. Use base file name, no paths
|
2004-03-30 07:36:19 +00:00
|
|
|
IGNORE_HFILES= \
|
|
|
|
|
gettext.h \
|
2007-08-10 17:35:30 +00:00
|
|
|
glib-compat-private.h \
|
|
|
|
|
glib-compat.h \
|
2004-03-30 07:36:19 +00:00
|
|
|
gst-i18n-app.h \
|
2007-08-10 17:35:30 +00:00
|
|
|
gst-i18n-lib.h \
|
2004-03-30 07:36:19 +00:00
|
|
|
gst_private.h \
|
2010-03-02 21:58:06 +00:00
|
|
|
gstelementdetails.h \
|
2004-04-08 15:14:27 +00:00
|
|
|
gstmarshal.h \
|
2005-09-20 06:28:33 +00:00
|
|
|
gstmacros.h \
|
2007-08-10 17:35:30 +00:00
|
|
|
\
|
|
|
|
|
grammar.tab.h \
|
|
|
|
|
grammar.tab.pre.h \
|
2010-10-05 13:16:19 +00:00
|
|
|
math-compat.h \
|
2007-08-10 17:35:30 +00:00
|
|
|
types.h
|
2001-12-12 06:08:44 +00:00
|
|
|
|
2010-03-25 08:35:13 +00:00
|
|
|
gst-universe.svg: gst-universe.dot
|
|
|
|
|
-dot -Tsvg $< | sed 's/\(font-size:[0-9]*\.[0-9]*\);/\1px;/g' >$@
|
|
|
|
|
|
2001-12-12 06:08:44 +00:00
|
|
|
# Images to copy into HTML directory.
|
|
|
|
|
HTML_IMAGES =
|
|
|
|
|
|
|
|
|
|
# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
|
2010-03-25 08:35:13 +00:00
|
|
|
content_files = building.xml running.xml gst-universe.svg
|
2001-12-12 06:08:44 +00:00
|
|
|
|
|
|
|
|
# Other files to distribute.
|
2010-03-25 08:35:13 +00:00
|
|
|
extra_files = gst-universe.dot
|
2001-12-12 06:08:44 +00:00
|
|
|
|
|
|
|
|
# CFLAGS and LDFLAGS for compiling scan program. Only needed if your app/lib
|
|
|
|
|
# contains GtkObjects/GObjects and you want to document signals and properties.
|
2005-10-15 13:58:18 +00:00
|
|
|
GTKDOC_CFLAGS = $(GST_OBJ_CFLAGS)
|
Merged in popt removal + GOption addition patch from Ronald, bug #169772.
Original commit message from CVS:
2005-10-10 Andy Wingo <wingo@pobox.com>
Merged in popt removal + GOption addition patch from Ronald, bug
#169772.
* docs/gst/gstreamer-sections.txt: Add STATE_(UN)LOCK_FULL, move
GstElement macros around, remove popt-related symbols, add goption
stuff.
* configure.ac: Remove popt checks, require GLib 2.6 for GOption.
* docs/gst/Makefile.am:
* docs/libs/Makefile.am: No POPT_CFLAGS.
* examples/manual/Makefile.am:
* docs/manual/basics-init.xml: Doc updates with an example.
* gst/gst.c: (gst_init_get_option_group), (gst_init_check),
(gst_init), (parse_one_option), (parse_goption_arg):
* gst/gst.h: Removed gst_init_with_popt_table and friends. Took a
bit of hand merging and debugging to get the GOption stuff working
tho.
* tests/Makefile.am:
* tools/Makefile.am:
* tools/gst-inspect.c: (main):
* tools/gst-launch.c: (main):
* tools/gst-run.c: (main):
* tools/gst-xmlinspect.c: (main): Thanks Ronald!
2005-10-10 15:53:59 +00:00
|
|
|
GTKDOC_LIBS = $(GST_OBJ_LIBS) $(SCANOBJ_DEPS)
|
2001-12-12 06:08:44 +00:00
|
|
|
|
2009-02-22 15:22:16 +00:00
|
|
|
GTKDOC_CC=$(LIBTOOL) --tag=CC --mode=compile $(CC)
|
|
|
|
|
GTKDOC_LD=$(LIBTOOL) --tag=CC --mode=link $(CC)
|
2001-12-12 06:08:44 +00:00
|
|
|
|
2009-11-17 09:06:48 +00:00
|
|
|
GTKDOC_EXTRA_ENVIRONMENT= \
|
2009-11-16 00:12:22 +00:00
|
|
|
GST_PLUGIN_SCANNER=$(top_builddir)/libs/gst/helpers/gst-plugin-scanner
|
2009-11-17 09:06:48 +00:00
|
|
|
|
2001-12-12 06:08:44 +00:00
|
|
|
# If you need to override some of the declarations, place them in this file
|
|
|
|
|
# and uncomment this line.
|
2005-03-29 14:12:48 +00:00
|
|
|
DOC_OVERRIDES = $(DOC_MODULE)-overrides.txt
|
2000-05-12 07:15:03 +00:00
|
|
|
|
2005-07-07 14:16:40 +00:00
|
|
|
include $(top_srcdir)/common/gtk-doc.mak
|
2010-03-25 08:35:13 +00:00
|
|
|
|
|
|
|
|
# gtk-doc.mak defines CLEANFILES
|
|
|
|
|
CLEANFILES += gst-universe.svg
|
|
|
|
|
|
