Subject: Re: trouble with sgml and my PPP document
From: Kai Harrekilde-Petersen <[email-masked]>
To: Linux Documentation Project writers <[email-masked]>
Date: Sun, 5 Feb 1995 15:15:10 -0500

Al Longyear wrote:
> 
> I am having trouble getting the sgml macros to properly format the
> PPP-HOWTO document. It seems to have rearranged the words in the
> question. It splits sentenances and re-arranges the terms.
> 
> I could use some help here. How do I fix it? Would shortening the
> question help? If so, what would I do with the remainder of the text
> which is used to isolate the question?

OK, it seems that I was able to somewhat isolate the source of the problem
(which I have in the ftape-HOWTO):

I ran "format -Tnroff howto > howto.ms" and took a look at the output.  I
found that the rearranging of the words in the headline appears IF - and
only if -  the following headline is split onto two or more lines.  The
mangling occurs exactly where the line breaks occur!  Below I have included
a diff which shows how I was able to get rid of the garbling of my section
headers.

I tried to trace this a bit backwards, but I didn't get very far, as I don't
know the internals of sgmls and sgmlasp (and I know naught of *roff). 
Hopefully, this ring a bell for someone.

--- howto.ms.orig	Sun Feb  5 20:57:15 1995
+++ howto.ms	Sun Feb  5 21:01:07 1995
@@ -390,8 +390,7 @@
 consider to upgrade to at least \fC1.14d\fR.
 .Pp
 .NH 2+\n(il
-.ds h Following the development of the
-\fCftape\fR driver
+.ds h Following the development of the \fCftape\fR driver
 \*h
 .XS \n%
 \*(SN \*h
@@ -806,8 +805,7 @@
 .Pp
 .Pp
 .NH 2+\n(il
-.ds h Getting PCI motherboards to work with
-\fCftape\fR
+.ds h Getting PCI motherboards to work with \fCftape\fR
 \*h
 .XS \n%
 \*(SN \*h
@@ -1360,8 +1358,7 @@
 .Pp
 .Pp
 .NH 2+\n(il
-.ds h The \fCv1.1.0\fR kernel wont compile when \fCftape\fR support is
-added
+.ds h The \fCv1.1.0\fR kernel wont compile when \fCftape\fR support is added
 \*h
 .XS \n%
 \*(SN \*h
@@ -1378,8 +1375,7 @@
 .Pp
 .Pp
 .NH 2+\n(il
-.ds h \fCftape\fR complains that ``\fCThis tape has no 'Linux raw
-format'\fR''
+.ds h \fCftape\fR complains that ``\fCThis tape has no 'Linux raw format'\fR''
 \*h
 .XS \n%
 \*(SN \*h
@@ -1395,8 +1391,7 @@
 .Pp
 .Pp
 .NH 2+\n(il
-.ds h Where can I find the \fCtar\fR/\fCmt\fR/\fCcpio\fR/\fCdd\fR
-binaries/sources/manpages?
+.ds h Where can I find the \fCtar\fR/\fCmt\fR/\fCcpio\fR/\fCdd\fR binaries/sources/manpages?
 \*h
 .XS \n%
 \*(SN \*h

Kai
-- 
Kai Harrekilde-Petersen  <[email-masked]>  Linux: choice of a GNU generation
>> Inside every little problem there's a BIG problem, struggling to get out <<
===== Please do not use my old account <[email-masked]> as it's void =====