From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 7436 invoked from network); 30 Jan 1997 23:29:44 -0000 Received: from euclid.skiles.gatech.edu (list@130.207.146.50) by coral.primenet.com.au with SMTP; 30 Jan 1997 23:29:44 -0000 Received: (from list@localhost) by euclid.skiles.gatech.edu (8.7.3/8.7.3) id SAA27023; Thu, 30 Jan 1997 18:24:47 -0500 (EST) Resent-Date: Thu, 30 Jan 1997 18:14:09 -0500 (EST) Message-Id: <199701302314.SAA14604@redwood.skiles.gatech.edu> X-Mailer: exmh version 1.6.9 8/22/96 To: zsh-users@math.gatech.edu (ZSH Mailing List) Subject: Re: Man pages missing In-reply-to: Your message of "Thu, 30 Jan 1997 16:32:11 CST." <199701302232.QAA04207@ftms.ftms.com> Mime-Version: 1.0 Content-Type: text/plain Date: Thu, 30 Jan 1997 18:14:04 -0500 From: Richard Coleman Resent-Message-ID: <"0uJEB.0.CQ6.1jIyo"@euclid> Resent-From: zsh-users@math.gatech.edu X-Mailing-List: archive/latest/639 X-Loop: zsh-users@math.gatech.edu X-Loop: zsh-workers@math.gatech.edu Precedence: list Resent-Sender: zsh-workers-request@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 > something in the manual that needs clarification, all I can do is send a > message to the mail list indicating what needs to be changed, instead of > including a diff file with the changes. It means more work for someone > else, but to me the zsh manual is a bit much. A manual that has nroff, > TeX and texinfo commands all wrapped within yodl commands. What a nightmare, > at least for me. I've never heard of yodl before. 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. Yodl is fairly new, but appears to be the best solution so far. rc