LinuxSA Mailing list archives

  From: Dale Long <dalel@loftuscomp.com.au>
  To  : Hawkins, Justin <justin.hawkins@eds.com>
  Date: Thu, 29 Jun 2000 15:49:35 +0930 (CST)

RE: Bash Shell Scriping resource?

On Thu, 29 Jun 2000, Hawkins, Justin wrote:
> The bash man page is one of the worst examples for showing the usefulness or
> man pages; it's tremendously long and thus it's often difficult to find
> pertinent information in it. They would do well to take the bash page and
> split it up into several, as perl does.
> 
> But yes, in general, the man pages do have what you need. Even bash :-)

While I find the bash man page to be one of the better man pages, like
many man pages, it does not put the information it is providing into a
good context. That is left as an exercise for the reader, which is not
what good communication is about. It is more of a reference than a manual.

Given the right structure, I am sure that the information in the man page
could be represented in a more valuable way using the same amount of text.

Dale.

-- 
LinuxSA WWW: http://www.linuxsa.org.au/  IRC: #linuxsa on irc.linux.org.au
To unsubscribe from the LinuxSA list:
  mail linuxsa-request@linuxsa.org.au with "unsubscribe" as the subject