Patch for sgmlspec.sgml
Attached is a patch that comes from the ongoing discussions about
the SGML/XML recommendations. There should be more patches in the
(hopefully near) future.
On Sat, 26 May 2001, Eric Bischoff wrote:
> Le Saturday 26 May 2001 02:23, Dan Scott a écrit :
> > By way of introduction, I converted Eric's SGML LSB
> > standardization appendix to DocBook.
>
> BTW, Dan, would it by possible to do the following fixes?
>
> 1 - in the preamble, put a big warning saying
>
> This document is still being heavily discussed. It is not a standard
> yet. Do not rely on it, do not use it for normative purposes. It is only a
> base for current discussions.
>
> Who disagrees ;-) ?
>
> George, I think that using this document for LSB 1.0 would be a mistake. The
> domain we try to discribe is still moving too fast.
I agree, and will submit a patch including the warning (or something
similar).
>
> 2 - change "SGML & XML" into "SGML & XML" (three occurences) ;-)
>
Sure. In my defence, those titles and the abstract in which the naked
ampersand occurred did not exist in the document I originally submitted.
:)
> 3- Recent docbook DTDs do not allow <envar> inside of <filename>, move
> <filename> after </envar> (two occurences)
>
Good catch. I've validated the document against DocBook-4.1.2; toss in the
XML header and XML DocBook declaration, and it's a valid DocBook XML
document, too.
>
>
--
Dan Scott
--- sgml/sgmlspec.sgml Sat May 26 07:54:48 2001
+++ sgml2/sgmlspec.sgml Sat May 26 08:22:12 2001
@@ -1,17 +1,24 @@
<part id="toclsbsgml">
-<title>LSB Addendum: SGML & XML</title>
+<title>LSB Addendum: SGML & XML</title>
<chapter id="lsbsgml">
-<title>LSB Addendum: SGML & XML</title>
+<title>LSB Addendum: SGML & XML</title>
<abstract>
<para>
Enclosed is a proposal, submitted by Eric Bischoff, for the LSB regarding
-SGML & XML. A more general proposal has been submitted to the Filesystem
+SGML & XML. A more general proposal has been submitted to the Filesystem
Hierarchy Specification workgroup to be adopted. It is proposed that the
enclosed detailed draft be adopted as an addendum to the LSB written
specification. A new Sourceforge CVS module would be created so this
document would be initially maintained separately from the ongoing API/ABI
written specification.
+<warning>
+<para>
+This document is still being heavily discussed. It is neither a standard
+nor a recommendation, and is currently being used only as a basis for
+further discussion.
+</para>
+</warning>
</para>
</abstract>
@@ -367,8 +374,8 @@
Users should be able to define their own centralized catalogs and
their own super catalog in their home directories:
<simplelist>
- <member><filename><envar>$HOME</envar>/.sgml-docbook.cat</filename></member>
- <member><filename><envar>$HOME</envar>/.catalog</filename></member>
+ <member><envar>$HOME</envar><filename>/.sgml-docbook.cat</filename></member>
+ <member><envar>$HOME</envar><filename>/.catalog</filename></member>
</simplelist>
</para>
Reply to: