What's going on?

J. Michael Ashley jashley@acm.org
Sat, 27 May 2000 07:41:16 -0500 (EST)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Sun, 21 May 2000, Horacio MG wrote:

> > > Really meaning here that there will be no command & options reference
> > > chapters?
> >
> > We should use the regular man page here and merge Mike's command
> > reference and mine. I jsut asked Peter not to translate the man page
> > now but wait until everything else is done.
>
> Ah, good. At least that's an indication that the Guide's revamp is not
> geared towards windoze.
My impression is that Peter is narrowing the focus of the manual to be more of a user's guide. So only a limited set of commands and options will be documented in that guide. There is probably room for a developer's guide in the future that documents all of the commands and options and includes chapters such as the one on writing user interfaces. I think the refocus is a good idea, by the way. The page count of the current command reference doesn't bother me; the stylesheet just happens to be white-space happy. What I don't like is that it documents lots of commands and options that a normal user should not have to know about. Mike -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.1 (GNU/Linux) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjkvwm8ACgkQBwMqlokEyOIOXwCgwtCZlelJAxGNV5LufLInzuI8 F+wAnA83zSiC4oWbNQtFX6nQPvnhhiFF =VTMa -----END PGP SIGNATURE-----