[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: sgml-tools for Linuxdoc



Hi.

# I cut some addresses from Cc:

In <385FC80E.2CA3720B@mail.nyx.net>,
 at Date: Tue, 21 Dec 1999 19:33:50 +0100,
  on Subject: Re: sgml-tools for Linuxdoc,
   Stein Gjoen <sgjoen@mail.nyx.net> writes:

> > In <385DF979.71534C25@mail.nyx.net>, at Date: Mon, 20 Dec 1999 10:40:09 +0100,
> >   on Subject: Re: sgml-tools for Linuxdoc, Stein Gjoen <sgjoen@mail.nyx.net> writes:
> > 
> > > Another annoying bug is that any <tt> tags in a heading causes
> > > these entries in the table of contents to cut the title at the
> > > position of the tag.
> > >
> > > Example:
> > > HTML: 6.3 Linux md Kernel Patch
> > >       12.8 fstab
> > > ASCII:        6.3 Linux
> > >       12.8 (TT
> 
> [snip]
> 
> > Can you show me the sample sgml file ? I think this problem
> > has been fixed in upstream. I have not worked on this, but
> > sgml-tools 1.0.9 does not show this problem when I create
> > and check a sample sgml file.
> 
> Certainly: the source file is available at
>    http://www.nyx.net/~sgjoen/disk.sgml

Ah, we (JF) have translation of this 'HOWTO: Multi Disk System Tuning'
written by you. I learned a lot from reading this via the translation
when I started to use Linux. I am glad to hear from the author of it :)

# Current Japanese Translation is based on previous version, v0.23d,
# and it was finished at 12 Dec 1999. Strangely, it happened to be
# the same date of your new version 0.23e. 

> Come to think of it, there is another mysterious error message
> that appears when processing that file with sgml2txt. I do not
> have the error message at hand but I can post it later.

I check this disk.sgml (v0.23e) with sgml2txt from our Debian pacakge 
of sgmltools_1.0.9-5 (the most updated one). The messages I got is:

     $ sgml2txt disk.sgml 
    Processing file disk.sgml
    <standard input>:3250: warning: can't break line

I doubt the groff which is called from sgml2txt (or fmt_txt.pl) output
the warning in last message.

But this warning is to complain that the specified line can not be broken 
in order to fill the specified width of the text  (so the output may have 
longer line than expected width), and can be ignored in most cases. 
At least I think so.

The output from sgml2txt (disk.txt) shows

  6. Technologies
     6.1 RAID
        6.1.1 SCSI-to-SCSI
        6.1.2 PCI-to-SCSI
        6.1.3 Software RAID
        6.1.4 RAID Levels
     6.2 Volume Management
     6.3 Linux md Kernel Patch
     6.4 Compression
     6.5 ACL
     6.6 cachefs
     6.7 Translucent or Inheriting File Systems
     6.8 Physical Track Positioning
        6.8.1 Disk Speed Values
     6.9 Stacking
     6.10 Recommendations

and

  12. Implementation
     12.1 Drives and Partitions
     12.2 Partitioning
     12.3 Repartitioning
     12.4 Microsoft Partition Bug
     12.5 Multiple Devices (md)
     12.6 Formatting
     12.7 Mounting
     12.8 fstab
     12.9 Recommendations

in it's table of contents.

I check the contents of disk.sgml, and it has

<sect1>Linux <tt/md/ Kernel Patch
<p>
<nidx>disk!technologies!md</nidx>
<nidx>disk!technologies!raid</nidx>
<nidx>disk!technologies!striping</nidx>
<nidx>disk!technologies!translucence</nidx>
The Linux Multi Disk (md) provides a number of block level features
in various stages of development.

and

<sect1><tt/fstab/
<p>
<nidx>disk!implementation!fstab</nidx>
<nidx>disk!fstab</nidx>
During the booting process the system mounts all partitions
as described in the <tt/fstab/ file which can look something
like this:

as a contents.

I think this problem has been fixed, maybe in the upstream,
because I have not worked on this, although I am not sure 
if modifications in our Debian package (from members and users of 
Debian, including me) happens to come to fix this as well as 
other problems.

Have you checked this with original sgml_tools 1.0.9 ?

Thanks.

-- 
  Taketoshi Sano: <sano@debian.org>,<sano@debian.or.jp>,<kgh12351@nifty.ne.jp>





--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org