From owner-freebsd-doc Fri Jan 25 15: 4:22 2002 Delivered-To: freebsd-doc@freebsd.org Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by hub.freebsd.org (Postfix) with ESMTP id E295037B416 for ; Fri, 25 Jan 2002 15:04:18 -0800 (PST) Received: from pittgoth.com (lcl234.zbzoom.net [208.236.36.234]) by pittgoth.com (8.11.6/8.11.6) with ESMTP id g0PN5SD86942; Fri, 25 Jan 2002 18:05:28 -0500 (EST) (envelope-from darklogik@pittgoth.com) Message-ID: <3C51E685.7090600@pittgoth.com> Date: Fri, 25 Jan 2002 18:13:09 -0500 From: Tom Rhodes Reply-To: darklogik@pittgoth.com User-Agent: Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.7) Gecko/20011221 X-Accept-Language: en-us MIME-Version: 1.0 To: "Gary W. Swearingen" Cc: freebsd-doc@FreeBSD.ORG, Michael Lucas Subject: Re: Should common/traditional Unix SA tasks be documented? References: Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Gary W. Swearingen wrote: > In a recent -questions thread, a Linux refugee gave up trying to > determine how to set the clock. (There are two of them which may be > set, but I'll leave the issue related to that for a PR.) It's not > documented in the Handbook or FAQ, "make -k clock" is no help, and "make > -k time" gives 840 words in 80 lines that few will find "date" in. > > I'm wondering whether such things should be documented in the Handbook. > Several posters seemed to think that he was an idiot for not knowing > that "date" sets the clock, either because it's traditional Unix or it's > in Unix books or man pages. > > I seemed to me that an OS Handbook should be like the User's Manuals > which (used to?) come with OSes and other software. The man pages are > more like the Reference Manual, and the Handbook is more like the User > Manual which should even have things like "how to set the clock" or even > "how to delete a file". (Even if brief as referring to a man page.) > Maybe this should be put in a companion book. Or maybe nobody wants to > write all this info and it's best to refer to a commercial book or a > few, which ever are most BSD-centric. But even then there probably > ought to be a section which handles things which are not standard Unix > (BSD or SysV?) or even, someone suggested, a "surprises for Linux users" > section. > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-doc" in the body of the message > > > Send it over to Mr FAQ... "How do I set the time on my FreeBSD System" or do we have that already? -- Tom (Darklogik) Rhodes www.Pittgoth.com Gothic Liberation Front www.FreeBSD.org The Power To Serve To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message