From: Hrvoje Niksic <hniksic@srce.hr>
To: Vidiot <brown@ftms.COM>
Cc: zsh-users@math.gatech.edu (ZSH Mailing List)
Subject: Re: Man pages missing
Date: 31 Jan 1997 08:18:33 +0100 [thread overview]
Message-ID: <kig680e2tyu.fsf@jagor.srce.hr> (raw)
In-Reply-To: Vidiot's message of Thu, 30 Jan 1997 23:47:24 -0600 (CST)
(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.
next prev parent reply other threads:[~1997-01-31 7:57 UTC|newest]
Thread overview: 26+ messages / expand[flat|nested] mbox.gz Atom feed top
1997-01-30 22:32 Vidiot
1997-01-30 23:14 ` Richard Coleman
1997-01-30 23:28 ` Zefram
1997-01-31 4:18 ` Vidiot
1997-01-31 4:57 ` Hrvoje Niksic
1997-01-31 5:47 ` Vidiot
1997-01-31 7:18 ` Hrvoje Niksic [this message]
1997-01-31 15:26 ` Vidiot
1997-01-31 16:10 ` James B. Crigler
1997-01-31 16:15 ` Bruce Stephens
1997-02-01 10:09 ` Hrvoje Niksic
1997-02-26 18:51 ` Juergen Erhard
1997-02-26 18:09 ` Uli Zappe
1997-02-27 0:11 ` man " Duncan Sargeant
1997-01-31 11:53 ` Man " Zefram
1997-01-31 12:36 ` Juergen Christoffel
1997-01-31 12:51 ` Zefram
1997-01-31 13:16 ` Bruce Stephens
1997-01-31 18:33 ` Juergen Christoffel
1997-02-01 10:03 ` Hrvoje Niksic
1997-01-31 16:11 ` Vidiot
1997-01-31 16:55 ` Zefram
1997-01-31 11:45 ` Zefram
1997-01-31 16:02 ` Vidiot
1997-01-31 16:18 ` Lee Eakin
1997-01-31 17:24 Karl E. Vogel
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=kig680e2tyu.fsf@jagor.srce.hr \
--to=hniksic@srce.hr \
--cc=brown@ftms.COM \
--cc=zsh-users@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).