From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <zsh-workers-request@euclid.skiles.gatech.edu>
Received: (qmail 1436 invoked from network); 31 Jan 1997 07:57:02 -0000
Received: from euclid.skiles.gatech.edu (list@130.207.146.50)
  by coral.primenet.com.au with SMTP; 31 Jan 1997 07:57:02 -0000
Received: (from list@localhost) by euclid.skiles.gatech.edu (8.7.3/8.7.3) id CAA05999; Fri, 31 Jan 1997 02:35:43 -0500 (EST)
Resent-Date: Fri, 31 Jan 1997 02:17:38 -0500 (EST)
Sender: hniksic@public.srce.hr
To: Vidiot <brown@ftms.COM>
Cc: zsh-users@math.gatech.edu (ZSH Mailing List)
Subject: Re: Man pages missing
References: <199701310547.XAA05940@ftms.ftms.com>
X-URL: ftp://gnjilux.cc.fer.hr/pub/unix/util/wget/
X-Attribution: Hrv
X-Face: &}4JQk=L;e.~x+|eo]#DGk@x3~ed!.~lZ}YQcYb7f[WL9L'Z*+OyA\nAEL1M(".[qvI#a2E
 6WYI5>>e7'@_)3Ol9p|Nn2wNa/;~06jL*B%tTcn/XvhAu7qeES0\|MF%$;sI#yn1+y"
From: Hrvoje Niksic <hniksic@srce.hr>
Date: 31 Jan 1997 08:18:33 +0100
In-Reply-To: Vidiot's message of Thu, 30 Jan 1997 23:47:24 -0600 (CST)
Message-ID: <kig680e2tyu.fsf@jagor.srce.hr>
X-Mailer: Gnus v5.4.7/XEmacs 19.14
Resent-Message-ID: <"Ct5Wp1.0.QM1.CoPyo"@euclid>
Resent-From: zsh-users@math.gatech.edu
X-Mailing-List: <zsh-users@math.gatech.edu> archive/latest/648
X-Loop: zsh-users@math.gatech.edu
X-Loop: zsh-workers@math.gatech.edu
Precedence: list
Resent-Sender: zsh-workers-request@math.gatech.edu

 (brown@ftms.com) wrote:
> <No, it's not too much.  What's too much is to have to handle too
> <different documentation format, and sync them all the time.
> 
> I commented to RC separately about the documentation.  Personally I think
> the man pages and the manual should be separated.  The man pages should be
> very brief, to the point that the zsh man page could be only a couple of
> pages long.

This is the approach some programs use (e.g. elm), and some not
(Perl, Emacs[1]).  It is simply a matter of choice; I like the choice
zsh developers made.

> Using FrameMaker would also allow for the document to be turned into a PDF
> file for on-line help.  Frankly, the current help files are old fashioned.
> A state-of-the-art shell needs state-of-the-art manuals.

I don't see anything wrong with the "old-fashioned" help currently
used.  Before thinking about converting to something different, one
should think about all the advantages of PDF over TexInfo?  Is there a
freely available viewer for PDF files?  Can they be viewed on a text
terminal?

-- 
Hrvoje Niksic <hniksic@srce.hr> | Student at FER Zagreb, Croatia
--------------------------------+--------------------------------
Good pings come in small packets.