[docs] xmldocs - docelic modified 6 files
docs at icdevgroup.org
docs at icdevgroup.org
Fri May 20 17:41:49 EDT 2005
User: docelic
Date: 2005-05-20 21:41:49 GMT
Modified: . README
Modified: docbook olinkdb-c.xml olinkdb-nc.xml
Modified: glossary feature
Modified: refs Catalog
Added: glossary special
Log:
More clean build
Revision Changes Path
1.14 +18 -0 xmldocs/README
rev 1.14, prev_rev 1.13
Index: README
===================================================================
RCS file: /var/cvs/xmldocs/README,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- README 17 Dec 2004 13:39:22 -0000 1.13
+++ README 20 May 2005 21:41:49 -0000 1.14
@@ -15,6 +15,24 @@
To build the complete documentation set, run:
make
+ ^
+** ^ -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- **
+** ^-- Well, not really ;-| I didn't manage to get this totally right,
+so the (complete) procedure to build the docs is:
+
+( cvs checkout first, then: )
+make cvs cache skel
+make refxmls
+make refxmls (yes, twice or trice)
+make olinkdbs-nc olinkdbs-c
+( and then the usual targets: )
+make pragmas vars tags confs filters iccattut programming-style howtos glossary
+
+Also the problem is that the whole thing takes enormous time to build, even
+with xsltproc which is like by far the fastest docbook processor ;-)
+But well, on a >2GHz machine, it's bearable.
+
+** -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- **
To build specific targets, see Makefile for target names. Few useful
targets would include:
1.11 +0 -7 xmldocs/docbook/olinkdb-c.xml
rev 1.11, prev_rev 1.10
Index: olinkdb-c.xml
===================================================================
RCS file: /var/cvs/xmldocs/docbook/olinkdb-c.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- olinkdb-c.xml 16 Feb 2005 17:59:33 -0000 1.10
+++ olinkdb-c.xml 20 May 2005 21:41:49 -0000 1.11
@@ -3,7 +3,6 @@
SYSTEM "/usr/share/xml/docbook/stylesheet/nwalsh/common/targetdatabase.dtd" [
<!ENTITY iccattut SYSTEM "../tmp/iccattut-c.db">
<!ENTITY upgrade SYSTEM "../tmp/upgrade-c.db">
- <!ENTITY xmldocs SYSTEM "../tmp/xmldocs-c.db">
<!ENTITY howtos SYSTEM "../tmp/howtos-c.db">
<!ENTITY glossary SYSTEM "../tmp/glossary-c.db">
<!ENTITY pragmas SYSTEM "../tmp/pragmas-c.db">
@@ -30,12 +29,6 @@
<dir name='upgrade'>
<document targetdoc="upgrade">
&upgrade;
- </document>
- </dir>
-
- <dir name='xmldocs'>
- <document targetdoc="xmldocs">
- &xmldocs;
</document>
</dir>
1.11 +0 -2 xmldocs/docbook/olinkdb-nc.xml
rev 1.11, prev_rev 1.10
Index: olinkdb-nc.xml
===================================================================
RCS file: /var/cvs/xmldocs/docbook/olinkdb-nc.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- olinkdb-nc.xml 16 Feb 2005 17:59:33 -0000 1.10
+++ olinkdb-nc.xml 20 May 2005 21:41:49 -0000 1.11
@@ -3,7 +3,6 @@
SYSTEM "/usr/share/xml/docbook/stylesheet/nwalsh/common/targetdatabase.dtd" [
<!ENTITY iccattut SYSTEM "../tmp/iccattut-nc.db">
<!ENTITY upgrade SYSTEM "../tmp/upgrade-nc.db">
- <!ENTITY xmldocs SYSTEM "../tmp/xmldocs-nc.db">
<!ENTITY howtos SYSTEM "../tmp/howtos-nc.db">
<!ENTITY glossary SYSTEM "../tmp/glossary-nc.db">
<!ENTITY pragmas SYSTEM "../tmp/pragmas-nc.db">
@@ -22,7 +21,6 @@
<dir name="OUTPUT">
<document targetdoc="iccattut" baseuri="iccattut.html"> &iccattut; </document>
<document targetdoc="upgrade" baseuri="upgrade.html"> &upgrade; </document>
- <document targetdoc="xmldocs" baseuri="xmldocs.html"> &xmldocs; </document>
<document targetdoc="howtos" baseuri="howtos.html"> &howtos; </document>
<document targetdoc="glossary" baseuri="glossary.html"> &glossary; </document>
<document targetdoc="pragmas" baseuri="pragmas.html"> &pragmas; </document>
1.2 +2 -2 xmldocs/glossary/feature
rev 1.2, prev_rev 1.1
Index: feature
===================================================================
RCS file: /var/cvs/xmldocs/glossary/feature,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- feature 20 May 2005 15:01:03 -0000 1.1
+++ feature 20 May 2005 21:41:49 -0000 1.2
@@ -37,9 +37,9 @@
All subdirectories contain files which are copied to the
catalog directory with the same relative path. In this
case,
-<filename>&ICROOT;/features/quickpoll/templates/components/quickpoll</filename>
+<filename>&glos-ICROOT;/features/quickpoll/templates/components/quickpoll</filename>
would go to
-<filename>&CATROOT;/templates/components/quickpoll</filename>.
+<filename>&glos-CATROOT;/templates/components/quickpoll</filename>.
</para><para>
The <literal>.init</literal> file, when run, sends its output to
<filename>&conf-ConfDir;/init/<replaceable>FEATURE</replaceable>/<replaceable>FEATURE</replaceable>.init</filename>
1.1 xmldocs/glossary/special
<<special: empty>>
1.3 +1 -1 xmldocs/refs/Catalog
rev 1.3, prev_rev 1.2
Index: Catalog
===================================================================
RCS file: /var/cvs/xmldocs/refs/Catalog,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- Catalog 20 Feb 2005 00:59:50 -0000 1.2
+++ Catalog 20 May 2005 21:41:49 -0000 1.3
@@ -89,7 +89,7 @@
__NAME__ example: Defining catalog-specific directives in the global config file
Re-using the elaborate example from just above, it is also possible to define
catalog-specific directives in the global &gcf; file.
-This is most useful to do with the &glos-ErrorFile; and &glos-DisplayErrors;
+This is most useful to do with the &conf-ErrorFile; and &conf-DisplayErrors;
directives:
<programlisting>
Catalog simple directive ErrorFile /var/log/interchange/simple-error.log
More information about the docs
mailing list