discuss: TLDP DocBook pages need work - Start there!
Subject:
Re: TLDP DocBook pages need work - Start there!
From:
David Lawyer ####@####.####
Date:
25 Nov 2003 05:15:04 -0000
Message-Id: <20031125050338.GB738@lafn.org>
> At (time_t)758519661 David Lawyer wrote:
>
> > My proposal is to suggest that new authors use LinuxDoc. It's much
> > simpler in all aspects.
>
On Sun, Nov 23, 2003 at 01:51:16PM -0500, John R. Daily wrote:
> What is the functional difference between LinuxDoc and a
> comparable subset of DocBook tags[1] with a well-defined toolchain?
Here's an example of some differences:
----------------------------------------------------------------------
Comparison of DocBook to LinuxDoc (short).
by David Lawyer, June 23, 2000, revised July 2001
Using DocBook instead of LinuxDoc requires many more tags and the tags
tend to be longer. DocBook tags tend to be nested. The tag clutter
makes DocBook harder to read. Thus DocBook is not nearly as easy to
do by hand. Even with an editor that supports it, there is a lot
more complexity to DocBook.
>
> The only difference I can think of is the requirement to close
> tags, but I don't know LinuxDoc particularly well.
See above.
>
> -John
>
> 1. Simplified DocBook would be one candidate,
No, because of the longer words and nesting
> but I imagine something closer to a 1:1 mapping from LinuxDoc to
> DocBook could be created.
>
David Lawyer
