[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: <OK> [Groff] Simplifying groff documentation
From: |
Eric S. Raymond |
Subject: |
Re: <OK> [Groff] Simplifying groff documentation |
Date: |
Sat, 23 Dec 2006 11:56:30 -0500 |
User-agent: |
Mutt/1.4.2.2i |
M Bianchi <address@hidden>:
> I'm beginning to think that maybe a wiki front end that yielded
> XML-DocBook of the RefEntry document type could encourage keeping
> lots of documentation current. The Linux Documentation Project
> might find that appealing also.
Perhaps that should be a project for you! The model for it might be
"How To of the Day" <http://www.wikihow.com/Main-Page> which uses an
interesting combination of wiki markup and forms.
(I wrote the entry on "How To Break Boards With Your Bare Hands".)
> If editting XML-DocBook directly is unappealing, we need something that is.
Editing XML-DocBook isn't bad at all. Its drawback is that it's not a
good presentation format. The markup is too verbose and obtrusive for
that.
> I encourage the flat text format because sometimes things like X
> fail and you want access to the documents without requiring the
> fancy programs work and a flat-file editor is all you have.
Agreed. Fortunately, generating flat-text from HTML-DocBook is easy.
You lose a lot of structural information, but that's life...
> And if noone has said it, THANK YOU for tackling the problem of adding
> appropriate structure to the document base. It _has_ needed attention.
You're welcome.
--
<a href="http://www.catb.org/~esr/">Eric S. Raymond</a>
- Re: [Groff] RE: Simplifying groff documentation, (continued)
- Re: [Groff] RE: Simplifying groff documentation, Eric S. Raymond, 2006/12/23
- Re: [Groff] Simplifying groff documentation, Ralph Corderoy, 2006/12/31
- Re: [Groff] Simplifying groff documentation, Eric S. Raymond, 2006/12/31
- Re: [Groff] Simplifying groff documentation, Gunnar Ritter, 2006/12/31
- Re: [Groff] Simplifying groff documentation, Eric S. Raymond, 2006/12/31
- Re: [Groff] RE: Simplifying groff documentation, Ted Harding, 2006/12/23
- Re: [Groff] RE: Simplifying groff documentation, Eric S. Raymond, 2006/12/23
Re: <OK> [Groff] Simplifying groff documentation, M Bianchi, 2006/12/22
- Re: <OK> [Groff] Simplifying groff documentation, Eric S. Raymond, 2006/12/23
- Re: <OK> [Groff] Simplifying groff documentation, M Bianchi, 2006/12/23
- Re: <OK> [Groff] Simplifying groff documentation,
Eric S. Raymond <=
- Re: <OK> [Groff] Simplifying groff documentation, Gunnar Ritter, 2006/12/24
- Re: <OK> [Groff] Simplifying groff documentation, Eric S. Raymond, 2006/12/24
- Re: <OK> [Groff] Simplifying groff documentation, mhobgood, 2006/12/24
- Re: <OK> [Groff] Simplifying groff documentation, Eric S. Raymond, 2006/12/24
Re: <OK> [Groff] Simplifying groff documentation, Werner LEMBERG, 2006/12/23
Re: <OK> [Groff] Simplifying groff documentation, Eric S. Raymond, 2006/12/23
Re: <OK> [Groff] Simplifying groff documentation, Werner LEMBERG, 2006/12/23
[Groff] Re: Simplifying groff documentation, Ralph Corderoy, 2006/12/28
Re: [Groff] Simplifying groff documentation, Gunnar Ritter, 2006/12/23