boot(8), kprintf(9), boothowto and code comments

[Jean-Yves Migeon <jean-yves.migeon%espci.fr@localhost>]

Hi list,

While browsing through boot code (for Xen), I did not find any man page 
talking about the boothowto variable and boot flags which control the 
aprint_*() functions' verbosity. After looking for them for maybe 10 
min, I did not see anything.

Just to fix it, anyone would be so kind to comment the attached diff, 
and see if we could find some way to commit this info?

Please cc me on reply.

Cheers,

--
Jean-Yves Migeon
jean-yves.migeon%espci.fr@localhost

Index: share/man/man8/boot.8
===================================================================
RCS file: /pub/NetBSD-CVS/src/share/man/man8/boot.8,v
retrieving revision 1.6
diff -u -r1.6 boot.8
--- share/man/man8/boot.8       14 Dec 2007 12:03:53 -0000      1.6
+++ share/man/man8/boot.8       13 Jul 2008 20:52:34 -0000
@@ -103,6 +103,14 @@
 .Pa onetbsd.gz .
 Alternate system images can be loaded by just specifying the name of the image.
 .Pp
+Some options control the verbosity of
+.Fn aprint_*
+functions by setting different flags in the
+.Dq boothowto
+variable. See
+.Xr kprintf 9
+for more details.
+.Pp
 Options are:
 .Bl -tag -width xxx
 .It Fl a
@@ -118,15 +126,31 @@
 Here it waits for a kernel debugger connect; see
 .Xr ddb 4 .
 .It Fl q
-Boot the system in quiet mode.
+Boot the system in quiet mode (set
+.Dv AB_QUIET
+flag in
+.Dq boothowto
+variable).
 .It Fl s
 Bring the system up in single-user mode.
 .It Fl v
-Boot the system in verbose mode.
+Boot the system in verbose mode (set
+.Dv AB_VERBOSE
+flag in
+.Dq boothowto
+variable).
 .It Fl x
-Boot the system with debug messages enabled.
+Boot the system with debug messages enabled (set
+.Dv AB_DEBUG
+flag in
+.Dq boothowto
+variable).
 .It Fl z
-Boot the system in silent mode.
+Boot the system in silent mode (set
+.Dv AB_SILENT
+in
+.Dq boothowto
+variable).
 .El
 .It Ic consdev Va dev
 Immediately switch the console to the specified device
@@ -198,7 +222,8 @@
 .Xr halt 8 ,
 .Xr installboot 8 ,
 .Xr reboot 8 ,
-.Xr shutdown 8
+.Xr shutdown 8 ,
+.Xr kprintf 9
 .Sh BUGS
 Any
 .Ar filename

Index: share/man/man9/kprintf.9
===================================================================
RCS file: /pub/NetBSD-CVS/src/share/man/man9/kprintf.9,v
retrieving revision 1.23
diff -u -r1.23 kprintf.9
--- share/man/man9/kprintf.9    30 Apr 2008 13:10:58 -0000      1.23
+++ share/man/man9/kprintf.9    13 Jul 2008 20:52:15 -0000
@@ -141,7 +141,10 @@
 are intended to be used to print autoconfiguration messages, and change
 their behavior based on flags in the
 .Dq boothowto
-variable:
+variable; see
+.Sx Interactive mode
+in
+.Xr boot 8 :
 .Bl -tag -width "aprint_verbose()"
 .It Fn aprint_normal
 Sends to the console unless
@@ -216,6 +219,7 @@
 .Sh SEE ALSO
 .Xr printf 1 ,
 .Xr printf 3 ,
+.Xr boot 8 ,
 .Xr bitmask_snprintf 9
 .Sh CODE REFERENCES
 .Pa sys/kern/subr_prf.c