From owner-freebsd-doc Wed May 13 15:17:29 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id PAA29879 for freebsd-doc-outgoing; Wed, 13 May 1998 15:17:29 -0700 (PDT) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from localhost.my.domain (ppp6491.on.bellglobal.com [206.172.208.83]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id PAA29840 for ; Wed, 13 May 1998 15:17:22 -0700 (PDT) (envelope-from ac199@hwcn.org) Received: from localhost (tim@localhost) by localhost.my.domain (8.8.8/8.8.8) with SMTP id SAA00821; Wed, 13 May 1998 18:15:19 -0400 (EDT) (envelope-from ac199@hwcn.org) X-Authentication-Warning: localhost.my.domain: tim owned process doing -bs Date: Wed, 13 May 1998 18:15:18 -0400 (EDT) From: Tim Vanderhoek X-Sender: tim@localhost Reply-To: ac199@hwcn.org To: Sue Blake cc: Tim Vanderhoek , freebsd-doc@FreeBSD.ORG Subject: Re: file://localhost/usr/share/doc/handbook/handbook.html In-Reply-To: <19980514075238.04044@welearn.com.au> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, 14 May 1998, Sue Blake wrote: > From past experience, "SEE ALSO" is there to list a lot of > stuff that is even harder to understand than the current man Well, now you have new experience. ;) > There must be a set of attitudes and behaviours that can improve just > about anyone's use of man pages. I'm starting to think that the act of Yes; persistence and a willingness to experiment. :) A lot of the people here haven't had any formal computer training, and a lot of what they've learned has been from manpages. Persistence and wide reading does pay off. Trust me. :) > solutions would be alternative man pages for newbies that encourage their > correct use and transferrability of skills, or a carefully planned I'm not sure that's a solution. Manpages don't suddenly become easier to read once you've learned some minimum set of knowledge. Manpages are really meant as reference material and are usually ill-suited for use as anything else. The tutorial idea is good, though. Something at a higher level than just "this is how to write a shell script". Find a qualified volunteer to write it, now. [Don't even ask!] -- This .sig is not innovative, witty, or profund. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message