K 10
svn:author
V 3
nik
K 8
svn:date
V 27
1998-06-29T08:08:52.000000Z
K 7
svn:log
V 1696
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.

END