docs/68453: [patch] rc.subr.8

[Michel Lavondes]

>Number:         68453
>Category:       docs
>Synopsis:       [patch] rc.subr.8
>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:   Mon Jun 28 18:20:13 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Michel Lavondes
>Release:        FreeBSD 4.8-RELEASE-p22
>Organization:
Ecdysiasts United For Overdressing
>Environment:
>Description:
${name}_program in a startup script using rc.subr will silently override $command. This patch assumes the behavior is intended and documents it.

This is known to happen using the sysutils/rc_subr port on 4.x, but probably happens on 5.x with rcNG too.
>How-To-Repeat:
man 8 rc.subr
>Fix:
--- src/share/man/man8/rc.subr.8.orig	Mon Jun 21 09:02:57 2004
+++ src/share/man/man8/rc.subr.8	Mon Jun 21 09:26:36 2004
@@ -436,6 +436,10 @@
 Not required if
 .Ar argument Ns Sy _cmd
 is defined for each supported keyword.
+Note that if
+.Sy ${name}_program
+is set, it will silently override
+.Sy command .
 .It Sy command_args
 Optional arguments and/or shell directives for
 .Sy command .
>Release-Note:
>Audit-Trail:
>Unformatted: