[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Groff] Re: Simplifying groff documentation
From: |
Eric S. Raymond |
Subject: |
Re: [Groff] Re: Simplifying groff documentation |
Date: |
Fri, 29 Dec 2006 01:15:42 -0500 |
User-agent: |
Mutt/1.4.2.2i |
Meg McRoberts <address@hidden>:
> If all this were implemented, would you envision that people writing
> new man pages would write them using -man or would they use docbook?
That would depend on your tradeoff between complexity and control.
Writing in man markup is the simpler way to go, but doesn't give you
as much control over the HTML-rendered result as writing in DocBook
would.
> I'm not sure of the solution but it seems that, if they could write in
> docbook, this opens the option of using an XML WYSIWYG editor if necessary.
Indeed it does. A WYSIWYG editor driven by the RefEntry DTD would be an
excellent thing for writing man pages.
> How does this fit into your vision of the future?
Perfectly. What I'm after isn't to force people to either use new
composition tools or be stuck with old ones. I'm focused on the user
experience of reading the documentation. I don't care whether or
not man markup survives as a composition format; what I want is for
it to get out of HTML's way on the presentation end.
--
<a href="http://www.catb.org/~esr/">Eric S. Raymond</a>
- [Groff] Simplifying groff documentation, Eric S. Raymond, 2006/12/22
- [Groff] RE: Simplifying groff documentation, Ted Harding, 2006/12/22
- [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/23
- Re: [Groff] Re: Simplifying groff documentation, Zvezdan Petkovic, 2006/12/23
- Re: [Groff] Re: Simplifying groff documentation, Werner LEMBERG, 2006/12/23
- Re: [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/23
- Re: [Groff] Re: Simplifying groff documentation, Zvezdan Petkovic, 2006/12/28
- Re: [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/28
- Re: [Groff] Re: Simplifying groff documentation, Meg McRoberts, 2006/12/28
- Re: [Groff] Re: Simplifying groff documentation,
Eric S. Raymond <=
- Re: [Groff] Re: Simplifying groff documentation, Zvezdan Petkovic, 2006/12/29
- Re: [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/29
- Re: [Groff] Re: Simplifying groff documentation, Meg McRoberts, 2006/12/29
- Re: [Groff] Re: Simplifying groff documentation, Gunnar Ritter, 2006/12/29
- Re: [Groff] Re: Simplifying groff documentation, Zvezdan Petkovic, 2006/12/29
- Re: [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/29
- [Groff] Semantic tagging and accessibility, Susan Jolly, 2006/12/29
- Re: [Groff] Semantic tagging and accessibility, Eric S. Raymond, 2006/12/29
- [Groff] Re: Simplifying groff documentation, Werner LEMBERG, 2006/12/23
- Re: [Groff] Re: Simplifying groff documentation, Eric S. Raymond, 2006/12/23