Switched to DocBook XML for the developers documentation:
2003-02-06 Sven Neumann <sven@gimp.org> Switched to DocBook XML for the developers documentation: * configure.in: check for gtk-doc >= 1.0. * tools/pdbgen/lib.pl: replace <, > and & in comments with their XML entities. * libgimp/gimpdrawable_pdb.c * libgimp/gimpgimprc_pdb.c * libgimp/gimppainttools_pdb.c * libgimp/gimpselection_pdb.c: regenerated. * libgimpbase/gimpsignal.c: did the same manually here. 2003-02-06 Sven Neumann <sven@gimp.org> * Makefile.am * README.gtkdoc * libgimp*/Makefile.am * libgimp*/libgimp-docs.sgml: changed to create DocBook XML instead of SGML. * libgimp*/version.xml.in: added new file used to include the GIMP version in the generated XML.
This commit is contained in:
Sven Neumann
committed by
Sven Neumann
Sven Neumann
parent
a4a27eca7e
commit
473e92571a
16
ChangeLog
16
ChangeLog
@ -1,3 +1,19 @@
|
|||||||
|
2003-02-06 Sven Neumann <sven@gimp.org>
|
||||||
|
|
||||||
|
Switched to DocBook XML for the developers documentation:
|
||||||
|
|
||||||
|
* configure.in: check for gtk-doc >= 1.0.
|
||||||
|
|
||||||
|
* tools/pdbgen/lib.pl: replace <, > and & in comments with their
|
||||||
|
XML entities.
|
||||||
|
|
||||||
|
* libgimp/gimpdrawable_pdb.c
|
||||||
|
* libgimp/gimpgimprc_pdb.c
|
||||||
|
* libgimp/gimppainttools_pdb.c
|
||||||
|
* libgimp/gimpselection_pdb.c: regenerated.
|
||||||
|
|
||||||
|
* libgimpbase/gimpsignal.c: did the same manually here.
|
||||||
|
|
||||||
2003-02-06 Sven Neumann <sven@gimp.org>
|
2003-02-06 Sven Neumann <sven@gimp.org>
|
||||||
|
|
||||||
* app/gui/image-menu.c (image_menu_entries): removed /Filters/Text
|
* app/gui/image-menu.c (image_menu_entries): removed /Filters/Text
|
||||||
|
|||||||
11
configure.in
11
configure.in
@ -17,7 +17,7 @@ AC_INIT(app/core/gimp.c)
|
|||||||
GLIB_REQUIRED_VERSION=2.0.0
|
GLIB_REQUIRED_VERSION=2.0.0
|
||||||
GTK_REQUIRED_VERSION=$GLIB_REQUIRED_VERSION
|
GTK_REQUIRED_VERSION=$GLIB_REQUIRED_VERSION
|
||||||
PANGOFT2_REQUIRED_VERSION=1.0.0
|
PANGOFT2_REQUIRED_VERSION=1.0.0
|
||||||
GTKDOC_REQUIRED_VERSION=0.9
|
GTKDOC_REQUIRED_VERSION=1.0
|
||||||
GTKHTML2_REQUIRED_VERSION=1.99.5
|
GTKHTML2_REQUIRED_VERSION=1.99.5
|
||||||
GIMPPRINT_REQUIRED_VERSION=4.2.0
|
GIMPPRINT_REQUIRED_VERSION=4.2.0
|
||||||
|
|
||||||
@ -1029,9 +1029,6 @@ if $GTKDOC ; then
|
|||||||
fi
|
fi
|
||||||
fi
|
fi
|
||||||
|
|
||||||
AC_CHECK_PROG(DB2HTML, db2html, true, false)
|
|
||||||
AM_CONDITIONAL(HAVE_DOCBOOK, $DB2HTML)
|
|
||||||
|
|
||||||
dnl Make people enable the gtk-doc stuff explicitely.
|
dnl Make people enable the gtk-doc stuff explicitely.
|
||||||
AC_ARG_ENABLE(gtk-doc, [ --enable-gtk-doc use gtk-doc to build documentation [default=no]], enable_gtk_doc="$enableval", enable_gtk_doc=auto)
|
AC_ARG_ENABLE(gtk-doc, [ --enable-gtk-doc use gtk-doc to build documentation [default=no]], enable_gtk_doc="$enableval", enable_gtk_doc=auto)
|
||||||
|
|
||||||
@ -1205,11 +1202,17 @@ plug-ins/tools/Makefile
|
|||||||
modules/Makefile
|
modules/Makefile
|
||||||
devel-docs/Makefile
|
devel-docs/Makefile
|
||||||
devel-docs/libgimp/Makefile
|
devel-docs/libgimp/Makefile
|
||||||
|
devel-docs/libgimp/version.xml
|
||||||
devel-docs/libgimpbase/Makefile
|
devel-docs/libgimpbase/Makefile
|
||||||
|
devel-docs/libgimpbase/version.xml
|
||||||
devel-docs/libgimpcolor/Makefile
|
devel-docs/libgimpcolor/Makefile
|
||||||
|
devel-docs/libgimpcolor/version.xml
|
||||||
devel-docs/libgimpmath/Makefile
|
devel-docs/libgimpmath/Makefile
|
||||||
|
devel-docs/libgimpmath/version.xml
|
||||||
devel-docs/libgimpmodule/Makefile
|
devel-docs/libgimpmodule/Makefile
|
||||||
|
devel-docs/libgimpmodule/version.xml
|
||||||
devel-docs/libgimpwidgets/Makefile
|
devel-docs/libgimpwidgets/Makefile
|
||||||
|
devel-docs/libgimpwidgets/version.xml
|
||||||
docs/Makefile
|
docs/Makefile
|
||||||
docs/gimp-1.3.1
|
docs/gimp-1.3.1
|
||||||
docs/gimprc-1.3.5
|
docs/gimprc-1.3.5
|
||||||
|
|||||||
@ -1,3 +1,18 @@
|
|||||||
|
2003-02-06 Sven Neumann <sven@gimp.org>
|
||||||
|
|
||||||
|
* Makefile.am
|
||||||
|
* README.gtkdoc
|
||||||
|
* libgimp*/Makefile.am
|
||||||
|
* libgimp*/libgimp-docs.sgml: changed to create DocBook XML
|
||||||
|
instead of SGML.
|
||||||
|
|
||||||
|
* libgimp*/version.xml.in: added new file used to include the GIMP
|
||||||
|
version in the generated XML.
|
||||||
|
|
||||||
|
* libgimpwidgets/tmpl/gimpdialog.sgml
|
||||||
|
* libgimpwidgets/tmpl/gimpunitmenu.sgml
|
||||||
|
* libgimpwidgets/tmpl/gimpwidgets.sgml: fixed broken syntax.
|
||||||
|
|
||||||
2003-02-06 Sven Neumann <sven@gimp.org>
|
2003-02-06 Sven Neumann <sven@gimp.org>
|
||||||
|
|
||||||
* libgimpbase/tmpl/gimputils.sgml
|
* libgimpbase/tmpl/gimputils.sgml
|
||||||
|
|||||||
@ -1,9 +1,9 @@
|
|||||||
## Process this file with automake to produce Makefile.in
|
## Process this file with automake to produce Makefile.in
|
||||||
|
|
||||||
SUBDIRS = \
|
SUBDIRS = \
|
||||||
|
libgimpbase \
|
||||||
libgimpcolor \
|
libgimpcolor \
|
||||||
libgimpmath \
|
libgimpmath \
|
||||||
libgimpbase \
|
|
||||||
libgimpmodule \
|
libgimpmodule \
|
||||||
libgimpwidgets \
|
libgimpwidgets \
|
||||||
libgimp
|
libgimp
|
||||||
|
|||||||
@ -1,75 +1,75 @@
|
|||||||
Developers documentation using gtk-doc
|
Developers documentation using gtk-doc
|
||||||
--------------------------------------
|
--------------------------------------
|
||||||
|
|
||||||
The goal is to provide useful source documentation. Right now this is limited
|
The goal is to provide useful source documentation. Right now this is
|
||||||
to libgimp since that is the part that is used by third-party coders (plug-in
|
limited to libgimp since that is the part that is used by third-party
|
||||||
developers). Other parts of the code may follow later, but not before libgimp
|
coders (plug-in developers). Other parts of the code may follow later,
|
||||||
is properly documented.
|
but not before libgimp is properly documented.
|
||||||
|
|
||||||
|
|
||||||
Principle
|
Principle
|
||||||
---------
|
---------
|
||||||
|
|
||||||
The documentation is extracted out of the source using gtk-doc. We use a
|
The documentation is extracted out of the source using gtk-doc. We use
|
||||||
combination of comment blocks embedded into the source and additional
|
a combination of comment blocks embedded into the source and
|
||||||
information added manually into the SGML files.
|
additional information added manually into SGML template files.
|
||||||
|
|
||||||
|
|
||||||
Requirements
|
Requirements
|
||||||
------------
|
------------
|
||||||
|
|
||||||
GIMP release tarballs contain a complete set of precompiled HTML files as well
|
GIMP release tarballs contain a complete set of precompiled HTML files
|
||||||
as SGML files to create other formats. You only need gtk-doc if you want to
|
as well as DocBook XML files to create other formats. You only need
|
||||||
work on the documentation itself. In that case you will need the following
|
gtk-doc if you want to work on the documentation itself. In that case
|
||||||
utilities:
|
you will need the following utilities:
|
||||||
|
|
||||||
Perl v5 - Most of the scripts used are written in Perl.
|
Perl v5 - Most of the scripts used are written in Perl.
|
||||||
|
|
||||||
DocBook DTD v3.0 - This is the DocBook SGML DTD.
|
DocBook DTD v3.0 - This is the DocBook SGML DTD.
|
||||||
http://www.ora.com/davenport
|
http://www.ora.com/davenport
|
||||||
|
|
||||||
Jade v1.1 - This is a DSSSL processor for converting SGML to various formats.
|
libxslt & libxml2 (version >= 2.3.6) - This is used to convert the
|
||||||
http://www.jclark.com/jade
|
XML templates to HTML.
|
||||||
|
http://xmlsoft.org/
|
||||||
|
|
||||||
Modular DocBook Stylesheets (v1.19+ should be OK) - This is the DSSSL code to
|
gtk-doc (version >= 1.0) - This package automatically generates DocBook
|
||||||
convert DocBook to HTML (and a few other formats). It's used together with
|
documentation from source and is able to convert it into HTML (and
|
||||||
jade.
|
other formats).
|
||||||
http://nwalsh.com/docbook/dsssl
|
|
||||||
|
|
||||||
gtk-doc - This package automatically generates DocBook documentation for GTK+
|
|
||||||
and converts the DocBook documentation into HTML (and other formats).
|
|
||||||
ftp://ftp.gtk.org/pub/gtk-doc/
|
ftp://ftp.gtk.org/pub/gtk-doc/
|
||||||
|
|
||||||
|
|
||||||
HOWTO
|
HOWTO
|
||||||
-----
|
-----
|
||||||
|
|
||||||
Carefully read the README that comes with gtk-doc. Then read it again! The
|
Carefully read the README that comes with gtk-doc. Then read it again!
|
||||||
following lines will only give you hints about how our system works. You
|
The following lines will only give you hints about how our system
|
||||||
should have understood the principles of gtk-doc before you touch it.
|
works. You should have understood the principles of gtk-doc before you
|
||||||
|
touch it.
|
||||||
|
|
||||||
The system is already set up, so unless there are substantial changes to the
|
The system is already set up, so unless there are substantial changes
|
||||||
source e.g. new files were added, functions were added, renamed or removed or
|
to the source e.g. new files were added, functions were added, renamed
|
||||||
parameters changed, there is no need to touch the Makefile or any other files
|
or removed or parameters changed, there is no need to touch the
|
||||||
in the toplevel directory.
|
Makefile or any other files in the toplevel directory.
|
||||||
|
|
||||||
In most cases you will work on the documentation by adding or editing comment
|
In most cases you will work on the documentation by adding or editing
|
||||||
blocks in the C source and by editing the template SGML files in the tmpl
|
comment blocks in the C source and by editing the template SGML files
|
||||||
directory.
|
in the tmpl directory.
|
||||||
|
|
||||||
After you've done any changes to the documentation, running 'make' should
|
After you've done any changes to the documentation, running 'make'
|
||||||
rebuild the documentation. This will however only work if configure was called
|
should rebuild the documentation. This will however only work if
|
||||||
with the option '--enable-gtk-doc' and gtk-doc was successfully found. If
|
configure was called with the option '--enable-gtk-doc' and gtk-doc
|
||||||
everything was set up correctly, running 'make' should do the trick and
|
was successfully found. If everything was set up correctly, running
|
||||||
generate the SGML and HTML files for you. Since the dependencies are not
|
'make' should do the trick and generate the XML and HTML files for
|
||||||
perfect, you sometimes need to call 'make clean; make' to force regeneration.
|
you. Since the dependencies are not perfect, you sometimes need to
|
||||||
|
call 'make clean; make' to force regeneration.
|
||||||
|
|
||||||
|
|
||||||
More information
|
More information
|
||||||
----------------
|
----------------
|
||||||
|
|
||||||
Using the system as described above, you can write documentation without any
|
Using the system as described above, you can write documentation
|
||||||
knowledge of SGML and DocBook, but when editing the templates you will
|
without any knowledge of DocBook XML, but when editing the templates
|
||||||
sometimes want to do a little extra structuring or markup. The best source for
|
you will sometimes want to do a little extra structuring or
|
||||||
information about DocBook seems to be "DocBook: The Definitive Guide" which is
|
markup. The best source for information about DocBook seems to be
|
||||||
available online at http://www.docbook.org/tdg/html/.
|
"DocBook: The Definitive Guide" which is available online at
|
||||||
|
http://www.docbook.org/tdg/html/.
|
||||||
|
|||||||
@ -9,5 +9,6 @@ libgimp-decl-list.txt
|
|||||||
libgimp-unused.txt
|
libgimp-unused.txt
|
||||||
libgimp-undocumented.txt
|
libgimp-undocumented.txt
|
||||||
html
|
html
|
||||||
sgml
|
xml
|
||||||
|
version.xml
|
||||||
*.stamp
|
*.stamp
|
||||||
|
|||||||
@ -16,7 +16,7 @@ SCANGOBJ_OPTIONS =
|
|||||||
SCAN_OPTIONS =
|
SCAN_OPTIONS =
|
||||||
|
|
||||||
# Extra options to supply to gtkdoc-mkdb
|
# Extra options to supply to gtkdoc-mkdb
|
||||||
MKDB_OPTIONS =
|
MKDB_OPTIONS = --sgml-mode --output-format=xml
|
||||||
|
|
||||||
# Extra options to supply to gtkdoc-fixref
|
# Extra options to supply to gtkdoc-fixref
|
||||||
FIXXREF_OPTIONS = --extra-dir=../libgimpbase/html --extra-dir=../libgimpcolor/html --extra-dir=../libgimpmath/html --extra-dir=../libgimpwidgets/html
|
FIXXREF_OPTIONS = --extra-dir=../libgimpbase/html --extra-dir=../libgimpcolor/html --extra-dir=../libgimpmath/html --extra-dir=../libgimpwidgets/html
|
||||||
@ -73,7 +73,7 @@ EXTRA_DIST = \
|
|||||||
$(DOC_MODULE).types \
|
$(DOC_MODULE).types \
|
||||||
$(DOC_MODULE)-sections.txt
|
$(DOC_MODULE)-sections.txt
|
||||||
|
|
||||||
DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \
|
DOC_STAMPS=scan-build.stamp tmpl-build.stamp xml-build.stamp html-build.stamp \
|
||||||
$(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp
|
$(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp
|
||||||
|
|
||||||
SCANOBJ_FILES = \
|
SCANOBJ_FILES = \
|
||||||
@ -113,15 +113,15 @@ tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections
|
|||||||
tmpl.stamp: tmpl-build.stamp
|
tmpl.stamp: tmpl-build.stamp
|
||||||
@true
|
@true
|
||||||
|
|
||||||
#### sgml ####
|
#### xml ####
|
||||||
|
|
||||||
sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml
|
xml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml
|
||||||
@echo '*** Building SGML ***'
|
@echo '*** Building XML ***'
|
||||||
cd $(srcdir) && \
|
cd $(srcdir) && \
|
||||||
gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS)
|
gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS)
|
||||||
touch sgml-build.stamp
|
touch xml-build.stamp
|
||||||
|
|
||||||
sgml.stamp: sgml-build.stamp
|
sgml.stamp: xml-build.stamp
|
||||||
@true
|
@true
|
||||||
|
|
||||||
#### html ####
|
#### html ####
|
||||||
@ -145,7 +145,7 @@ clean-local:
|
|||||||
rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS)
|
rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS)
|
||||||
|
|
||||||
maintainer-clean-local: clean
|
maintainer-clean-local: clean
|
||||||
cd $(srcdir) && rm -rf sgml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
|
cd $(srcdir) && rm -rf xml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
|
||||||
|
|
||||||
install-data-local:
|
install-data-local:
|
||||||
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
|
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
|
||||||
@ -182,10 +182,10 @@ endif
|
|||||||
|
|
||||||
dist-hook: dist-check-gtkdoc dist-hook-local
|
dist-hook: dist-check-gtkdoc dist-hook-local
|
||||||
mkdir $(distdir)/tmpl
|
mkdir $(distdir)/tmpl
|
||||||
mkdir $(distdir)/sgml
|
mkdir $(distdir)/xml
|
||||||
mkdir $(distdir)/html
|
mkdir $(distdir)/html
|
||||||
-cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
|
-cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
|
||||||
-cp $(srcdir)/sgml/*.sgml $(distdir)/sgml
|
-cp $(srcdir)/xml/*.xml $(distdir)/xml
|
||||||
-cp $(srcdir)/html/* $(distdir)/html
|
-cp $(srcdir)/html/* $(distdir)/html
|
||||||
|
|
||||||
.PHONY : dist-hook-local
|
.PHONY : dist-hook-local
|
||||||
|
|||||||
@ -1,40 +1,45 @@
|
|||||||
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
|
<?xml version="1.0"?>
|
||||||
<!entity Gimp SYSTEM "sgml/gimp.sgml">
|
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
|
||||||
<!entity GimpBrushes SYSTEM "sgml/gimpbrushes.sgml">
|
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
|
||||||
<!entity GimpChannel SYSTEM "sgml/gimpchannel.sgml">
|
<!ENTITY Gimp SYSTEM "xml/gimp.xml">
|
||||||
<!entity GimpColor SYSTEM "sgml/gimpcolor.sgml">
|
<!ENTITY GimpBrushes SYSTEM "xml/gimpbrushes.xml">
|
||||||
<!entity GimpConvert SYSTEM "sgml/gimpconvert.sgml">
|
<!ENTITY GimpChannel SYSTEM "xml/gimpchannel.xml">
|
||||||
<!entity GimpDisplay SYSTEM "sgml/gimpdisplay.sgml">
|
<!ENTITY GimpColor SYSTEM "xml/gimpcolor.xml">
|
||||||
<!entity GimpDrawable SYSTEM "sgml/gimpdrawable.sgml">
|
<!ENTITY GimpConvert SYSTEM "xml/gimpconvert.xml">
|
||||||
<!entity GimpEdit SYSTEM "sgml/gimpedit.sgml">
|
<!ENTITY GimpDisplay SYSTEM "xml/gimpdisplay.xml">
|
||||||
<!entity GimpFileops SYSTEM "sgml/gimpfileops.sgml">
|
<!ENTITY GimpDrawable SYSTEM "xml/gimpdrawable.xml">
|
||||||
<!entity GimpFloatingsel SYSTEM "sgml/gimpfloatingsel.sgml">
|
<!ENTITY GimpEdit SYSTEM "xml/gimpedit.xml">
|
||||||
<!entity GimpGimprc SYSTEM "sgml/gimpgimprc.sgml">
|
<!ENTITY GimpFileops SYSTEM "xml/gimpfileops.xml">
|
||||||
<!entity GimpGradients SYSTEM "sgml/gimpgradients.sgml">
|
<!ENTITY GimpFloatingsel SYSTEM "xml/gimpfloatingsel.xml">
|
||||||
<!entity GimpGuides SYSTEM "sgml/gimpguides.sgml">
|
<!ENTITY GimpGimprc SYSTEM "xml/gimpgimprc.xml">
|
||||||
<!entity GimpHelp SYSTEM "sgml/gimphelp.sgml">
|
<!ENTITY GimpGradients SYSTEM "xml/gimpgradients.xml">
|
||||||
<!entity GimpImage SYSTEM "sgml/gimpimage.sgml">
|
<!ENTITY GimpGuides SYSTEM "xml/gimpguides.xml">
|
||||||
<!entity GimpLayer SYSTEM "sgml/gimplayer.sgml">
|
<!ENTITY GimpHelp SYSTEM "xml/gimphelp.xml">
|
||||||
<!entity GimpMessage SYSTEM "sgml/gimpmessage.sgml">
|
<!ENTITY GimpImage SYSTEM "xml/gimpimage.xml">
|
||||||
<!entity GimpMisc SYSTEM "sgml/gimpmisc.sgml">
|
<!ENTITY GimpLayer SYSTEM "xml/gimplayer.xml">
|
||||||
<!entity GimpPalette SYSTEM "sgml/gimppalette.sgml">
|
<!ENTITY GimpMessage SYSTEM "xml/gimpmessage.xml">
|
||||||
<!entity GimpPatterns SYSTEM "sgml/gimppatterns.sgml">
|
<!ENTITY GimpMisc SYSTEM "xml/gimpmisc.xml">
|
||||||
<!entity GimpPixelrgn SYSTEM "sgml/gimppixelrgn.sgml">
|
<!ENTITY GimpPalette SYSTEM "xml/gimppalette.xml">
|
||||||
<!entity GimpPlugin SYSTEM "sgml/gimpplugin.sgml">
|
<!ENTITY GimpPatterns SYSTEM "xml/gimppatterns.xml">
|
||||||
<!entity GimpProceduraldb SYSTEM "sgml/gimpproceduraldb.sgml">
|
<!ENTITY GimpPixelrgn SYSTEM "xml/gimppixelrgn.xml">
|
||||||
<!entity GimpSelection SYSTEM "sgml/gimpselection.sgml">
|
<!ENTITY GimpPlugin SYSTEM "xml/gimpplugin.xml">
|
||||||
<!entity GimpTexttool SYSTEM "sgml/gimptexttool.sgml">
|
<!ENTITY GimpProceduraldb SYSTEM "xml/gimpproceduraldb.xml">
|
||||||
<!entity GimpTile SYSTEM "sgml/gimptile.sgml">
|
<!ENTITY GimpSelection SYSTEM "xml/gimpselection.xml">
|
||||||
<!entity GimpTools SYSTEM "sgml/gimptools.sgml">
|
<!ENTITY GimpTexttool SYSTEM "xml/gimptexttool.xml">
|
||||||
<!entity GimpUndo SYSTEM "sgml/gimpundo.sgml">
|
<!ENTITY GimpTile SYSTEM "xml/gimptile.xml">
|
||||||
<!entity GimpEnums SYSTEM "sgml/gimpenums.sgml">
|
<!ENTITY GimpTools SYSTEM "xml/gimptools.xml">
|
||||||
<!entity GimpExport SYSTEM "sgml/gimpexport.sgml">
|
<!ENTITY GimpUndo SYSTEM "xml/gimpundo.xml">
|
||||||
<!entity GimpMenu SYSTEM "sgml/gimpmenu.sgml">
|
<!ENTITY GimpEnums SYSTEM "xml/gimpenums.xml">
|
||||||
<!entity GimpUI SYSTEM "sgml/gimpui.sgml">
|
<!ENTITY GimpExport SYSTEM "xml/gimpexport.xml">
|
||||||
|
<!ENTITY GimpMenu SYSTEM "xml/gimpmenu.xml">
|
||||||
|
<!ENTITY GimpUI SYSTEM "xml/gimpui.xml">
|
||||||
|
<!ENTITY version SYSTEM "version.xml">
|
||||||
]>
|
]>
|
||||||
|
|
||||||
<book id="index">
|
<book id="index">
|
||||||
<bookinfo>
|
<bookinfo>
|
||||||
<title>GIMP Library Reference Manual</title>
|
<title>GIMP Library Reference Manual</title>
|
||||||
|
<releaseinfo>for GIMP &version;</releaseinfo>
|
||||||
</bookinfo>
|
</bookinfo>
|
||||||
|
|
||||||
<chapter id="gimpdefinitions">
|
<chapter id="gimpdefinitions">
|
||||||
|
|||||||
1
devel-docs/libgimp/version.xml.in
Normal file
1
devel-docs/libgimp/version.xml.in
Normal file
@ -0,0 +1 @@
|
|||||||
|
@GIMP_VERSION@
|
||||||
@ -9,5 +9,6 @@ libgimpbase-decl-list.txt
|
|||||||
libgimpbase-unused.txt
|
libgimpbase-unused.txt
|
||||||
libgimpbase-undocumented.txt
|
libgimpbase-undocumented.txt
|
||||||
html
|
html
|
||||||
sgml
|
xml
|
||||||
|
version.xml
|
||||||
*.stamp
|
*.stamp
|
||||||
|
|||||||
@ -16,7 +16,7 @@ SCANGOBJ_OPTIONS =
|
|||||||
SCAN_OPTIONS =
|
SCAN_OPTIONS =
|
||||||
|
|
||||||
# Extra options to supply to gtkdoc-mkdb
|
# Extra options to supply to gtkdoc-mkdb
|
||||||
MKDB_OPTIONS =
|
MKDB_OPTIONS = --sgml-mode --output-format=xml
|
||||||
|
|
||||||
# Extra options to supply to gtkdoc-fixref
|
# Extra options to supply to gtkdoc-fixref
|
||||||
FIXXREF_OPTIONS =
|
FIXXREF_OPTIONS =
|
||||||
@ -67,7 +67,7 @@ EXTRA_DIST = \
|
|||||||
$(DOC_MODULE).types \
|
$(DOC_MODULE).types \
|
||||||
$(DOC_MODULE)-sections.txt
|
$(DOC_MODULE)-sections.txt
|
||||||
|
|
||||||
DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \
|
DOC_STAMPS=scan-build.stamp tmpl-build.stamp xml-build.stamp html-build.stamp \
|
||||||
$(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp
|
$(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp
|
||||||
|
|
||||||
SCANOBJ_FILES = \
|
SCANOBJ_FILES = \
|
||||||
@ -107,15 +107,15 @@ tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections
|
|||||||
tmpl.stamp: tmpl-build.stamp
|
tmpl.stamp: tmpl-build.stamp
|
||||||
@true
|
@true
|
||||||
|
|
||||||
#### sgml ####
|
#### xml ####
|
||||||
|
|
||||||
sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml
|
xml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml
|
||||||
@echo '*** Building SGML ***'
|
@echo '*** Building XML ***'
|
||||||
cd $(srcdir) && \
|
cd $(srcdir) && \
|
||||||
gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS)
|
gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS)
|
||||||
touch sgml-build.stamp
|
touch xml-build.stamp
|
||||||
|
|
||||||
sgml.stamp: sgml-build.stamp
|
sgml.stamp: xml-build.stamp
|
||||||
@true
|
@true
|
||||||
|
|
||||||
#### html ####
|
#### html ####
|
||||||
@ -139,7 +139,7 @@ clean-local:
|
|||||||
rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS)
|
rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS)
|
||||||
|
|
||||||
maintainer-clean-local: clean
|
maintainer-clean-local: clean
|
||||||
cd $(srcdir) && rm -rf sgml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
|
cd $(srcdir) && rm -rf xml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
|
||||||
|
|
||||||
install-data-local:
|
install-data-local:
|
||||||
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
|
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
|
||||||
@ -176,10 +176,10 @@ endif
|
|||||||
|
|
||||||
dist-hook: dist-check-gtkdoc dist-hook-local
|
dist-hook: dist-check-gtkdoc dist-hook-local
|
||||||
mkdir $(distdir)/tmpl
|
mkdir $(distdir)/tmpl
|
||||||
mkdir $(distdir)/sgml
|
mkdir $(distdir)/xml
|
||||||
mkdir $(distdir)/html
|
mkdir $(distdir)/html
|
||||||
-cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
|
-cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
|
||||||
-cp $(srcdir)/sgml/*.sgml $(distdir)/sgml
|
-cp $(srcdir)/xml/*.xml $(distdir)/xml
|
||||||
-cp $(srcdir)/html/* $(distdir)/html
|
-cp $(srcdir)/html/* $(distdir)/html
|
||||||
|
|
||||||
.PHONY : dist-hook-local
|
.PHONY : dist-hook-local
|
||||||
|
|||||||
@ -1,20 +1,25 @@
|
|||||||
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
|
<?xml version="1.0"?>
|
||||||
<!entity GimpBaseTypes SYSTEM "sgml/gimpbasetypes.sgml">
|
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
|
||||||
<!entity GimpLimits SYSTEM "sgml/gimplimits.sgml">
|
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
|
||||||
<!entity GimpDatafiles SYSTEM "sgml/gimpdatafiles.sgml">
|
<!ENTITY GimpBaseTypes SYSTEM "xml/gimpbasetypes.xml">
|
||||||
<!entity GimpEnv SYSTEM "sgml/gimpenv.sgml">
|
<!ENTITY GimpLimits SYSTEM "xml/gimplimits.xml">
|
||||||
<!entity GimpParasite SYSTEM "sgml/gimpparasite.sgml">
|
<!ENTITY GimpDatafiles SYSTEM "xml/gimpdatafiles.xml">
|
||||||
<!entity GimpParasiteIO SYSTEM "sgml/gimpparasiteio.sgml">
|
<!ENTITY GimpEnv SYSTEM "xml/gimpenv.xml">
|
||||||
<!entity GimpSignal SYSTEM "sgml/gimpsignal.sgml">
|
<!ENTITY GimpParasite SYSTEM "xml/gimpparasite.xml">
|
||||||
<!entity GimpUnit SYSTEM "sgml/gimpunit.sgml">
|
<!ENTITY GimpParasiteIO SYSTEM "xml/gimpparasiteio.xml">
|
||||||
<!entity GimpUtils SYSTEM "sgml/gimputils.sgml">
|
<!ENTITY GimpSignal SYSTEM "xml/gimpsignal.xml">
|
||||||
<!entity GimpVersion SYSTEM "sgml/gimpversion.sgml">
|
<!ENTITY GimpUnit SYSTEM "xml/gimpunit.xml">
|
||||||
<!entity GimpProtocol SYSTEM "sgml/gimpprotocol.sgml">
|
<!ENTITY GimpUtils SYSTEM "xml/gimputils.xml">
|
||||||
<!entity GimpWire SYSTEM "sgml/gimpwire.sgml">
|
<!ENTITY GimpVersion SYSTEM "xml/gimpversion.xml">
|
||||||
|
<!ENTITY GimpProtocol SYSTEM "xml/gimpprotocol.xml">
|
||||||
|
<!ENTITY GimpWire SYSTEM "xml/gimpwire.xml">
|
||||||
|
<!ENTITY version SYSTEM "version.xml">
|
||||||
]>
|
]>
|
||||||
|
|
||||||
<book id="index">
|
<book id="index">
|
||||||
<bookinfo>
|
<bookinfo>
|
||||||
<title>GIMP Base Library Reference Manual</title>
|
<title>GIMP Base Library Reference Manual</title>
|
||||||
|
<releaseinfo>for GIMP &version;</releaseinfo>
|
||||||
</bookinfo>
|
</bookinfo>
|
||||||
|
|
||||||
<chapter id="libgimpbase">
|
<chapter id="libgimpbase">
|
||||||
|
|||||||
1
devel-docs/libgimpbase/version.xml.in
Normal file
1
devel-docs/libgimpbase/version.xml.in
Normal file
@ -0,0 +1 @@
|
|||||||
|
@GIMP_VERSION@
|
||||||
Reference in New Issue
Block a user