Date: Fri, 25 Jul 2003 22:43:20 +0200 (CEST) From: Martin Karlsson <mk-freebsd@bredband.net> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/54868: Clean-up of sgml-markup in books/developers-handbook Message-ID: <200307252043.h6PKhKr2098397@c-7cc170d5.036-23-6f72652.cust.bredbandsbolaget.se> Resent-Message-ID: <200307252050.h6PKoDHv017584@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 54868
>Category: docs
>Synopsis: Clean-up of sgml-markup in books/developers-handbook
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Fri Jul 25 13:50:13 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator: Martin Karlsson
>Release: FreeBSD 4.8-RELEASE i386
>Organization:
>Environment:
System: FreeBSD c-7cc170d5 4.8-RELEASE FreeBSD 4.8-RELEASE #0: Thu Jul 24 09:03:38 CEST 2003 root@c-7cc170d5:/usr/obj/usr/src/sys/NMK_DVD2 i386
>Description:
Various missing end-tags in the developers handbook.
>How-To-Repeat:
Validate developers-handbook/book.sgml with (o)nsgmls.
>Fix:
Apply the following patch.
--- developers-handbook.diff begins here ---
Index: doc/en_US.ISO8859-1/books/developers-handbook/boot/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/boot/chapter.sgml,v
retrieving revision 1.14
diff -u -r1.14 chapter.sgml
--- doc/en_US.ISO8859-1/books/developers-handbook/boot/chapter.sgml 21 May 2003 20:58:39 -0000 1.14
+++ doc/en_US.ISO8859-1/books/developers-handbook/boot/chapter.sgml 25 Jul 2003 20:37:00 -0000
@@ -550,6 +550,7 @@
<entry>This function allocates and fills out a Page Table
Directory at the top of the kernel memory area.</entry>
</row>
+ </tbody>
</tgroup>
</informaltable>
Index: doc/en_US.ISO8859-1/books/developers-handbook/jail/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/jail/chapter.sgml,v
retrieving revision 1.11
diff -u -r1.11 chapter.sgml
--- doc/en_US.ISO8859-1/books/developers-handbook/jail/chapter.sgml 15 May 2003 11:32:18 -0000 1.11
+++ doc/en_US.ISO8859-1/books/developers-handbook/jail/chapter.sgml 25 Jul 2003 20:37:01 -0000
@@ -70,7 +70,7 @@
<para>In <filename>jail.c</filename>, the first thing I would
note is the declaration of an important structure
<literal>struct jail j</literal>; which was included from
- <filename>/usr/include/sys/jail.h</filename>.
+ <filename>/usr/include/sys/jail.h</filename>.</para>
<para>The definition of the jail structure is:</para>
@@ -126,7 +126,7 @@
<para>Finally, the userland program jails the process, and
executes the command specified. Jail now becomes an
imprisoned process itself and forks a child process which
- then executes the command given using &man.execv.3;
+ then executes the command given using &man.execv.3;</para>
<programlisting><filename>/usr/src/sys/usr.sbin/jail/jail.c</filename>
i = jail(<![CDATA[&j]]>);
Index: doc/en_US.ISO8859-1/books/developers-handbook/mac/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/mac/chapter.sgml,v
retrieving revision 1.27
diff -u -r1.27 chapter.sgml
--- doc/en_US.ISO8859-1/books/developers-handbook/mac/chapter.sgml 20 Apr 2003 23:10:35 -0000 1.27
+++ doc/en_US.ISO8859-1/books/developers-handbook/mac/chapter.sgml 25 Jul 2003 20:37:16 -0000
@@ -941,6 +941,7 @@
<row>
<entry><parameter>label</parameter></entry>
<entry>Policy label to initialize</entry>
+ </row>
</tbody>
</tgroup>
</informaltable>
@@ -1051,6 +1052,7 @@
<entry>Label to be filled in</entry>
</row>
</tbody>
+ </tgroup>
</informaltable>
<para>Initialize a label for a newly instantiated pipe.</para>
@@ -1439,7 +1441,7 @@
<row>
<entry><parameter>fslabel</parameter></entry>
- <entry>File system label being destroyed>
+ <entry>File system label being destroyed></entry>
</row>
</tbody>
</tgroup>
Index: doc/en_US.ISO8859-1/books/developers-handbook/newbus/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/newbus/chapter.sgml,v
retrieving revision 1.5
diff -u -r1.5 chapter.sgml
--- doc/en_US.ISO8859-1/books/developers-handbook/newbus/chapter.sgml 8 Apr 2003 22:54:23 -0000 1.5
+++ doc/en_US.ISO8859-1/books/developers-handbook/newbus/chapter.sgml 25 Jul 2003 20:37:17 -0000
@@ -259,7 +259,7 @@
management (<emphasis><literal>alloc_resource</literal></emphasis>,
<emphasis><literal>activate_resource</literal></emphasis>,
<emphasis><literal>deactivate_resource</literal></emphasis>,
- <emphasis><literal>release_resource</literal></emphasis>).
+ <emphasis><literal>release_resource</literal></emphasis>).</para>
<para>Many methods in the <quote>bus</quote> interface are performing
services for some child of the bus device. These methods would normally
Index: doc/en_US.ISO8859-1/books/developers-handbook/sound/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/sound/chapter.sgml,v
retrieving revision 1.5
diff -u -r1.5 chapter.sgml
--- doc/en_US.ISO8859-1/books/developers-handbook/sound/chapter.sgml 21 Jan 2003 19:28:26 -0000 1.5
+++ doc/en_US.ISO8859-1/books/developers-handbook/sound/chapter.sgml 25 Jul 2003 20:37:19 -0000
@@ -36,6 +36,7 @@
<emphasis>Voxware</emphasis> interface, allowing common
multimedia applications to be ported without
modification.</para>
+ </listitem>
<listitem>
<para>Common code for processing sound data (format
conversions, virtual channels).</para>
@@ -276,6 +277,8 @@
</listitem>
</itemizedlist>
+
+ </sect3>
<sect3 id="xxxchannel-init">
<title>channel_init</title>
--- developers-handbook.diff ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200307252043.h6PKhKr2098397>