The construct:
<citerefentry>
<refentrytitle>foobar</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>
is a pain to type, and messes up the pretty-printing of the source code.
Replace every occurence of a entry like that with:
&man.foobar.1;
Adjusting the manual page name and section number appropriately.
The definitions for these entities are stored in man-refs.ent. This
file is in doc/share/sgml because it is not just specific to the Handbook.
I expect the DocBook'd FAQ and Tutorials (coming RSN) to use them as
well.
A new PUBLIC identifier has been created for these entities, and added to
the catalog file.
47 lines
1.3 KiB
Text
47 lines
1.3 KiB
Text
<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V3.0-Based Extension//EN" [
|
|
<!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
|
|
<!ENTITY % authors SYSTEM "authors.ent"> %authors;
|
|
<!ENTITY % mailing-lists SYSTEM "mailing-lists.ent"> %mailing-lists;
|
|
<!ENTITY % newsgroups SYSTEM "newsgroups.ent"> %newsgroups;
|
|
|
|
<!ENTITY % boothelp.only "INCLUDE">
|
|
<!ENTITY % handbook.only "IGNORE">
|
|
|
|
<!ENTITY rel.current CDATA "3.0">
|
|
]>
|
|
|
|
<book>
|
|
<bookinfo>
|
|
<title>FreeBSD Installation</title>
|
|
|
|
<abstract>
|
|
<para>Welcome to FreeBSD! This guide describes the FreeBSD installation
|
|
process. To navigate through through the section in this guide using
|
|
the <emphasis>up</emphasis> and <emphasis>down</emphasis> arrow keys
|
|
to select the section you wish to read. THen use the <emphasis>right
|
|
arrow</emphasis> or the <emphasis>enter key</emphasis> to view the
|
|
section. You can backtract through section you have read by using the
|
|
<emphasis>left arrow</emphasis>.</abstract>
|
|
</abstract>
|
|
</bookinfo>
|
|
|
|
<part>
|
|
<title>General information</title>
|
|
|
|
&chap.introduction;
|
|
&chap.install;
|
|
&chap.basics;
|
|
&chap.eresources;
|
|
&chap.hw;
|
|
&chap.contrib;
|
|
</part>
|
|
</book>
|
|
|
|
<!--
|
|
Local Variables:
|
|
mode: sgml
|
|
sgml-indent-data: t
|
|
sgml-omittag: nil
|
|
sgml-always-quote-attributes: t
|
|
End:
|
|
-->
|