docs/121440: rc(8) and rcorder(8) unclear about PROVIDE keyword being mandatory

[Michael Ross]

>Number:         121440
>Category:       docs
>Synopsis:       rc(8) and rcorder(8) unclear about PROVIDE keyword being mandatory
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 06 20:40:00 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Michael Ross
>Release:        7-stable
>Organization:
n/a
>Environment:
n/a
>Description:
rc.d scripts without a PROVIDE keyword are skipped by rc.subr and thus not executed.

rc(8) does not state this clearly, quote:
Each script should contain rcorder(8) keywords, especially an appropriate ``PROVIDE'' 

rcorder(8) is more confusing, as it states, quote:
A file may contain zero ``PROVIDE'' lines


See message 63aggbF26iusnU1 at mid.individual.net and followups on news:comp.unix.bsd.freebsd.misc
>How-To-Repeat:

>Fix:
Rephrase rc(8) to make clear that scripts require a PROVIDE keyword
Rephrase rcorder(8) to make clear that, while rcorder does not require the PROVIDE keyword, the script will not be executed without one.

>Release-Note:
>Audit-Trail:
>Unformatted: