Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 19 Jul 2000 00:47:25 +0200
From:      Udo Erdelhoff <ue@nathan.ruhr.de>
To:        freebsd-doc@FreeBSD.ORG
Subject:   Re: docs/19997: [PATCH] Addition of info about debug kernels to the FAQ
Message-ID:  <20000719004725.S32297@nathan.ruhr.de>
In-Reply-To: <20000718205003.L4668@strontium.scientia.demon.co.uk>; from ben@FreeBSD.ORG on Tue, Jul 18, 2000 at 08:50:03PM %2B0100
References:  <200007181250.FAA88127@freefall.freebsd.org> <20000718145850.A18498@cichlids.cichlids.com> <20000718140525.P4668@strontium.scientia.demon.co.uk> <20000718165725.L32297@nathan.ruhr.de> <20000718165342.Z4668@strontium.scientia.demon.co.uk> <20000718205446.P32297@nathan.ruhr.de> <20000718205003.L4668@strontium.scientia.demon.co.uk>

next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Jul 18, 2000 at 08:50:03PM +0100, Ben Smithurst wrote:
> Udo Erdelhoff wrote:
> 
> > In that case, he'll just love one of my current projects... <veg>
> 
> Which is?

A pair of perl script that commit a couple constructive atrocities to the
formatting of a valid sgml source :-) They're really ugly hacks but they get
the formatting almost right. For example, they manages to turn this:

------------------------------- snip here ------------------------------
<qandaentry><question>
<para>Which file do I download to get FreeBSD?</para></question><answer>

<para>Prior to release 3.1, you only needed one floppy image to install
FreeBSD, namely <filename>floppies/boot.flp</filename>.  However,
since release 3.1 the Project has added base support for a wide
variety of hardware which needed more space, and thus for 3.x and 4.x
we now use two floppy images, namely
<filename>floppies/kernel.flp</filename> and
<filename>floppies/mfsroot.flp</filename>.  These images need to be
copied onto floppies by tools like <command>fdimage</command> or
&man.dd.1;.</para>

<para>If you need to download the distributions yourself (for a DOS
filesystem install, for instance), below are some recommendations
for distributions to grab:</para>


<itemizedlist>

<listitem>
<para> bin/<!-- <br> --></para>
</listitem>

[...]
------------------------------- snip here ------------------------------
into this:
------------------------------- snip here ------------------------------

<qandaentry>
  <question>
    <para>Which file do I download to get FreeBSD?</para>
  </question>

  <answer>
    <para>Prior to release 3.1, you only needed one floppy image to
      install FreeBSD, namely <filename>floppies/boot.flp</filename>.
      However, since release 3.1 the Project has added base support for
      a wide variety of hardware which needed more space, and thus for
      3.x and 4.x we now use two floppy images, namely
      <filename>floppies/kernel.flp</filename> and
      <filename>floppies/mfsroot.flp</filename>. These images need to be
      copied onto floppies by tools like <command>fdimage</command> or
      &man.dd.1;.</para>

    <para>If you need to download the distributions yourself (for a DOS
      filesystem install, for instance), below are some recommendations
      for distributions to grab:</para>

    <itemizedlist>
      <listitem>
        <para> bin/<!-- <br> --></para>
      </listitem>
[...]
------------------------------- snip here ------------------------------

In the actual FAQ context, each line would have 6 additional spaces in
front of it. Running time for the first book.sgml: About 7 seconds on
My AMD K6-3 400 :-)

It doesn't really matter if the input is properly formatted or not - 
the script takes every single bit of formatting, drops it into the
trash bin and reformats. <programlisting>, <literallayout> and <screen>
elements are preserved, of course.

>  * indent properly.
Consider it done.

/s/Udo
-- 
He who findeth sensuous pleasures in the bodies of lush, hot, pink
damsels is not righteous, but he can have a lot more fun.


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000719004725.S32297>