From wmoran@potentialtech.com  Fri Jun 13 12:29:49 2003
Return-Path: <wmoran@potentialtech.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 326C537B401
	for <freebsd-gnats-submit@freebsd.org>; Fri, 13 Jun 2003 12:29:49 -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 7220443FBD
	for <freebsd-gnats-submit@freebsd.org>; Fri, 13 Jun 2003 12:29:48 -0700 (PDT)
	(envelope-from wmoran@potentialtech.com)
Received: from potentialtech.com (working [172.16.0.95])
	by pa-plum1b-166.pit.adelphia.net (8.12.7/8.12.7) with ESMTP id h5DJTlOg003048
	for <freebsd-gnats-submit@freebsd.org>; Fri, 13 Jun 2003 15:29:47 -0400 (EDT)
	(envelope-from wmoran@potentialtech.com)
Message-Id: <3EEA262B.6050601@potentialtech.com>
Date: Fri, 13 Jun 2003 15:29:47 -0400
From: Bill Moran <wmoran@potentialtech.com>
To: freebsd-gnats-submit@freebsd.org
Subject: [patch] Ports section of handbook doesn't mention /usr/local/etc/rc.d

>Number:         53291
>Category:       docs
>Synopsis:       [patch] Ports section of handbook doesn't mention /usr/local/etc/rc.d
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jun 13 12:30:16 PDT 2003
>Closed-Date:    Mon Jun 16 05:56:15 PDT 2003
>Last-Modified:  Mon Jun 16 05:56:15 PDT 2003
>Originator:     Bill Moran
>Release:        FreeBSD 5.1-RELEASE i386
>Organization:
Potential Technologies http://www.potentialtech.com
>Environment:
 System: FreeBSD working.potentialtech.com 5.1-RELEASE FreeBSD 5.1-RELEASE #1: Mon Jun 9 19:01:44 EDT 2003 wmoran@working.potentialtech.com:/usr/obj/usr/src/sys/WORKING i386
 
 
>Description:
 	
 It seems that many folks new to FreeBSD are confused on how ports are
 started automatically at boot.  While the section on configuring FreeBSD
 does a good job of explaining this, the section on ports is where the
 user will look.  This patch adds a pointer in the post-install section
 referring the user to the proper explaination.

>How-To-Repeat:

 Forget how ports work, then install a port that should run as a daemon
 and try to figure out what's starting it.  You may find it, but it's
 more likely you'll give up frustrated.  Many ports install a sample
 script in /usr/local/etc/rc.d, which means the daemon doesn't start
 on reboot ... and this is even more confusing!

>Fix:
 	
 
--- portschap.diff begins here ---
--- chapter.sgml.orig	Tue Jun 10 19:15:01 2003
+++ chapter.sgml	Thu Jun 12 19:46:20 2003
@@ -1160,6 +1160,15 @@
  	<para>A <literal>WWW:</literal> line, if present, should provide a URL
  	  for the application's web site.</para>
        </listitem>
+
+      <listitem>
+    <para>Ports that should start at boot (such as Internet servers) will usually
+      install a sample script in <filename>/usr/local/etc/rc.d</filename>.  You
+      should review this script for correctness and edit or rename it if needed.
+      See <link linkend="configtuning-starting-services">Starting Services</link>
+      for more information.</para>
+      </listitem>
+
      </itemizedlist>
    </sect1>

--- portschap.diff ends here ---

>Release-Note:
>Audit-Trail:
Class-Changed-From-To: sw-bug->doc-bug 
Class-Changed-By: ceri 
Class-Changed-When: Sat Jun 14 04:34:44 PDT 2003 
Class-Changed-Why:  
This is a docs issue. 


Responsible-Changed-From-To: gnats-admin->freebsd-doc 
Responsible-Changed-By: ceri 
Responsible-Changed-When: Sat Jun 14 04:34:44 PDT 2003 
Responsible-Changed-Why:  
Reassign misfiled PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=53291 
State-Changed-From-To: open->closed 
State-Changed-By: blackend 
State-Changed-When: Mon Jun 16 05:55:37 PDT 2003 
State-Changed-Why:  
Committed, Thanks. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=53291 
>Unformatted:
