zsh-workers
 help / color / mirror / code / Atom feed
From: Andrej Borsenkow <borsenkow.msk@sni.de>
To: Peter Stephenson <pws@ifh.de>
Cc: Zsh hackers list <zsh-workers@math.gatech.edu>
Subject: Re: helpfiles
Date: Fri, 7 Nov 1997 15:30:52 +0300 (MSK)	[thread overview]
Message-ID: <Pine.SV4.3.95.971107152608.10099A-100000@itsrm1> (raw)
In-Reply-To: <199711070914.KAA27367@hydra.ifh.de>

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
-------------------------------------------------------------------------



  reply	other threads:[~1997-11-07 12:34 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
1997-11-07  9:14 helpfiles Peter Stephenson
1997-11-07 12:30 ` Andrej Borsenkow [this message]
     [not found] <borsenkow.msk@sni.de>
1997-11-07 13:07 ` helpfiles Wez Furlong

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=Pine.SV4.3.95.971107152608.10099A-100000@itsrm1 \
    --to=borsenkow.msk@sni.de \
    --cc=pws@ifh.de \
    --cc=zsh-workers@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).