From nobody@FreeBSD.org  Sat May 31 18:38:23 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 99A0E1065673
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 31 May 2008 18:38:23 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 6FC498FC17
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 31 May 2008 18:38:23 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m4VIacxS083423
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 31 May 2008 18:36:38 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.2/8.14.1/Submit) id m4VIacGv083422;
	Sat, 31 May 2008 18:36:38 GMT
	(envelope-from nobody)
Message-Id: <200805311836.m4VIacGv083422@www.freebsd.org>
Date: Sat, 31 May 2008 18:36:38 GMT
From: Sahil Tandon <sahil@tandon.net>
To: freebsd-gnats-submit@FreeBSD.org
Subject: removed reference to .sh suffix requirement and changed script permission from 755 -> 555
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         124167
>Category:       docs
>Synopsis:       removed reference to .sh suffix requirement and changed script permission from 755 -> 555
>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:   Sat May 31 18:40:01 UTC 2008
>Closed-Date:    Sat May 31 19:11:46 UTC 2008
>Last-Modified:  Sat May 31 19:20:01 UTC 2008
>Originator:     Sahil Tandon
>Release:        FreeBSD 7.0
>Organization:
>Environment:
>Description:
In the config tuning section of the Handbook, there is mention of an archaic .sh extension requirement for rc scripts.  This is no longer a requirement and is thusly removed.  Also, scripts in rc.d are installed with unique permissions of 555 (not 755 as noted in the Handbook); that is also corrected in the attached diff.
>How-To-Repeat:

>Fix:
See attached diff.

Patch attached with submission follows:

--- doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml.old	2008-05-30 18:46:33.000000000 -0400
+++ doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml	2008-05-30 19:08:09.000000000 -0400
@@ -367,13 +367,11 @@
 
     <para>While every script must meet some minimal requirements, most
       of the time these requirements are &os; version
-      agnostic.  Each script must have a <filename>.sh</filename>
-      extension appended to the end and every script must be
-      executable by the system.  The latter may be achieved by using
-      the <command>chmod</command> command and setting the unique permissions
-      of <literal>755</literal>.  There should also be, at minimal,
-      an option to <literal>start</literal> the application and an
-      option to <literal>stop</literal> the application.</para>
+      agnostic.  Each script must be executable by the system; this is 
+      typically achieved by using the <command>chmod</command> command and 
+      setting the unique permissions of <literal>555</literal>.  There should 
+      also be, at minimal, options to <literal>start</literal> and <literal>stop</literal> 
+      the application.</para>
 
     <para>The simplest start up script would probably look a little
       bit like this one:</para>


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: remko 
State-Changed-When: Sat May 31 19:11:45 UTC 2008 
State-Changed-Why:  
Committed. Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=124167 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/124167: commit references a PR
Date: Sat, 31 May 2008 19:10:31 +0000 (UTC)

 remko       2008-05-31 19:10:25 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/config chapter.sgml 
   Log:
   Remove reference to .sh extenions and adjust filepermissions from
   755 to 555.
   
   PR:             docs/124167
   Submitted by:   Sahil Tandon <sahil at tandon dot net>
   
   Revision  Changes    Path
   1.231     +5 -7      doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
