From owner-freebsd-doc Fri Jan 25 15:14:37 2002 Delivered-To: freebsd-doc@freebsd.org Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18]) by hub.freebsd.org (Postfix) with ESMTP id E97B137B400 for ; Fri, 25 Jan 2002 15:14:34 -0800 (PST) Received: (from mwlucas@localhost) by blackhelicopters.org (8.11.6/8.11.6) id g0PNEVp81351; Fri, 25 Jan 2002 18:14:31 -0500 (EST) (envelope-from mwlucas) Date: Fri, 25 Jan 2002 18:14:31 -0500 From: Michael Lucas To: Tom Rhodes Cc: "Gary W. Swearingen" , freebsd-doc@FreeBSD.ORG Subject: Re: Should common/traditional Unix SA tasks be documented? Message-ID: <20020125181431.A81334@blackhelicopters.org> References: <3C51E685.7090600@pittgoth.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <3C51E685.7090600@pittgoth.com>; from darklogik@pittgoth.com on Fri, Jan 25, 2002 at 06:13:09PM -0500 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 Gee, thanks. :) On my to-do list now, will get to next week hopefully. On Fri, Jan 25, 2002 at 06:13:09PM -0500, Tom Rhodes wrote: > 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 -- Michael Lucas mwlucas@FreeBSD.org, mwlucas@BlackHelicopters.org my FreeBSD column: http://www.oreillynet.com/pub/q/Big_Scary_Daemons http://www.blackhelicopters.org/~mwlucas/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message