From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 25479 invoked from network); 7 Nov 1997 12:34:40 -0000 Received: from math.gatech.edu (list@130.207.146.50) by ns1.primenet.com.au with SMTP; 7 Nov 1997 12:34:40 -0000 Received: (from list@localhost) by math.gatech.edu (8.8.5/8.8.5) id HAA11295; Fri, 7 Nov 1997 07:30:08 -0500 (EST) Resent-Date: Fri, 7 Nov 1997 07:30:08 -0500 (EST) Date: Fri, 7 Nov 1997 15:30:52 +0300 (MSK) From: Andrej Borsenkow X-Sender: bor@itsrm1 Reply-To: borsenkow.msk@sni.de To: Peter Stephenson cc: Zsh hackers list Subject: Re: helpfiles In-Reply-To: <199711070914.KAA27367@hydra.ifh.de> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Resent-Message-ID: <"Z1G51.0.Qm2.GdmOq"@math> Resent-From: zsh-workers@math.gatech.edu X-Mailing-List: archive/latest/3599 X-Loop: zsh-workers@math.gatech.edu Precedence: list Resent-Sender: zsh-workers-request@math.gatech.edu On Fri, 7 Nov 1997, Peter Stephenson wrote: > Here's the latest version of helpfiles, referred to in what (when sent) > was an earlier posting. > > There are some reflections which go along with it: > Originally the help files were included, then they were deleted > partly (I think) to save space and partly because they were hard to keep > up to date. I've a vague feeling there was some kind of suggestion > of putting them back in production releases. Could they be automatically > generated using helpfiles for each release, and perhaps put in a > separate file? This should be pretty trivial to automate; obviously > it's not worth doing patch by patch. > What abot including these help files in program itself? (That is, for every command add string with description). These way it is possible provide help for user-defined commands (from loadable modules). The manual page for zshbuiltins itself could then be generated from these descriptions; this way, if some module is added to distribution, it will be automatically included. Also, _quite_ fine would be to have this description as separate file (for modules as well - let's say zsh.msg for zsh, comctl.msg and so on). It would provide fo easy i18n sometimes ;) cheers ------------------------------------------------------------------------- Andrej Borsenkow Fax: +7 (095) 252 01 05 SNI ITS Moscow Tel: +7 (095) 252 13 88 NERV: borsenkow.msk E-Mail: borsenkow.msk@sni.de -------------------------------------------------------------------------