From: ead@ixian.com
To: Richard Coleman <coleman@math.gatech.edu>
Cc: zsh-users@math.gatech.edu
Cc: zsh-workers@math.gatech.edu
Subject: Re: Man pages missing
Date: Thu, 30 Jan 1997 18:42:44 -0800 [thread overview]
Message-ID: <199701310242.AA20741@waltz.rahul.net> (raw)
Richard et al.,
Richard Coleman <coleman@math.gatech.edu>:
] ] 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@ixian.com>
http://www.ixian.com/ixian/ead/
"It's harder to solve people's problems than it is to design really neat
products." --Stewart Alsop
next reply other threads:[~1997-01-31 2:46 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
1997-01-31 2:42 ead [this message]
1997-01-31 3:04 ` Richard Coleman
[not found] <199701311236.AA30548@mail2.gmd.de>
1997-01-31 13:07 ` Peter Stephenson
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=199701310242.AA20741@waltz.rahul.net \
--to=ead@ixian.com \
--cc=coleman@math.gatech.edu \
--cc=zsh-users@math.gatech.edu \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.vuxu.org/mirror/zsh/
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).