From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from gatech.edu (gatech.edu [130.207.244.244]) by werple.mira.net.au (8.6.12/8.6.9) with SMTP id FAA27403 for ; Tue, 4 Jul 1995 05:05:43 +1000 Received: from math (math.skiles.gatech.edu) by gatech.edu with SMTP id AA05754 (5.65c/Gatech-10.0-IDA for ); Mon, 3 Jul 1995 15:07:01 -0400 Received: by math (5.x/SMI-SVR4) id AA07741; Mon, 3 Jul 1995 15:03:58 -0400 Old-Return-Path: Resent-Date: Mon, 03 Jul 1995 15:02:18 -0400 Old-Return-Path: Message-Id: <9507031902.AA01224@redwood.skiles.gatech.edu> X-Mailer: exmh version 1.5.3 12/28/94 To: zsh-users@math.gatech.edu Subject: Re: When the documentation will be updated? In-Reply-To: Your message of "Mon, 03 Jul 1995 13:29:54 EDT." <9507031729.AA02204@dragon.engineering> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Date: Mon, 03 Jul 1995 15:02:18 -0400 From: Richard Coleman Resent-Message-Id: <"xVFD22.0.Zu1.zx3-l"@math> Resent-From: zsh-users@math.gatech.edu X-Mailing-List: archive/latest/40 X-Loop: zsh-users@math.gatech.edu X-Loop: zsh-workers@math.gatech.edu Precedence: list Resent-Sender: zsh-workers-request@math.gatech.edu > > Can I ask a question? When can we see the new documentation for zsh 2.6? > The man pages should generally be up to date. The info files and the introductory paper "intro.ms" are currently out of date. I will not have time to update them (unless someone volunteers to help me on this) until right before the next production release. I will always keep the base document format (which is currently the man pages) up to date as changes are made. I've looked at various ways to make it easier to keep all the different formats up to date. I've looked at using the pod format (which the perl guys use for perl5) and sgml (which the linux documentation project [LDP] uses), but they each lack something I would like to have. Currently I like best the sgml that the LDP uses, but the disadvantage there would be that we would no longer have man pages. They have automatic converters to ascii text, html, and postscript, but not man pages. Since the documentation to zsh has grown so big, this might actually be the best way to go, but I'm still not sure. I've also thought about putting the docs in latex2e and just have postscript and ascii available. This would probably looked the nicest and could eventually lead to a book on zsh (which I've considered writing). What do you think? Richard Coleman zsh@math.gatech.edu