"PROGRAMLISTING", "TITLE" not permitted

[Bruce A. Mah]

If memory serves me right, Lucky Green wrote:

> 1)
> /usr/local/bin/jade:/usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgm
> l:2789:16:E:
> document type does not allow element "PROGRAMLISTING" here; assuming
> missing "FOOTNOTE" start-tag
> /usr/local/bin/jade:/usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgm
> l:2792:9:E:
> end tag for "FOOTNOTE" omitted, but its declaration does not permit this
> /usr/local/bin/jade:/usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgm
> l:2789:1:
> start tag was here
> 
> Lines 2789 - 2792 follow:
> 	<step>
> 	<title>Verify the operating system version</title>
> 
> 	<para>&man.gbde.4; requires FreeBSD 5.0 or higher.</para>
> 	<screen>&prompt.root; <userinput>uname -r</userinput>
> 	<programlisting>
> 	5.0-RELEASE
> 	</programlisting>
> 	</screen></step>

I don't know what the deal is with FOOTNOTE, but it looks to me like you
don't really need <programlisting></programlisting> in this context.  (I
don't know how to express why you don't, unfortunately.)

> 2)
> 
> /usr/local/bin/jade:/usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgm
> l:2984:6:E:
> document type does not allow element "TITLE" here; missing one of
> "ABSTRACT",[...]
> 
> [We just finished a procedure]
> </step>
> </procedure>
> 
> <title>Automatically mounting encrypted partitions</title>
> <para>It is possible to create a script to automatically attach, check,
> and mount an
> encrypted partition, but for security reasons the script should not
> contain the
> gbde password. Instead, it is recommended to run such scripts manually
> while
> providing the password via the console or &man.ssh.1;.</para>

A <title></title> usually comes at the start of a section (for example,
right after a <sect1>, <sect2>, <sect3>, etc. tag).  Are you starting a
new section here?

> -- Lucky Green <shamrock at cypherpunks.to> PGP encrypted email preferred.
                                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
I'd encrypt, but I figure that'd kind of defeat the point of posting to 
a public mailing list.  :-)

Bruce. 


-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 223 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20030428/2a1af810/attachment.sig>