git: b05e7e702293 - main - rc: add a manual entry for ${name}_setup

From: Mariusz Zaborski <oshogbo_at_FreeBSD.org>
Date: Fri, 11 Nov 2022 21:23:26 UTC
The branch main has been updated by oshogbo:

URL: https://cgit.FreeBSD.org/src/commit/?id=b05e7e702293735a2b78b8bbbd63501c4bbc6dce

commit b05e7e702293735a2b78b8bbbd63501c4bbc6dce
Author:     Franco Fichtner <franco@opnsense.org>
AuthorDate: 2022-11-11 21:20:13 +0000
Commit:     Mariusz Zaborski <oshogbo@FreeBSD.org>
CommitDate: 2022-11-11 21:21:39 +0000

    rc: add a manual entry for ${name}_setup
    
    ${name}_prepend is suboptimal as it is prepended to the actual
    command being run. Therefore the term "commandS to prepend"
    is misleading and no clear separation takes place for setup tasks
    that may be required like changing a config file permission or
    generating a configuration file prior to service start.
    
    The other reason is that {argument}_precmd is a service-side
    variable and cannot be repurposed from the user-side.
    
    Reviewed by:    pauamma
    Differential Revision:  https://reviews.freebsd.org/D36210
---
 share/man/man8/rc.subr.8 | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/share/man/man8/rc.subr.8 b/share/man/man8/rc.subr.8
index 130962ecdcdf..f9c802679e00 100644
--- a/share/man/man8/rc.subr.8
+++ b/share/man/man8/rc.subr.8
@@ -29,7 +29,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd March 18, 2022
+.Dd August 16, 2022
 .Dt RC.SUBR 8
 .Os
 .Sh NAME
@@ -685,6 +685,9 @@ This is a generic version of
 .Va ${name}_fib ,
 or
 .Va ${name}_nice .
+.It Va ${name}_setup
+Command to be run prior to
+.Va command .
 .It Ar argument Ns Va _cmd
 Shell commands which override the default method for
 .Ar argument .