[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Groff] The case against the case against .EX/.EE & .DS/.DE
From: |
Ralph Corderoy |
Subject: |
Re: [Groff] The case against the case against .EX/.EE & .DS/.DE |
Date: |
Fri, 29 Dec 2006 15:58:14 +0000 |
Hi Gunnar,
> > > > We definitely need a good guide for writing man pages, based on
> > > > our discussion -- something like a man-to-html.howto. This
> > > > guide should contain (as an appendix) those macro definitions
> > > > which a man writer can then simply copy and paste.
Agreed. I've been meaning to add stuff to troff.org about man pages for
ages. IIRC there's a HOWTO in the Linux Documentation Project about
writing man pages. And there's Larry's Effective Man Pages too.
> > -- something SourceForge doesn't support yet nicely, AFAIK. This
> > could be done within the groff wiki quite easily:
> >
> > http://www.groff-wiki.info/
>
> The site does not even purport to independent from groff.
I'm happy to make the document viewable from troff.org in order that it
isn't seen as groff-specific. Promoting man page writing is a good way
to introduce today's programmers to the pleasure of troff.
> As I said, I am willing to contribute, but only to a serious project -
> an implementation-independent document with an editor, releases, and
> textual source code in a version control system - do not expect me to
> spend my time with Wiki fiddling.
It can't be too hard to find a VCS that doesn't want to restrict the
licensing.
Cheers,
Ralph.
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, (continued)
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Werner LEMBERG, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Zvezdan Petkovic, 2006/12/28
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Eric S. Raymond, 2006/12/28
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Werner LEMBERG, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Gunnar Ritter, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Werner LEMBERG, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Gunnar Ritter, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Gunnar Ritter, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Werner LEMBERG, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Gunnar Ritter, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE,
Ralph Corderoy <=
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, D. E. Evans, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Eric S. Raymond, 2006/12/30
- Re: [Groff] Re: Simplifying groff documentation, Ralph Corderoy, 2006/12/29
- [Groff] Avoiding the pod2man mistake, Eric S. Raymond, 2006/12/29
- [Groff] Re: Avoiding the pod2man mistake, Ralph Corderoy, 2006/12/29
- [Groff] Re: Avoiding the pod2man mistake, Eric S. Raymond, 2006/12/30
- Re: [Groff] Avoiding the pod2man mistake, Werner LEMBERG, 2006/12/30
- Re: [Groff] Avoiding the pod2man mistake, Eric S. Raymond, 2006/12/30
- Re: [Groff] Avoiding the pod2man mistake, Werner LEMBERG, 2006/12/30
- Re: [Groff] Avoiding the pod2man mistake, Eric S. Raymond, 2006/12/30