From owner-freebsd-chat@FreeBSD.ORG Fri Jun 13 08:49:30 2003 Return-Path: Delivered-To: freebsd-chat@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id F1BD537B401 for ; Fri, 13 Jun 2003 08:49:29 -0700 (PDT) Received: from pa-plum1b-166.pit.adelphia.net (pa-plum1b-217.pit.adelphia.net [24.53.161.217]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1BC9443FBD for ; Fri, 13 Jun 2003 08:49:29 -0700 (PDT) (envelope-from wmoran@potentialtech.com) Received: from potentialtech.com (working [172.16.0.95]) h5DFnMOg002915; Fri, 13 Jun 2003 11:49:23 -0400 (EDT) (envelope-from wmoran@potentialtech.com) Message-ID: <3EE9F282.4020806@potentialtech.com> Date: Fri, 13 Jun 2003 11:49:22 -0400 From: Bill Moran User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.3) Gecko/20030429 X-Accept-Language: en-us, en MIME-Version: 1.0 To: fcash@sd73.bc.ca References: <3EE8C1F4.7000800@potentialtech.com> <20030613091355.GB9626@submonkey.net> <3EE9D11C.1040008@potentialtech.com> <200306130827.11464.fcash@sd73.bc.ca> In-Reply-To: <200306130827.11464.fcash@sd73.bc.ca> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: chat@freebsd.org Subject: Re: Looking for holes in the docs to fill in X-BeenThere: freebsd-chat@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Non technical items related to the community List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 Jun 2003 15:49:30 -0000 Freddie Cash wrote: > On June 13, 2003 06:26 am, Bill Moran wrote: > >>Ceri Davies wrote: >> >>>On Thu, Jun 12, 2003 at 02:09:56PM -0400, Bill Moran wrote: >>> >>>>One thing I feel is missing is a basic admin tutorial for newbies. >>>>I mean, the handbook covers installing and getting everything up >>>>and running, but once you're there you're lost. A lot of Linux >>>>folks seem to get lost (for example) figuring out how to get >>>>Apache to start automatically after it's installed. I'm guessing >>>>an explanation in the ports section of the handbook would help, >>>>what do others think? > >>Most ports these days install a sample script in /usr/local/etc/rc.d >>(although this doesn't seem to be 100% consistent) The >>apache.sh.sample must be renamed before it'll do anything at boot. > >>If you're new to FreeBSD, this can be annoying and the documentation >>on how to handle this doesn't seem to jump out from anywhere. The >>ports section of the handbook doesn't mention it. I've got an update >>to the handbook I'm going to submit some time today that I think will >>improve this. I've heard of lots of people putting 'apachectl start' >>in their rc.conf file because they couldn't figure out the proper way >>to do this. > > While it is not documented anywhere in the ports sections, it is > documented in the man page for rc(8), which describes the bootup > sequence. It might be a better idea to include a pointer to this man > page than to re-write it in ports section of the Handbook. The patch I submitted refers the reader to the section of the handbook that explains this. It's not that the documentation is missing, it's just that it's not in the place that some look for it. A simple "This is handled by x, see y" will improve the situation, I feel. Although I think my pr was rejected as spam ... I probably have to set smarthost for sendmail to get it to go through ... grrrr ... -- Bill Moran Potential Technologies http://www.potentialtech.com