1
- <!-- $Header: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v 1.46 2003/09/12 22:17:22 tgl Exp $ -->
1
+ <!-- $Header: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v 1.47 2003/11/24 19:08:01 petere Exp $ -->
2
2
3
3
<appendix id="docguide">
4
4
<title>Documentation</title>
86
86
<listitem>
87
87
<para>
88
88
This is the definition of DocBook itself. We currently use
89
- version 3.1 ; you cannot use later or earlier versions. Note
89
+ version 4.2 ; you cannot use later or earlier versions. Note
90
90
that there is also an <acronym>XML</acronym> version of DocBook
91
91
-- do not use that.
92
92
</para>
205
205
<listitem>
206
206
<para><filename>textproc/openjade</filename></para>
207
207
</listitem>
208
- <listitem>
209
- <para><filename>textproc/docbook-310</filename></para>
210
- </listitem>
211
208
<listitem>
212
209
<para><filename>textproc/iso8879</filename></para>
213
210
</listitem>
214
211
<listitem>
215
212
<para><filename>textproc/dsssl-docbook-modular</filename></para>
216
213
</listitem>
217
214
</itemizedlist>
215
+ Apparently, there is no port for the DocBook V4.2 SGML DTD
216
+ available right now. You will need to install it manually.
217
+ </para>
218
+
219
+ <para>
218
220
A number of things from <filename>/usr/ports/print</filename>
219
221
(<filename>tex</filename>, <filename>jadetex</filename>) might
220
222
also be of interest.
225
227
in <filename>/usr/local/share/sgml/catalog</filename>. Be sure to
226
228
have the following line in there:
227
229
<programlisting>
228
- CATALOG "/usr/local/share/sgml/docbook/3.1/catalog "
230
+ CATALOG "/usr/local/share/sgml/docbook/4.2/docbook.cat "
229
231
</programlisting>
230
232
If you do not want to edit the file you can also set the
231
233
environment variable <envar>SGML_CATALOG_FILES</envar> to a
@@ -331,20 +333,20 @@ CATALOG "dsssl/catalog"
331
333
<step>
332
334
<para>
333
335
Obtain the <ulink
334
- url="http://www.oasis-open .org/docbook/ sgml/3.1/docbk31 .zip">DocBook
335
- V3.1 </ulink> distribution.
336
+ url="http://www.docbook .org/sgml/4.2/docbook-4.2 .zip">DocBook
337
+ V4.2 </ulink> distribution.
336
338
</para>
337
339
</step>
338
340
339
341
<step>
340
342
<para>
341
343
Create the directory
342
- <filename>/usr/local/share/sgml/docbook31 </filename> and change
344
+ <filename>/usr/local/share/sgml/docbook-4.2 </filename> and change
343
345
to it. (The exact location is irrelevant, but this one is
344
346
reasonable within the layout we are following here.)
345
347
<screen>
346
- <prompt>$ </prompt><userinput>mkdir /usr/local/share/sgml/docbook31 </userinput>
347
- <prompt>$ </prompt><userinput>cd /usr/local/share/sgml/docbook31 </userinput>
348
+ <prompt>$ </prompt><userinput>mkdir /usr/local/share/sgml/docbook-4.2 </userinput>
349
+ <prompt>$ </prompt><userinput>cd /usr/local/share/sgml/docbook-4.2 </userinput>
348
350
</screen>
349
351
</para>
350
352
</step>
@@ -353,7 +355,7 @@ CATALOG "dsssl/catalog"
353
355
<para>
354
356
Unpack the archive.
355
357
<screen>
356
- <prompt>$ </prompt><userinput>unzip -a ...../docbk31 .zip</userinput>
358
+ <prompt>$ </prompt><userinput>unzip -a ...../docbook-4.2 .zip</userinput>
357
359
</screen>
358
360
(The archive will unpack its files into the current directory.)
359
361
</para>
@@ -366,7 +368,7 @@ CATALOG "dsssl/catalog"
366
368
you told jade during installation) and put a line like this
367
369
into it:
368
370
<programlisting>
369
- CATALOG "docbook31 /docbook.cat"
371
+ CATALOG "docbook-4.2 /docbook.cat"
370
372
</programlisting>
371
373
</para>
372
374
</step>
@@ -388,7 +390,7 @@ CATALOG "docbook31/docbook.cat"
388
390
character entities</ulink> archive, unpack it, and put the
389
391
files in the same directory you put the DocBook files in.
390
392
<screen>
391
- <prompt>$ </prompt><userinput>cd /usr/local/share/sgml/docbook31 </userinput>
393
+ <prompt>$ </prompt><userinput>cd /usr/local/share/sgml/docbook-4.2 </userinput>
392
394
<prompt>$ </prompt><userinput>unzip ...../ISOEnts.zip</userinput>
393
395
</screen>
394
396
</para>
@@ -504,15 +506,15 @@ CATALOG "docbook-dsssl--1.<replaceable>xx</>/catalog
504
506
<computeroutput>
505
507
checking for onsgmls... onsgmls
506
508
checking for openjade... openjade
507
- checking for DocBook V3.1 ... yes
509
+ checking for DocBook V4.2 ... yes
508
510
checking for DocBook stylesheets... /usr/lib/sgml/stylesheets/nwalsh-modular
509
511
checking for sgmlspl... sgmlspl
510
512
</computeroutput>
511
513
</screen>
512
514
If neither <filename>onsgmls</filename> nor
513
515
<filename>nsgmls</filename> were found then you will not see the
514
516
remaining 4 lines. <filename>nsgmls</filename> is part of the Jade
515
- package. If <quote>DocBook V3.1 </quote> was not found then you did
517
+ package. If <quote>DocBook V4.2 </quote> was not found then you did
516
518
not install the DocBook DTD kit in a place where jade can find it,
517
519
or you have not set up the catalog files correctly. See the
518
520
installation hints above. The DocBook stylesheets are looked for
@@ -1034,7 +1036,7 @@ End:
1034
1036
the first line look like this:
1035
1037
1036
1038
<programlisting>
1037
- <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook V3.1 //EN">
1039
+ <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook V4.2 //EN">
1038
1040
</programlisting>
1039
1041
1040
1042
This means that anything and everything that reads
0 commit comments