Zsh Mailing List Archive
Messages sorted by:
Reverse Date,
Date,
Thread,
Author
Re: Man pages missing
- X-seq: zsh-workers 2847
- From: ead@xxxxxxxxx
- To: Richard Coleman <coleman@xxxxxxxxxxxxxxx>
- Subject: Re: Man pages missing
- Date: Thu, 30 Jan 1997 18:42:44 -0800
- Cc: zsh-users@xxxxxxxxxxxxxxx
- Cc: zsh-workers@xxxxxxxxxxxxxxx
- Chain: ;
- Organization: Ixian Systems
- Reply-to: <ead@xxxxxxxxx>
Richard et al.,
Richard Coleman <coleman@xxxxxxxxxxxxxxx>:
] ] Is it me, or has the documentation become a rat's nest, i.e., g/n/troff,
] ] TeX, texinfo and now yodl? Just what we need, another text formatting
] ] package to learn. :-) Sorry to sound negative, but when is the progression
] ] of manual preparation going to stick with one package? If I run across
]
] But yodl is an attempt to bring order to this mess. We've been
] searching for some time for a set of tools and meta-document format
] that would allow us to generate all the formats necessary, while
] maintaining only one document base. I researched the problem
] when I was maintainer of zsh, but I couldn't find a solid (and
] free) solution.
I'm not a fan of yodl. Why? Because I've never heard of it before. And
because I have heard of other tools that have proven their utility.
I would think that if you didn't find Texinfo suitable, that POD (Plain
Old Documentation), the documentation format used by the Perl project,
would satisfy. pod2text(1) and Pod::Text(3) come with the Perl5
distribution, and there are pod2man(1), pod2html(1), pod2latex(1), and
pod2fm(1) converters available elsewhere. You can find out more about
POD by:
* visiting <URL:ftp://uiarchive.cso.uiuc.edu/pub/lang/perl/CPAN/modules/
by-module/Pod/PodParser-1.00.readme>
* viewing the perlpod(1) manual page on a system where Perl5 is
installed
Be well,
Eric De Mund <ead@xxxxxxxxx>
http://www.ixian.com/ixian/ead/
"It's harder to solve people's problems than it is to design really neat
products." --Stewart Alsop
Messages sorted by:
Reverse Date,
Date,
Thread,
Author