Review the documentation generation

This notably fixes "make distcheck".
This commit is contained in:
Pierre Pronchery 2022-04-30 02:10:37 +02:00
parent a79124b8d5
commit 375ef49946
4 changed files with 22 additions and 14 deletions

View File

@ -3,25 +3,32 @@
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
[
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY server "www.defora.org/doc/gtk-doc/html">
<!ENTITY title "DeforaOS CPP">
<!ENTITY version "0.0.1">
<!ENTITY % gtkdocentities SYSTEM "xml/gtkdocentities.ent">
%gtkdocentities;
<!ENTITY % configentities SYSTEM "config.ent">
%configentities;
]>
<book id="index">
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
<bookinfo>
<title>CPP Reference Manual</title>
<title>&vendor; &package; &title;</title>
<releaseinfo>
for CPP &version;.
for &vendor; &package; &version;.
The latest version of this documentation can be found on-line at
<ulink role="online-location" url="http://&server;/CPP/index.html">http://&server;/CPP/</ulink>.
<ulink role="online-location" url="https://&server;/&package;/">https://&server;/&package;/</ulink>.
</releaseinfo>
</bookinfo>
<chapter>
<title>&title;</title>
<title>&vendor; &package;</title>
<xi:include href="xml/CPP.xml"/>
</chapter>
<!-- enable this when you use gobject types
<chapter id="object-tree">
<title>Object Hierarchy</title>
<xi:include href="xml/tree_index.sgml"/>
</chapter>
-->
<index id="api-index-full">
<title>API Index</title>
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
@ -30,6 +37,7 @@
<title>Index of deprecated API</title>
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
</index>
<!-- enable this when you use gobject introspection annotations
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
-->
</book>

View File

@ -1,2 +1,2 @@
subdirs=tmpl
dist=Makefile,CPP-docs.xml
dist=Makefile,CPP-docs.xml,CPP-sections.txt,xml/gtkdocentities.ent

View File

@ -11,13 +11,13 @@ depends=gtkdoc.sh
[gtkdoc/html.stamp]
type=script
script=./gtkdoc.sh
depends=gtkdoc/CPP-docs.xml,$(OBJDIR)gtkdoc/xml.stamp,gtkdoc.sh
depends=gtkdoc/CPP-docs.xml,$(OBJDIR)gtkdoc/xml.stamp,gtkdoc/xml/gtkdocentities.ent,gtkdoc.sh,../config.ent,../config.sh
install=
[gtkdoc/tmpl.stamp]
type=script
script=./gtkdoc.sh
depends=$(OBJDIR)gtkdoc/CPP.types,gtkdoc/tmpl/cpp.sgml,gtkdoc.sh
depends=$(OBJDIR)gtkdoc/CPP.types,gtkdoc.sh,../config.sh
[gtkdoc/xml.stamp]
type=script

View File

@ -1,10 +1,10 @@
package=CPP
version=0.0.3
config=h,sh
config=ent,h,sh
subdirs=data,doc,include,src,tests
targets=tests
dist=Makefile,COPYING,config.h,config.sh
dist=Makefile,COPYING,config.ent,config.h,config.sh
#modes
[mode::debug]