Date: Mon, 28 Apr 2003 10:07:48 -0700 From: "Bruce A. Mah" <bmah@freebsd.org> To: Lucky Green <shamrock@cypherpunks.to> Cc: freebsd-docs@freebsd.org Subject: Re: "PROGRAMLISTING", "TITLE" not permitted Message-ID: <200304281707.h3SH7mxV092158@bmah.dyndns.org> In-Reply-To: <20030428183759.M89408@pakastelohi.cypherpunks.to> References: <20030428183759.M89408@pakastelohi.cypherpunks.to>
next in thread | previous in thread | raw e-mail | index | archive | help
--==_Exmh_-1180095816P
Content-Type: text/plain; charset=us-ascii
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@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.
--==_Exmh_-1180095816P
Content-Type: application/pgp-signature
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (FreeBSD)
Comment: Exmh version 2.5+ 20020506
iD8DBQE+rV/k2MoxcVugUsMRAv/KAKD5Gmhbmg97XpWKgJHgtQeds79kqQCg32NC
UsdWExl44s8bo5yw+Rm6MSs=
=5q4J
-----END PGP SIGNATURE-----
--==_Exmh_-1180095816P--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200304281707.h3SH7mxV092158>