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
2003-02-06 18:38:54 +00:00
committed by Sven Neumann
parent a4a27eca7e
commit 473e92571a
13 changed files with 163 additions and 115 deletions

View File

@ -9,5 +9,6 @@ libgimp-decl-list.txt
libgimp-unused.txt
libgimp-undocumented.txt
html
sgml
xml
version.xml
*.stamp

View File

@ -16,7 +16,7 @@ SCANGOBJ_OPTIONS =
SCAN_OPTIONS =
# Extra options to supply to gtkdoc-mkdb
MKDB_OPTIONS =
MKDB_OPTIONS = --sgml-mode --output-format=xml
# 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
@ -73,7 +73,7 @@ EXTRA_DIST = \
$(DOC_MODULE).types \
$(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
SCANOBJ_FILES = \
@ -113,15 +113,15 @@ tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections
tmpl.stamp: tmpl-build.stamp
@true
#### sgml ####
#### xml ####
sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml
@echo '*** Building SGML ***'
xml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml
@echo '*** Building XML ***'
cd $(srcdir) && \
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
#### html ####
@ -145,7 +145,7 @@ clean-local:
rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS)
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:
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
@ -182,10 +182,10 @@ endif
dist-hook: dist-check-gtkdoc dist-hook-local
mkdir $(distdir)/tmpl
mkdir $(distdir)/sgml
mkdir $(distdir)/xml
mkdir $(distdir)/html
-cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
-cp $(srcdir)/sgml/*.sgml $(distdir)/sgml
-cp $(srcdir)/xml/*.xml $(distdir)/xml
-cp $(srcdir)/html/* $(distdir)/html
.PHONY : dist-hook-local

View File

@ -1,40 +1,45 @@
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
<!entity Gimp SYSTEM "sgml/gimp.sgml">
<!entity GimpBrushes SYSTEM "sgml/gimpbrushes.sgml">
<!entity GimpChannel SYSTEM "sgml/gimpchannel.sgml">
<!entity GimpColor SYSTEM "sgml/gimpcolor.sgml">
<!entity GimpConvert SYSTEM "sgml/gimpconvert.sgml">
<!entity GimpDisplay SYSTEM "sgml/gimpdisplay.sgml">
<!entity GimpDrawable SYSTEM "sgml/gimpdrawable.sgml">
<!entity GimpEdit SYSTEM "sgml/gimpedit.sgml">
<!entity GimpFileops SYSTEM "sgml/gimpfileops.sgml">
<!entity GimpFloatingsel SYSTEM "sgml/gimpfloatingsel.sgml">
<!entity GimpGimprc SYSTEM "sgml/gimpgimprc.sgml">
<!entity GimpGradients SYSTEM "sgml/gimpgradients.sgml">
<!entity GimpGuides SYSTEM "sgml/gimpguides.sgml">
<!entity GimpHelp SYSTEM "sgml/gimphelp.sgml">
<!entity GimpImage SYSTEM "sgml/gimpimage.sgml">
<!entity GimpLayer SYSTEM "sgml/gimplayer.sgml">
<!entity GimpMessage SYSTEM "sgml/gimpmessage.sgml">
<!entity GimpMisc SYSTEM "sgml/gimpmisc.sgml">
<!entity GimpPalette SYSTEM "sgml/gimppalette.sgml">
<!entity GimpPatterns SYSTEM "sgml/gimppatterns.sgml">
<!entity GimpPixelrgn SYSTEM "sgml/gimppixelrgn.sgml">
<!entity GimpPlugin SYSTEM "sgml/gimpplugin.sgml">
<!entity GimpProceduraldb SYSTEM "sgml/gimpproceduraldb.sgml">
<!entity GimpSelection SYSTEM "sgml/gimpselection.sgml">
<!entity GimpTexttool SYSTEM "sgml/gimptexttool.sgml">
<!entity GimpTile SYSTEM "sgml/gimptile.sgml">
<!entity GimpTools SYSTEM "sgml/gimptools.sgml">
<!entity GimpUndo SYSTEM "sgml/gimpundo.sgml">
<!entity GimpEnums SYSTEM "sgml/gimpenums.sgml">
<!entity GimpExport SYSTEM "sgml/gimpexport.sgml">
<!entity GimpMenu SYSTEM "sgml/gimpmenu.sgml">
<!entity GimpUI SYSTEM "sgml/gimpui.sgml">
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY Gimp SYSTEM "xml/gimp.xml">
<!ENTITY GimpBrushes SYSTEM "xml/gimpbrushes.xml">
<!ENTITY GimpChannel SYSTEM "xml/gimpchannel.xml">
<!ENTITY GimpColor SYSTEM "xml/gimpcolor.xml">
<!ENTITY GimpConvert SYSTEM "xml/gimpconvert.xml">
<!ENTITY GimpDisplay SYSTEM "xml/gimpdisplay.xml">
<!ENTITY GimpDrawable SYSTEM "xml/gimpdrawable.xml">
<!ENTITY GimpEdit SYSTEM "xml/gimpedit.xml">
<!ENTITY GimpFileops SYSTEM "xml/gimpfileops.xml">
<!ENTITY GimpFloatingsel SYSTEM "xml/gimpfloatingsel.xml">
<!ENTITY GimpGimprc SYSTEM "xml/gimpgimprc.xml">
<!ENTITY GimpGradients SYSTEM "xml/gimpgradients.xml">
<!ENTITY GimpGuides SYSTEM "xml/gimpguides.xml">
<!ENTITY GimpHelp SYSTEM "xml/gimphelp.xml">
<!ENTITY GimpImage SYSTEM "xml/gimpimage.xml">
<!ENTITY GimpLayer SYSTEM "xml/gimplayer.xml">
<!ENTITY GimpMessage SYSTEM "xml/gimpmessage.xml">
<!ENTITY GimpMisc SYSTEM "xml/gimpmisc.xml">
<!ENTITY GimpPalette SYSTEM "xml/gimppalette.xml">
<!ENTITY GimpPatterns SYSTEM "xml/gimppatterns.xml">
<!ENTITY GimpPixelrgn SYSTEM "xml/gimppixelrgn.xml">
<!ENTITY GimpPlugin SYSTEM "xml/gimpplugin.xml">
<!ENTITY GimpProceduraldb SYSTEM "xml/gimpproceduraldb.xml">
<!ENTITY GimpSelection SYSTEM "xml/gimpselection.xml">
<!ENTITY GimpTexttool SYSTEM "xml/gimptexttool.xml">
<!ENTITY GimpTile SYSTEM "xml/gimptile.xml">
<!ENTITY GimpTools SYSTEM "xml/gimptools.xml">
<!ENTITY GimpUndo SYSTEM "xml/gimpundo.xml">
<!ENTITY GimpEnums SYSTEM "xml/gimpenums.xml">
<!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">
<bookinfo>
<title>GIMP Library Reference Manual</title>
<releaseinfo>for GIMP &version;</releaseinfo>
</bookinfo>
<chapter id="gimpdefinitions">

View File

@ -0,0 +1 @@
@GIMP_VERSION@