Bug 261128 - loader.conf(5) does not mention boot_verbose, and its SEE ALSO in main (14.0-CURRENT) does not cross-reference loader_simp(8)
Summary: loader.conf(5) does not mention boot_verbose, and its SEE ALSO in main (14.0-...
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-bugs (Nobody)
URL: https://www.freebsd.org/cgi/man.cgi?q...
Keywords: needs-patch
Depends on:
Blocks:
 
Reported: 2022-01-11 19:22 UTC by Graham Perrin
Modified: 2022-12-29 12:18 UTC (History)
2 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2022-01-11 19:22:53 UTC 
<https://www.freebsd.org/cgi/man.cgi?query=loader.conf&sektion=5&manpath=FreeBSD#SYNTAX> mentions verbose_loading but not boot_verbose. 

Please consider adding the latter to the manual page. 

Thanks
Comment 1 Li-Wen Hsu freebsd_committer freebsd_triage 2022-01-12 04:04:51 UTC 
Do you want to create a patch for it? https://cgit.freebsd.org/src/tree/stand/defaults/loader.conf.5
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-01-13 10:19:55 UTC 
(In reply to Li-Wen Hsu from comment #1)

I'll try. 

First, wording … 


Something like a stub in a Japanese page in 1999, 
<https://github.com/freebsd/freebsd-doc/blob/af10ba312066057ebb85f0dc9cd1e2b0a688d76e/ja_JP.eucJP/man/man8/loader.8#L329>


<https://github.com/freebsd/freebsd-src/commit/aa203600d542b9528146c176e8cae1044b48a98f#diff-939d8a2cd5a763b38b4f5aeeb24915345ae2555f0a263420601b2c981bd3fd95R157-R160> (1998-12-15): 

> set boot_verbose
> 
> Setting this variable causes extra debugging information to be printed
> by the kernel during the boot phase.


<https://github.com/freebsd/freebsd-src/commit/9efec336c596e55d05642bbbfc322493c0db6dbf#diff-f0a9397a2836fdd3eb9a9818f012e799bf7b550d91b5d74b9a9079d61eba5443R61-R68> (2002-07-16) NB _any_: 

> 			# The following boot_ variables are enabled
>			# by setting them to any value.

…

> #boot_verbose=""	# Causes extra debugging information to be printed


<https://github.com/freebsd/freebsd-src/commit/9873c807dac1f8b83b9f7bc9a8d4e318ea295b55#diff-bee0bbebe8ee2e1ae33ee3d286a550ca35eb6b4931c686eaedc7b0c100a71839R371-R373> (2021-07-14): 

> .It Va boot_verbose
> Setting this variable causes extra debugging information to be printed
> by the kernel during the boot phase.

– this page is online for FreeBSD 14.0-CURRENT at: 

<https://www.freebsd.org/cgi/man.cgi?query=loader_simp&sektion=8&manpath=FreeBSD+14.0-current>
Comment 3 Graham Perrin freebsd_committer freebsd_triage 2022-01-13 10:24:05 UTC 
(In reply to Graham Perrin from comment #2)

> <https://www.freebsd.org/cgi/man.cgi?query=loader_simp&sektion=8&manpath=FreeBSD+14.0-current>

<https://www.freebsd.org/cgi/man.cgi?query=loader.conf&sektion=5&manpath=FreeBSD+14.0-current#SEE_ALSO>: 

* for loader.conf(5) in FreeBSD 14.0-CURRENT 

* lacks a cross-reference to the page for loader_simp(8) in FreeBSD 14.0-CURRENT
Comment 4 Graham Perrin freebsd_committer freebsd_triage 2022-12-29 12:18:36 UTC 
(In reply to Li-Wen Hsu from comment #1)

> Do you want to create a patch for it? …

Since I looked for the first time at mdoc(7) <https://www.freebsd.org/cgi/man.cgi?query=mdoc&sektion=7&manpath=FreeBSD>, I'm certain that I'll not get my head around a language such as this in the near future.