doc/share/xml/freebsd.dtd

120 lines
4 KiB
DTD
Raw Normal View History

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&hellip;</para> <para>&hellip;</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
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&hellip;</para> <para>&hellip;</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.
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&hellip;</para> <para>&hellip;</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$
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&hellip;</para> <para>&hellip;</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
-->
<!-- ..................................................................... -->
<!-- Parameter entities .................................................. -->
<!-- These parameter entities have specific meanings, and default to
"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 -->
<!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&hellip;</para> <para>&hellip;</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">
<!ENTITY % local.cptr.char.mix "|CO">
2000-10-08 21:15:54 +02:00
<!ENTITY % local.notation.class "|PNG">
<!NOTATION PNG SYSTEM "PNG">
<!-- 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">
<!-- 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.
This does not apply when generating printed output, so these are
contained within a %output.html; marked section.
As browser technology improves, these definitions can be removed. -->
<![ %output.html; [
<!ENTITY bdquo ",,">
<!ENTITY ldquo "``">
<!ENTITY rdquo "''">
<!ENTITY lsquo "`">
<!ENTITY rsquo "'">
<!ENTITY mdash "--">
<!ENTITY ndash "-">
<!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&hellip;</para> <para>&hellip;</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 -->
<!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&hellip;</para> <para>&hellip;</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
|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&hellip;</para> <para>&hellip;</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;
>
<!-- ...................................................................... -->
<!-- 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&hellip;</para> <para>&hellip;</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
<!ENTITY prompt.root "<prompt>#</prompt>">
<!ENTITY prompt.user "<prompt>%</prompt>">