From b05e7e702293735a2b78b8bbbd63501c4bbc6dce Mon Sep 17 00:00:00 2001
From: Franco Fichtner <franco@opnsense.org>
Date: Fri, 11 Nov 2022 22:20:13 +0100
Subject: [PATCH] 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 130962ecdcd..f9c802679e0 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 .