DTD for the FreeBSD Documentation Project.
Extends DocBook v3.0, with (currently) the following additions.
1. <hostid>, <username>, <devicename>, <makevar>, and <maketarget> have
been added. Sample uses would be be.
<para>By convention, the the local machine can always be referred
to as <hostid>localhost</hostid>, with the IP address
<hostid role="ipaddr">127.0.0.1</hostid>.</para>
<para>The most powerful account on the system is
<username>root</username>, able to leap tall buildings in a single
bound.</para>
<para>Some devices have an entry in <filename>/dev</filename>. For
example, <filename>/dev/cuaa0</filename> corresponds to
<devicename>sio0</devicename>. Other devices, such as
<devicename>ed0</devicename> do not have entries in
<filename>/dev</filename>.
<para>To rebuild the system, use the <maketarget>world</maketarget>
target. If you do not want to build profiled libraries then ensure
that <makevar>NOPROFILE</makevar> is set.</para>
2. <FAQList> has been added as a new list type, with its own listitem.
Use like so;
<FAQList>
<FAQListItem>
<FAQQuestion>
<para>I have bad blocks on my hard drive!</para>
<!-- Nothing restricting a question to one paragraph -->
</FAQQuestion>
<FAQAnswer>
<para>With SCSI drives, the drive should be capable…</para>
<para>…</para>
</FAQAnswer>
</FAQListItem>
</FAQList>
Long winded, but comprehensive, and in keeping with the rest of DocBook.
As I convert the handbook from LinuxDoc to DocBook I'm working on an
extensive markup guide for the project, where constructs like these will be
fully documented.
1998-06-29 10:08:52 +02:00
|
|
|
<!-- FreeBSD Documentation Project, Extended DocBook DTD
|
|
|
|
|
1999-06-03 21:37:49 +02:00
|
|
|
This DTD builds upon the DocBook 3.1 DTD. It extends it in order to
|
DTD for the FreeBSD Documentation Project.
Extends DocBook v3.0, with (currently) the following additions.
1. <hostid>, <username>, <devicename>, <makevar>, and <maketarget> have
been added. Sample uses would be be.
<para>By convention, the the local machine can always be referred
to as <hostid>localhost</hostid>, with the IP address
<hostid role="ipaddr">127.0.0.1</hostid>.</para>
<para>The most powerful account on the system is
<username>root</username>, able to leap tall buildings in a single
bound.</para>
<para>Some devices have an entry in <filename>/dev</filename>. For
example, <filename>/dev/cuaa0</filename> corresponds to
<devicename>sio0</devicename>. Other devices, such as
<devicename>ed0</devicename> do not have entries in
<filename>/dev</filename>.
<para>To rebuild the system, use the <maketarget>world</maketarget>
target. If you do not want to build profiled libraries then ensure
that <makevar>NOPROFILE</makevar> is set.</para>
2. <FAQList> has been added as a new list type, with its own listitem.
Use like so;
<FAQList>
<FAQListItem>
<FAQQuestion>
<para>I have bad blocks on my hard drive!</para>
<!-- Nothing restricting a question to one paragraph -->
</FAQQuestion>
<FAQAnswer>
<para>With SCSI drives, the drive should be capable…</para>
<para>…</para>
</FAQAnswer>
</FAQListItem>
</FAQList>
Long winded, but comprehensive, and in keeping with the rest of DocBook.
As I convert the handbook from LinuxDoc to DocBook I'm working on an
extensive markup guide for the project, where constructs like these will be
fully documented.
1998-06-29 10:08:52 +02:00
|
|
|
add some new elements.
|
|
|
|
|
|
|
|
The comment style and section headings are drawn from the DocBook DTD.
|
|
|
|
|
1999-06-03 21:37:49 +02:00
|
|
|
The FPI for this DTD is "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN"
|
DTD for the FreeBSD Documentation Project.
Extends DocBook v3.0, with (currently) the following additions.
1. <hostid>, <username>, <devicename>, <makevar>, and <maketarget> have
been added. Sample uses would be be.
<para>By convention, the the local machine can always be referred
to as <hostid>localhost</hostid>, with the IP address
<hostid role="ipaddr">127.0.0.1</hostid>.</para>
<para>The most powerful account on the system is
<username>root</username>, able to leap tall buildings in a single
bound.</para>
<para>Some devices have an entry in <filename>/dev</filename>. For
example, <filename>/dev/cuaa0</filename> corresponds to
<devicename>sio0</devicename>. Other devices, such as
<devicename>ed0</devicename> do not have entries in
<filename>/dev</filename>.
<para>To rebuild the system, use the <maketarget>world</maketarget>
target. If you do not want to build profiled libraries then ensure
that <makevar>NOPROFILE</makevar> is set.</para>
2. <FAQList> has been added as a new list type, with its own listitem.
Use like so;
<FAQList>
<FAQListItem>
<FAQQuestion>
<para>I have bad blocks on my hard drive!</para>
<!-- Nothing restricting a question to one paragraph -->
</FAQQuestion>
<FAQAnswer>
<para>With SCSI drives, the drive should be capable…</para>
<para>…</para>
</FAQAnswer>
</FAQListItem>
</FAQList>
Long winded, but comprehensive, and in keeping with the rest of DocBook.
As I convert the handbook from LinuxDoc to DocBook I'm working on an
extensive markup guide for the project, where constructs like these will be
fully documented.
1998-06-29 10:08:52 +02:00
|
|
|
|
2012-05-17 21:12:14 +02:00
|
|
|
$FreeBSD$
|
DTD for the FreeBSD Documentation Project.
Extends DocBook v3.0, with (currently) the following additions.
1. <hostid>, <username>, <devicename>, <makevar>, and <maketarget> have
been added. Sample uses would be be.
<para>By convention, the the local machine can always be referred
to as <hostid>localhost</hostid>, with the IP address
<hostid role="ipaddr">127.0.0.1</hostid>.</para>
<para>The most powerful account on the system is
<username>root</username>, able to leap tall buildings in a single
bound.</para>
<para>Some devices have an entry in <filename>/dev</filename>. For
example, <filename>/dev/cuaa0</filename> corresponds to
<devicename>sio0</devicename>. Other devices, such as
<devicename>ed0</devicename> do not have entries in
<filename>/dev</filename>.
<para>To rebuild the system, use the <maketarget>world</maketarget>
target. If you do not want to build profiled libraries then ensure
that <makevar>NOPROFILE</makevar> is set.</para>
2. <FAQList> has been added as a new list type, with its own listitem.
Use like so;
<FAQList>
<FAQListItem>
<FAQQuestion>
<para>I have bad blocks on my hard drive!</para>
<!-- Nothing restricting a question to one paragraph -->
</FAQQuestion>
<FAQAnswer>
<para>With SCSI drives, the drive should be capable…</para>
<para>…</para>
</FAQAnswer>
</FAQListItem>
</FAQList>
Long winded, but comprehensive, and in keeping with the rest of DocBook.
As I convert the handbook from LinuxDoc to DocBook I'm working on an
extensive markup guide for the project, where constructs like these will be
fully documented.
1998-06-29 10:08:52 +02:00
|
|
|
-->
|
|
|
|
|
1998-12-20 21:33:49 +01:00
|
|
|
<!-- ..................................................................... -->
|
|
|
|
<!-- Parameter entities .................................................. -->
|
|
|
|
|
2012-08-21 21:16:02 +02:00
|
|
|
<!-- These parameter entities have specific meanings, and default to
|
1998-12-20 21:33:49 +01:00
|
|
|
"IGNORE". The SGML parser is free to redefine them to "INCLUDE" to
|
|
|
|
cause special processing. -->
|
|
|
|
|
|
|
|
<!ENTITY % output.html "IGNORE"> <!-- HTML output is being generated -->
|
2000-10-08 21:15:54 +02:00
|
|
|
<!ENTITY % output.html.images "IGNORE"> <!-- HTML with images -->
|
1998-12-20 21:33:49 +01:00
|
|
|
<!ENTITY % output.print "IGNORE"> <!-- Print output is being generated -->
|
|
|
|
|
DTD for the FreeBSD Documentation Project.
Extends DocBook v3.0, with (currently) the following additions.
1. <hostid>, <username>, <devicename>, <makevar>, and <maketarget> have
been added. Sample uses would be be.
<para>By convention, the the local machine can always be referred
to as <hostid>localhost</hostid>, with the IP address
<hostid role="ipaddr">127.0.0.1</hostid>.</para>
<para>The most powerful account on the system is
<username>root</username>, able to leap tall buildings in a single
bound.</para>
<para>Some devices have an entry in <filename>/dev</filename>. For
example, <filename>/dev/cuaa0</filename> corresponds to
<devicename>sio0</devicename>. Other devices, such as
<devicename>ed0</devicename> do not have entries in
<filename>/dev</filename>.
<para>To rebuild the system, use the <maketarget>world</maketarget>
target. If you do not want to build profiled libraries then ensure
that <makevar>NOPROFILE</makevar> is set.</para>
2. <FAQList> has been added as a new list type, with its own listitem.
Use like so;
<FAQList>
<FAQListItem>
<FAQQuestion>
<para>I have bad blocks on my hard drive!</para>
<!-- Nothing restricting a question to one paragraph -->
</FAQQuestion>
<FAQAnswer>
<para>With SCSI drives, the drive should be capable…</para>
<para>…</para>
</FAQAnswer>
</FAQListItem>
</FAQList>
Long winded, but comprehensive, and in keeping with the rest of DocBook.
As I convert the handbook from LinuxDoc to DocBook I'm working on an
extensive markup guide for the project, where constructs like these will be
fully documented.
1998-06-29 10:08:52 +02:00
|
|
|
<!-- ..................................................................... -->
|
|
|
|
<!-- Entities for element classes and mixtures ........................... -->
|
|
|
|
|
|
|
|
<!-- Character level classes -->
|
|
|
|
<!ENTITY % local.tech.char.class "|HostID|Username|Devicename|MakeTarget|MakeVar">
|
|
|
|
|
2000-07-17 00:56:52 +02:00
|
|
|
<!ENTITY % local.cptr.char.mix "|CO">
|
|
|
|
|
2000-10-08 21:15:54 +02:00
|
|
|
<!ENTITY % local.notation.class "|PNG">
|
|
|
|
<!NOTATION PNG SYSTEM "PNG">
|
|
|
|
|
2000-02-14 02:30:48 +01:00
|
|
|
<!-- OS Version attributes ...............................................
|
|
|
|
|
|
|
|
Each element has three attributes which specify which version(s) of
|
|
|
|
FreeBSD the element's content applies to. It is up to the
|
|
|
|
pre-processor to include or exclude elements based on the value of
|
|
|
|
these attributes. -->
|
|
|
|
<!ENTITY % local.common.attrib
|
|
|
|
"OSVersionMin CDATA #IMPLIED
|
|
|
|
OSVersionMax CDATA #IMPLIED
|
|
|
|
OSVersionIn CDATA #IMPLIED">
|
|
|
|
|
1998-12-20 21:33:49 +01:00
|
|
|
<!-- Altered general entities ............................................
|
|
|
|
|
|
|
|
The HTML 4.0 DTD includes some new ISO entities. Most browsers don't
|
|
|
|
support them yet. Change the definition of some of these entities to
|
|
|
|
character strings that the browsers will support.
|
|
|
|
|
2012-08-21 21:16:02 +02:00
|
|
|
This does not apply when generating printed output, so these are
|
1998-12-20 21:33:49 +01:00
|
|
|
contained within a %output.html; marked section.
|
|
|
|
|
|
|
|
As browser technology improves, these definitions can be removed. -->
|
|
|
|
|
|
|
|
<![ %output.html; [
|
2001-01-06 19:26:11 +01:00
|
|
|
<!ENTITY bdquo ",,">
|
1998-12-20 21:33:49 +01:00
|
|
|
<!ENTITY ldquo "``">
|
|
|
|
<!ENTITY rdquo "''">
|
2000-02-14 02:30:48 +01:00
|
|
|
<!ENTITY lsquo "`">
|
|
|
|
<!ENTITY rsquo "'">
|
|
|
|
<!ENTITY mdash "--">
|
|
|
|
<!ENTITY ndash "-">
|
1998-12-20 21:33:49 +01:00
|
|
|
<!ENTITY hellip "...">
|
|
|
|
<!ENTITY dollar "$">
|
|
|
|
]]>
|
DTD for the FreeBSD Documentation Project.
Extends DocBook v3.0, with (currently) the following additions.
1. <hostid>, <username>, <devicename>, <makevar>, and <maketarget> have
been added. Sample uses would be be.
<para>By convention, the the local machine can always be referred
to as <hostid>localhost</hostid>, with the IP address
<hostid role="ipaddr">127.0.0.1</hostid>.</para>
<para>The most powerful account on the system is
<username>root</username>, able to leap tall buildings in a single
bound.</para>
<para>Some devices have an entry in <filename>/dev</filename>. For
example, <filename>/dev/cuaa0</filename> corresponds to
<devicename>sio0</devicename>. Other devices, such as
<devicename>ed0</devicename> do not have entries in
<filename>/dev</filename>.
<para>To rebuild the system, use the <maketarget>world</maketarget>
target. If you do not want to build profiled libraries then ensure
that <makevar>NOPROFILE</makevar> is set.</para>
2. <FAQList> has been added as a new list type, with its own listitem.
Use like so;
<FAQList>
<FAQListItem>
<FAQQuestion>
<para>I have bad blocks on my hard drive!</para>
<!-- Nothing restricting a question to one paragraph -->
</FAQQuestion>
<FAQAnswer>
<para>With SCSI drives, the drive should be capable…</para>
<para>…</para>
</FAQAnswer>
</FAQListItem>
</FAQList>
Long winded, but comprehensive, and in keeping with the rest of DocBook.
As I convert the handbook from LinuxDoc to DocBook I'm working on an
extensive markup guide for the project, where constructs like these will be
fully documented.
1998-06-29 10:08:52 +02:00
|
|
|
|
|
|
|
<!-- Pull in the original DTD -->
|
1999-06-03 21:37:49 +02:00
|
|
|
<!ENTITY % orig-docbook PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
|
DTD for the FreeBSD Documentation Project.
Extends DocBook v3.0, with (currently) the following additions.
1. <hostid>, <username>, <devicename>, <makevar>, and <maketarget> have
been added. Sample uses would be be.
<para>By convention, the the local machine can always be referred
to as <hostid>localhost</hostid>, with the IP address
<hostid role="ipaddr">127.0.0.1</hostid>.</para>
<para>The most powerful account on the system is
<username>root</username>, able to leap tall buildings in a single
bound.</para>
<para>Some devices have an entry in <filename>/dev</filename>. For
example, <filename>/dev/cuaa0</filename> corresponds to
<devicename>sio0</devicename>. Other devices, such as
<devicename>ed0</devicename> do not have entries in
<filename>/dev</filename>.
<para>To rebuild the system, use the <maketarget>world</maketarget>
target. If you do not want to build profiled libraries then ensure
that <makevar>NOPROFILE</makevar> is set.</para>
2. <FAQList> has been added as a new list type, with its own listitem.
Use like so;
<FAQList>
<FAQListItem>
<FAQQuestion>
<para>I have bad blocks on my hard drive!</para>
<!-- Nothing restricting a question to one paragraph -->
</FAQQuestion>
<FAQAnswer>
<para>With SCSI drives, the drive should be capable…</para>
<para>…</para>
</FAQAnswer>
</FAQListItem>
</FAQList>
Long winded, but comprehensive, and in keeping with the rest of DocBook.
As I convert the handbook from LinuxDoc to DocBook I'm working on an
extensive markup guide for the project, where constructs like these will be
fully documented.
1998-06-29 10:08:52 +02:00
|
|
|
%orig-docbook;
|
|
|
|
|
|
|
|
<!-- ...................................................................... -->
|
|
|
|
<!-- Inline, link, and ubiquitous elements ................................ -->
|
|
|
|
|
|
|
|
<!-- Technical and computer terms ......................................... -->
|
|
|
|
|
|
|
|
<!ELEMENT HostID - - ((%cptr.char.mix;)+)>
|
|
|
|
<!ATTLIST HostID
|
|
|
|
--
|
|
|
|
Role: More specific information about this hostname.
|
|
|
|
If not specified then the default is 'hostname'.
|
|
|
|
--
|
|
|
|
Role (Hostname
|
|
|
|
|Domainname
|
|
|
|
|FQDN
|
|
|
|
|IPAddr
|
2012-08-21 21:16:02 +02:00
|
|
|
|IP6Addr
|
DTD for the FreeBSD Documentation Project.
Extends DocBook v3.0, with (currently) the following additions.
1. <hostid>, <username>, <devicename>, <makevar>, and <maketarget> have
been added. Sample uses would be be.
<para>By convention, the the local machine can always be referred
to as <hostid>localhost</hostid>, with the IP address
<hostid role="ipaddr">127.0.0.1</hostid>.</para>
<para>The most powerful account on the system is
<username>root</username>, able to leap tall buildings in a single
bound.</para>
<para>Some devices have an entry in <filename>/dev</filename>. For
example, <filename>/dev/cuaa0</filename> corresponds to
<devicename>sio0</devicename>. Other devices, such as
<devicename>ed0</devicename> do not have entries in
<filename>/dev</filename>.
<para>To rebuild the system, use the <maketarget>world</maketarget>
target. If you do not want to build profiled libraries then ensure
that <makevar>NOPROFILE</makevar> is set.</para>
2. <FAQList> has been added as a new list type, with its own listitem.
Use like so;
<FAQList>
<FAQListItem>
<FAQQuestion>
<para>I have bad blocks on my hard drive!</para>
<!-- Nothing restricting a question to one paragraph -->
</FAQQuestion>
<FAQAnswer>
<para>With SCSI drives, the drive should be capable…</para>
<para>…</para>
</FAQAnswer>
</FAQListItem>
</FAQList>
Long winded, but comprehensive, and in keeping with the rest of DocBook.
As I convert the handbook from LinuxDoc to DocBook I'm working on an
extensive markup guide for the project, where constructs like these will be
fully documented.
1998-06-29 10:08:52 +02:00
|
|
|
|Netmask
|
|
|
|
|MAC) #IMPLIED
|
|
|
|
%common.attrib;
|
|
|
|
>
|
|
|
|
|
|
|
|
<!ELEMENT Username - - ((%cptr.char.mix;)+)>
|
|
|
|
<!ATTLIST Username
|
|
|
|
%common.attrib;
|
|
|
|
>
|
|
|
|
|
|
|
|
<!ELEMENT Devicename - - ((%cptr.char.mix;)+)>
|
|
|
|
<!ATTLIST Devicename
|
|
|
|
%common.attrib;
|
|
|
|
>
|
|
|
|
|
|
|
|
<!ELEMENT MakeTarget - - ((%cptr.char.mix;)+)>
|
|
|
|
<!ATTLIST MakeTarget
|
|
|
|
%common.attrib;
|
|
|
|
>
|
|
|
|
|
|
|
|
<!ELEMENT MakeVar - - ((%cptr.char.mix;)+)>
|
|
|
|
<!ATTLIST MakeVar
|
|
|
|
%common.attrib;
|
|
|
|
>
|
|
|
|
|
1998-11-04 00:40:13 +01:00
|
|
|
<!-- ...................................................................... -->
|
|
|
|
<!-- General entities for reuse ........................................... -->
|
DTD for the FreeBSD Documentation Project.
Extends DocBook v3.0, with (currently) the following additions.
1. <hostid>, <username>, <devicename>, <makevar>, and <maketarget> have
been added. Sample uses would be be.
<para>By convention, the the local machine can always be referred
to as <hostid>localhost</hostid>, with the IP address
<hostid role="ipaddr">127.0.0.1</hostid>.</para>
<para>The most powerful account on the system is
<username>root</username>, able to leap tall buildings in a single
bound.</para>
<para>Some devices have an entry in <filename>/dev</filename>. For
example, <filename>/dev/cuaa0</filename> corresponds to
<devicename>sio0</devicename>. Other devices, such as
<devicename>ed0</devicename> do not have entries in
<filename>/dev</filename>.
<para>To rebuild the system, use the <maketarget>world</maketarget>
target. If you do not want to build profiled libraries then ensure
that <makevar>NOPROFILE</makevar> is set.</para>
2. <FAQList> has been added as a new list type, with its own listitem.
Use like so;
<FAQList>
<FAQListItem>
<FAQQuestion>
<para>I have bad blocks on my hard drive!</para>
<!-- Nothing restricting a question to one paragraph -->
</FAQQuestion>
<FAQAnswer>
<para>With SCSI drives, the drive should be capable…</para>
<para>…</para>
</FAQAnswer>
</FAQListItem>
</FAQList>
Long winded, but comprehensive, and in keeping with the rest of DocBook.
As I convert the handbook from LinuxDoc to DocBook I'm working on an
extensive markup guide for the project, where constructs like these will be
fully documented.
1998-06-29 10:08:52 +02:00
|
|
|
|
1998-11-04 00:40:13 +01:00
|
|
|
<!ENTITY prompt.root "<prompt>#</prompt>">
|
|
|
|
<!ENTITY prompt.user "<prompt>%</prompt>">
|
1998-12-20 21:33:49 +01:00
|
|
|
|