discuss: OpenOffice.org
Subject:
Re: OpenOffice.org
From:
Glen Turner ####@####.####
Date:
22 Apr 2002 01:01:50 -0000
Message-Id: <Pine.LNX.4.44.0204221021030.1394-100000@bush.aarnet.adelaide.edu.au>
> Diagrams can be readily drawn in "ascii graphics". Although Linuxdoc
> supports tables, it's simpler just to make the table in ascii and use a
> verbatim tag <verb> (something like <programlisting> in linuxdoc, <pre>
> in html). The significant problems with the existing documentation are
> that many are outdated and many topics are not covered. The lack of
> bit-mapped images is not a significant problem IMO.
Can't agree. It's difficult to draw a computer network of any complexity
in ASCII art, yet a diagram is essential if readers are to understand the
network being presented as an example. Have a look at one of the
configuration guides on the Cisco Systems web site.
Similarly, I found in the early revisions of the Remote Serial Console
HOWTO that people understand exactly what a VT100 terminal is if I
included a photograph.
Unfortunately, I could never get DocBook SGML to reliably render images so
I ripped them all out and replaced a few of them with ASCII art. The
ASCII art took heaps longer to draw than using "dia", mainly because ASCII
art has one font size.
Glen
PS: It looks like SGML entities don't correctly reproduce in the PDF form
of the HOWTOs.