From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 552 invoked from network); 31 Jan 1997 03:10:20 -0000 Received: from euclid.skiles.gatech.edu (list@130.207.146.50) by coral.primenet.com.au with SMTP; 31 Jan 1997 03:10:20 -0000 Received: (from list@localhost) by euclid.skiles.gatech.edu (8.7.3/8.7.3) id WAA00866; Thu, 30 Jan 1997 22:05:00 -0500 (EST) Resent-Date: Thu, 30 Jan 1997 22:05:00 -0500 (EST) Message-Id: <199701310304.WAA16759@redwood.skiles.gatech.edu> X-Mailer: exmh version 1.6.9 8/22/96 To: zsh-workers@math.gatech.edu Subject: Re: Man pages missing In-reply-to: Your message of "Thu, 30 Jan 1997 18:42:44 PST." <199701310242.AA20741@waltz.rahul.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Thu, 30 Jan 1997 22:04:54 -0500 From: Richard Coleman Resent-Message-ID: <"mOFDU.0.QD.R5Myo"@euclid> Resent-From: zsh-workers@math.gatech.edu X-Mailing-List: archive/latest/2848 X-Loop: zsh-workers@math.gatech.edu Precedence: list Resent-Sender: zsh-workers-request@math.gatech.edu > 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: You should give us some credit. (When I was maintainer) I researched this option as well as several other (pod, linux-doc, texinfo, ...) None of these fit all our criteria, although pod was the closed. Pod has some limitations. Chief among them is that you cannot put tags such as bold or italics in code fragments. The zsh man pages do this in many places in order to illustrate various syntatic things. Also pod doesn't contain enough information to automatically create html or texinfo files. There are translators for them, but the output requires manual changes and additions (I just downloaded the texinfo files for Perl today, and the README contained with it says exactly this). linux-doc is nice for some things, but (at the time) did not have a translator for man pages. That kills it as a choice. yodl seems to be a nice tool. Give it a chance before you condemn it. If it doesn't work out, we can change formats again. rc