From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 1803 invoked from network); 31 Jan 1997 12:15:39 -0000 Received: from euclid.skiles.gatech.edu (list@130.207.146.50) by coral.primenet.com.au with SMTP; 31 Jan 1997 12:15:39 -0000 Received: (from list@localhost) by euclid.skiles.gatech.edu (8.7.3/8.7.3) id HAA09884; Fri, 31 Jan 1997 07:02:39 -0500 (EST) Resent-Date: Fri, 31 Jan 1997 06:52:08 -0500 (EST) From: Zefram Message-Id: <5847.199701311153@stone.dcs.warwick.ac.uk> Subject: Re: Man pages missing To: brown@ftms.COM (Vidiot) Date: Fri, 31 Jan 1997 11:53:27 +0000 (GMT) Cc: zsh-users@math.gatech.edu In-Reply-To: <199701310547.XAA05940@ftms.ftms.com> from "Vidiot" at Jan 30, 97 11:47:24 pm X-Loop: zefram@dcs.warwick.ac.uk X-Stardate: [-31]8812.47 X-US-Congress: Moronic fuckers Content-Type: text Resent-Message-ID: <"bJDQI2.0.JK2.epTyo"@euclid> Resent-From: zsh-users@math.gatech.edu X-Mailing-List: archive/latest/651 X-Loop: zsh-users@math.gatech.edu X-Loop: zsh-workers@math.gatech.edu Precedence: list Resent-Sender: zsh-workers-request@math.gatech.edu Vidiot wrote: >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. No! man pages are the primary form of online documentation for Unix programs; they *must* have complete information. I regularly look things up in the man page, and would be severely inconvenienced if I had to log in to a graphical terminal and fire up ghostview (or whatever) to get authoritative information. (Nor would I want to print out the manual. That would cost me money, and waste paper, and be less convenient than online documentation, and it would be difficult to keep up with each new release.) >The main manual should be done using a package like Framemaker, which would >allow for easier WYSIWYG editing and formatting. Ease of editing is not really a significant consideration for most of us, I suspect. I've never yet seen a WYSIWYG system that was as good as the WYGIWYG systems running on the same computers. > Zsh needs a decent manual. What we have now >are the man pages without the nroff/man-page-looking-format. And what do you have against man pages? -zefram