rc.conf(5): Style issues

Fix mandoc -Tlint style issues
* Use Pa instead of Va for .conf element (mdoc warned the Va was unused, and its the
  wrong markup anyway)
* Drop useless Va and use Va instead of Ar when referring to variables in the jail file
* One sentence, one line
* drop xr to info(1). That makes no sense, and intro(1) seems unhelpful.

This leaves two warnings: gdb(1) xref not found (but we add a
parenthetical about the package) and a false positive about
a trailing period that is being mistaken for a 'full stop'
when it is really just a character in a filename.

Sponsored by:		Netflix
This commit is contained in:
Warner Losh 2023-02-28 09:28:30 -07:00
parent b8c44def53
commit ce95864fba

View File

@ -482,7 +482,8 @@ In some cases it may be undesirable to save
at shutdown. at shutdown.
When set to "NO" When set to "NO"
.Pa /var/run .Pa /var/run
is loaded at reboot but not saved at shutdown. Typically in this scenario is loaded at reboot but not saved at shutdown.
Typically in this scenario
a a
.Pa service .Pa service
.Pa var_run .Pa var_run
@ -494,7 +495,8 @@ directory structure once, to be reload during all subsequent reboots.
.Pq Vt str .Pq Vt str
Where to save the Where to save the
.Pa /var/run .Pa /var/run
mtree. The default location is mtree.
The default location is
.Pa /var/db/mtree/BSD.var-run.mtree . .Pa /var/db/mtree/BSD.var-run.mtree .
.It Va local_startup .It Va local_startup
.Pq Vt str .Pq Vt str
@ -768,7 +770,8 @@ Destination server port for receiving netflow data
.Pa 9995 ) . .Pa 9995 ) .
.It Va ipfw_netflow_version .It Va ipfw_netflow_version
.Pq Vt int .Pq Vt int
Do not set for using version 5 of the netflow protocol, set it to 9 for using version 9. Do not set for using version 5 of the netflow protocol, set it to 9 for using
version 9.
.It Va ipfw_netflow_fib .It Va ipfw_netflow_fib
.Pq Vt int .Pq Vt int
Only match packet in FIB Only match packet in FIB
@ -3959,11 +3962,11 @@ The configuration filename used by
utility. utility.
The default value is The default value is
.Pa /etc/jail.conf . .Pa /etc/jail.conf .
.Pa /etc/jail. Ns Ao Ar jname Ac Ns Va .conf .Pa /etc/jail. Ns Ao Va jname Ac Ns Pa .conf
and and
.Pa /etc/jail.conf.d/ Ns Ao Ar jname Ac Ns Va .conf .Pa /etc/jail.conf.d/ Ns Ao Va jname Ac Ns Pa .conf
will also be used if will also be used if
.Va Ao Ar jname Ac Va .Ao Va jname Ac
is set in is set in
.Va jail_list . .Va jail_list .
.It Va jail_parallel_start .It Va jail_parallel_start
@ -4898,7 +4901,6 @@ these are the flags to pass to the
.Sh SEE ALSO .Sh SEE ALSO
.Xr chmod 1 , .Xr chmod 1 ,
.Xr gdb 1 Pq Pa ports/devel/gdb , .Xr gdb 1 Pq Pa ports/devel/gdb ,
.Xr info 1 ,
.Xr kbdcontrol 1 , .Xr kbdcontrol 1 ,
.Xr limits 1 , .Xr limits 1 ,
.Xr protect 1 , .Xr protect 1 ,