http://qs1969.pair.com?node_id=190908


in reply to Re: SGML FAQ to HTML (or XML? or SQL?)
in thread SGML FAQ to HTML (or XML? or SQL?)

I hate to play the "no it didn't" game, but, no, it didn't. There were something like 10 errors, which I verified by actually looking at the file. Things like missing close tags (not optional ones, but on stuff like <sect2>), a "<para>" where there was supposed to be a "</para>"... I got largely the same errors with OpenJade's nsglms and xmllint (after changing the DTD to Docbook XML 4.1.2). Regardless, if you know you *should* validate the document, that is the most important thing, since using structured markup would be a waste otherwise.

Update: the file was changed after I posted my responses so that the HEAD revision no longer has the errors I mentioned (ok, I guess it was 5 errors, not 10, but same difference). I really think it is obnoxious of hacker to do this and claim I'm the one who is wrong... Did he not just update the CVS after I pointed out the errors, as verified by the RCS tag?

--- faq.sgml Sat Aug 17 12:49:47 2002 +++ faq.new.sgml Sat Aug 17 16:50:55 2002 @@ -1,6 +1,6 @@ <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> -<!-- Last modified: $Date: 2002/06/29 00:12:02 $: by $Author: desrod +$ --> +<!-- Last modified: $Date: 2002/08/17 23:04:00 $: by $Author: desrod +$ --> <!-- To convert this with DocBook, use the following syntax: @@ -93,6 +93,7 @@ where AvantGo would be far more appropriate than Plucker (online browsing, for example), however, you need an SDK to work with Avan +tGo. </para> +</sect2> <!-- ################################### --> <!-- Section 1.2: Different from AvantGo --> @@ -245,6 +246,7 @@ cvs -z9 -d :pserver:anonymous@cvs.plkr.org:/cvs/plucker co pluc +ker </para> </blockquote> + </sect2> <!-- ############################# --> <!-- Section 1.6 Status of Plucker --> @@ -259,7 +261,7 @@ different from that installed on ours. You might lose all the dat +a on your PalmPilot, you might need to reboot your machine, it might n +ever be the same again. - <para> + </para> <para> You have been warned. @@ -302,8 +304,6 @@ <!-- #################################### --> - - <!-- ####################### --> <!-- Section 2: Installation --> <!-- ####################### --> @@ -329,8 +329,6 @@ <!-- #################################### --> - - <!-- ################ --> <!-- Section 3: Usage --> <!-- ################ --> @@ -415,7 +413,6 @@ <title>I have all the necessary tools, but I still can't see any pi +ctures?</title> <para> - Make sure that you don't set a too high value for MAXWIDTH. Anyth +ing above 150 pixels (default value) for embedded images will give th +e result that no images are shown. @@ -446,7 +443,6 @@ <title>The protocol is missing when the parser attempts to download + a page?</title> <para> - Even if you don't tell us what OS you are running we would be ver +y surprised if it's not Red Hat 7.0, 7.1, or 7.2. </para> @@ -521,8 +517,6 @@ <!-- ############################# --> - - <!-- ######################## --> <!-- Section 4: Configuration --> <!-- ######################## --> @@ -551,8 +545,6 @@ <!-- ############################# --> - - <!-- ###################### --> <!-- Section 5: Development --> <!-- ###################### --> @@ -668,12 +660,10 @@ </sect2> </sect1> - <!-- ########################### --> - <!-- Section 5: Development: END --> - <!-- ########################### --> - - - +<!-- ########################### --> +<!-- Section 5: Development: END --> +<!-- ########################### --> + <!-- ################################## --> <!-- Section 6: Miscellaneous Questions --> @@ -808,6 +798,8 @@ Frames (it might be possible to implement this in a links kind +of way by rendering and converting the frames to tables, much like the + links browser). + </para> + </listitem> <listitem> <para>