From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 9528 invoked from network); 26 Feb 1997 18:10:55 -0000 Received: from euclid.skiles.gatech.edu (list@130.207.146.50) by coral.primenet.com.au with SMTP; 26 Feb 1997 18:10:55 -0000 Received: (from list@localhost) by euclid.skiles.gatech.edu (8.7.3/8.7.3) id MAA13401; Wed, 26 Feb 1997 12:54:13 -0500 (EST) Resent-Date: Wed, 26 Feb 1997 12:37:15 -0500 (EST) Date: Wed, 26 Feb 1997 19:51:53 +0100 Message-Id: <199702261851.TAA05430@Laden3.ilk.de> From: Juergen Erhard To: brown@ftms.COM CC: zsh-users@math.gatech.edu In-reply-to: <199701311526.JAA17043@ftms.ftms.com> (message from Vidiot on Fri, 31 Jan 1997 09:26:30 -0600 (CST)) Subject: Re: Man pages missing Resent-Message-ID: <"GNQjK1.0.x63.BJ75p"@euclid> Resent-From: zsh-users@math.gatech.edu X-Mailing-List: archive/latest/716 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" == Vidiot writes: > > Perl is a bad example, since there are books available in your local book > store. Zsh has no such book and really needs one. Wouldn't hurt zsh's rep... > <> 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. Not all that's 'old-fashioned' is bad... and not all that's new is good, either. Now for some major snippage: [SNIIIIIIIIIIIIIIIIIIIIIIIIP] > Advantages: graphical, can included visual examples (though I admit that there > isn't much in the way of graphics :-); the user can scale the size of > the help pages to suite the needs of the user; hypertext TOC and index; > just to name a few. Yeah, sure whatever... not that I mind a guey... but, and there's a big BUT coming up... > Disadvantages: doesn't work on text-only systems (how many of these are > still around (one shouldn't cripple the on-line help because of a lack of > X-windows); paging thru the pages and lines is not obvious Forgot one majorly major disadvantage: no free preparator... Yeah and this here is one point that REEEEEEEALLY got me majorly wondering... you just a post or two away said you don't like not having access to the source of the zsh man-pages (in a format you're familiar with)... AND NOW YOU GO AND PROPOSE FRAMEMAKER!!!!!! Excuse me for using the megaphone, but... FrameMaker is a proprietary (read: non-free) and rather expensive (in my view) application that certainly not very many people on this list (or, if we limit the scope of this discussion to the developers) have access too... I mean, what I can't reconcile is that first you complain not being able to send in source patches for the manual, and then you propose using a system for said manual that'd make it impossible (instead of just uncomfortable... for the maintainer(s)) for a whole lot of people to work with the manual source. Riddle me this... I don't get it. [another couple lines fell victim a pair 'o scissors] > I personally > prefer a physical copy of a manual. Hey, I don't want to keep you from gettin a lot of paper... > With PDF the user has the choice of > using it on-line or printing it and making a copy that looks just like > the on-line version, graphics and all. Texinfo... no prob. Only the appearance on screen and on paper is not identical. > A pure text manual from texinfo > can't do that. No, not if I don#t have the source... and I hate it if I don't have the .texi source! > Of course, the source files for the text processor would > be available and FrameMaker allows for the documentation to be used on all > three major platforms; Unix, PC, Mac. Yeah, until FrameMaker (the company...) decides that Unix is not economically viable anymore (according to Bob Fences (obscure L&C ref), Unix has less than 1% market share)... > > Again, these are my thoughts. And these were mine... Oh, and sorry if I've gotten a little loud there... *I* am not your enemy (M$, on the other hand...) > Visit - (Your link to Star Trek and UPN) I'll do that ;-) -- .sig *still* in the repair shop...