Date: Tue, 9 Jan 2001 12:28:59 +0000 From: Nik Clayton <nik@freebsd.org> To: Udo Erdelhoff <ue@nathan.ruhr.de> Cc: freebsd-doc@freebsd.org Subject: Re: Strange <!-- <br> --> sequences Message-ID: <20010109122858.A6334@canyon.nothing-going-on.org> In-Reply-To: <20010108163030.G4211@nathan.ruhr.de>; from ue@nathan.ruhr.de on Mon, Jan 08, 2001 at 04:30:30PM %2B0100 References: <20010106211512.L64806@nathan.ruhr.de> <20010108094923.A5107@canyon.nothing-going-on.org> <20010108163030.G4211@nathan.ruhr.de>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, Jan 08, 2001 at 04:30:30PM +0100, Udo Erdelhoff wrote:
> Hi Nik,
> > > [strange <!-- <br> ---> sequences
> > > What's the stroy behind them?
> >
> > If any remain in comments it's probably as a reminder that a break was
> > intended, and the person converting from LinuxDoc to DocBook should
> > check the formatted output, to ensure that the break does occur (and
> > tweak the stylesheets as necessary if it doesn't).
>
> well, I do not know who converted the english version of the FAQ from
> LinuxDoc to Docbook but he or she forgot them.
Ah, that'll be me.
I've just dug in to the FAQ to see where they are.
Hmm.
All but the first set can be removed, they serve absolutely no purpose.
The first set are more tricky.
These are supposed to format information about books. Sadly, it
includes all the bibliographic information about the book inline, as it
where.
DocBook doesn't support this. It expects you to either have a fully
fledged bibliography, which you refer to, or it expects you to use an
the <citetitle> element. For an example of the former, go to
http://www.docbook.org/tdg/html/bibliography.html
and of the latter go to
http://www.docbook.org/tdg/html/citetitle.html
> The <br>-comments have
> been there since day 1 and the current version and they haven't been
> removed in the current version of the FAQ (revision 1.135).
>
> The break doesn't occur and the stylesheets haven't been modified, either.
> Check the "Books about FreeBSD" section in the preface. More precisly
> the listing of the old 4.4 BSD books.
>
> I've fixed the german translation of the FAQ by using tables.
> Yodel if you'd like an adaption for the english version.
On the whole, I'd prefer it if the markup was the same across
translations. Should anyone want to jump up and fix the markup in the
English FAQ to use <bibliography> then please do so, otherwise I'll get
to it in my copious free time.
N
--
Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95.
Telephone line, $24.95 a month. Software, free. USENET transmission,
hundreds if not thousands of dollars. Thinking before posting, priceless.
Somethings in life you can't buy. For everything else, there's MasterCard.
-- Graham Reed, in the Scary Devil Monastery
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?20010109122858.A6334>