On Sun, Sep 11, 2022 at 01:18:06PM -0700, Andrei wrote:
> Hello tech@,
> 
> Recently a new "configtest" action was added to rcctl(8), but the man
> page was never updated.
> 
> This diff documents the change in rcctl's man page. This was my first
> time submitting a patch so I was unsure whether to set $Mdocdate to
> today's date or to the date of the commit which added the new action.
> 

hi.

i added configtest to SYNOPSIS, but was advised not to document it as a
command as it is an rc.d command (like stop/start).

regarding mdocdate: it's fully documented in mdoc(7) but the long and
short of it is you do not need to change this. when a file is committed,
cvs takes care of updating the string to the current date.

jmc

> Index: rcctl.8
> ===================================================================
> RCS file: /cvs/src/usr.sbin/rcctl/rcctl.8,v
> retrieving revision 1.41
> diff -u -p -u -p -r1.41 rcctl.8
> --- rcctl.8     13 Jul 2022 13:36:12 -0000      1.41
> +++ rcctl.8     11 Sep 2022 20:33:31 -0000
> @@ -14,7 +14,7 @@
>  .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
> OUT OF
>  .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
>  .\"
> -.Dd $Mdocdate: July 13 2022 $
> +.Dd $Mdocdate: September 11 2022 $
>  .Dt RCCTL 8
>  .Os
>  .Sh NAME
> @@ -27,7 +27,7 @@
>  .Nm rcctl
>  .Op Fl df
>  .Sm off
> -.Cm check | reload | restart | stop | start
> +.Cm configtest | check | reload | restart | stop | start
>  .Sm on
>  .Ar daemon ...
>  .Nm rcctl
> @@ -79,6 +79,8 @@ Run the
>  scripts with the
>  .Ar action
>  argument, passing through the specified options, if any.
> +.It Cm configtest Ar service ... | daemon ...
> +Check the configuration syntax of the daemon.
>  .It Cm disable Ar service ... | daemon ...
>  Alias for
>  .Cm set Ar service Ns | Ns Ar daemon Cm status off .
> 

Reply via email to