- Document SC_TWOBUTTON_MOUSE, SC_NORM_ATTR, SC_NORM_REV_ATTR,

  SC_KERNEL_CONS_ATTR and SC_KERNEL_CONS_REV_ATTR.

Nudged by eivind

2 files changed, 94 insertions, 0 deletions

diff --git a/share/man/man4/man4.i386/syscons.4 b/share/man/man4/man4.i386/syscons.4
index 2c03a96..48b9d85 100644
--- a/share/man/man4/man4.i386/syscons.4
+++ b/share/man/man4/man4.i386/syscons.4
@@ -47,6 +47,11 @@ the console driver
 .Cd "options SC_NO_PALETTE_LOADING"
 .Cd "options SC_NO_SYSMOUSE"
 .Cd "options SC_PIXEL_MODE"
+.Cd "options SC_TWOBUTTON_MOUSE
+.Cd "options SC_NORM_ATTR"=\&"_attribute_\&"
+.Cd "options SC_NORM_REV_ATTR"=\&"_attribute_\&"
+.Cd "options SC_KERNEL_CONS_ATTR"=\&"_attribute_\&"
+.Cd "options SC_KERNEL_CONS_REV_ATTR"=\&"_attribute_\&"
 .Cd "options SC_DFLT_FONT"
 .Cd "makeoptions SC_DFLT_FONT"=\&"_font_name_\&"
 .Cd "device sc0 at isa?"
@@ -189,6 +194,15 @@ the selected region.
 The selected text is placed in the copy buffer and can be pasted
 at the cursor position by your pressing the button 2 (usually the
 middle button) as many times as you like.
+.Pp
+If your mouse has only two buttons, you may want to use the
+.Em SC_TWOBUTTON_MOUSE
+option below to make the right button to paste the text.
+Alternatively you can make the mouse daemon
+to emulate the middle button.
+See the man page for
+.Xr moused 8
+for more details.
 .Ss Back Scrolling
 The
 .Nm
@@ -282,6 +296,22 @@ If the this option is NOT defined, you can reduce the kernel size a lot.
 See the
 .Em VESA800X600
 flag below.
+.It Em SC_TWOBUTTON_MOUSE
+If you have a two button mouse, you may want to add this option 
+to use the right button of the mouse to paste text.
+See
+.Sx Mouse Support and Copy-and-Paste
+above.
+.It Em SC_NORM_ATTR=\&"_attribute_\&"
+.It Em SC_NORM_REV_ATTR=\&"_attribute_\&"
+.It Em SC_KERNEL_CONS_ATTR=\&"_attribute_\&"
+.It Em SC_KERNEL_CONS_REV_ATTR=\&"_attribute_\&"
+These options will set the default colors.
+Available colors are defined in
+.Pa /usr/include/machine/pc/display.h .
+See
+.Sx EXAMPLE
+below.
 .It Em SC_DFLT_FONT
 This option will specify the default font.
 Available fonts are: iso, iso2, koi8-r, cp437, cp850, cp865 and cp866.
@@ -400,6 +430,23 @@ Note that the keyboard controller driver
 is required by the keyboard driver
 .Nm atkbd .
 .Pp
+The following lines will set the default colors. 
+The normal text will be green on black background. 
+The reversed text will be yellow on green background.
+Note that you cannot put any white space inside the quoted string,
+because of the current implementation of
+.Xr config 8 .
+.Pp
+.Dl "options SC_NORM_ATTR"=\&"(FG_GREEN|BG_BLACK)\&"
+.Dl "options SC_NORM_REV_ATTR"=\&"(FG_YELLOW|BG_GREEN)\&"
+.Pp
+The following lines will set the default colors of the kernel message. 
+The kernel message will be printed bright red on black background.
+The reversed message will be black on red background.
+.Pp
+.Dl "options SC_KERNEL_CONS_ATTR"=\&"(FG_LIGHTRED|BG_BLACK)\&"
+.Dl "options SC_KERNEL_CONS_REV_ATTR"=\&"(FG_BLACK|BG_RED)\&"
+.Pp
 The following example adds the font files
 .Pa cp850-8x16.fnt ,
 .Pa cp850-8x14.font 
diff --git a/share/man/man4/syscons.4 b/share/man/man4/syscons.4
index 2c03a96..48b9d85 100644
--- a/share/man/man4/syscons.4
+++ b/share/man/man4/syscons.4
@@ -47,6 +47,11 @@ the console driver
 .Cd "options SC_NO_PALETTE_LOADING"
 .Cd "options SC_NO_SYSMOUSE"
 .Cd "options SC_PIXEL_MODE"
+.Cd "options SC_TWOBUTTON_MOUSE
+.Cd "options SC_NORM_ATTR"=\&"_attribute_\&"
+.Cd "options SC_NORM_REV_ATTR"=\&"_attribute_\&"
+.Cd "options SC_KERNEL_CONS_ATTR"=\&"_attribute_\&"
+.Cd "options SC_KERNEL_CONS_REV_ATTR"=\&"_attribute_\&"
 .Cd "options SC_DFLT_FONT"
 .Cd "makeoptions SC_DFLT_FONT"=\&"_font_name_\&"
 .Cd "device sc0 at isa?"
@@ -189,6 +194,15 @@ the selected region.
 The selected text is placed in the copy buffer and can be pasted
 at the cursor position by your pressing the button 2 (usually the
 middle button) as many times as you like.
+.Pp
+If your mouse has only two buttons, you may want to use the
+.Em SC_TWOBUTTON_MOUSE
+option below to make the right button to paste the text.
+Alternatively you can make the mouse daemon
+to emulate the middle button.
+See the man page for
+.Xr moused 8
+for more details.
 .Ss Back Scrolling
 The
 .Nm
@@ -282,6 +296,22 @@ If the this option is NOT defined, you can reduce the kernel size a lot.
 See the
 .Em VESA800X600
 flag below.
+.It Em SC_TWOBUTTON_MOUSE
+If you have a two button mouse, you may want to add this option 
+to use the right button of the mouse to paste text.
+See
+.Sx Mouse Support and Copy-and-Paste
+above.
+.It Em SC_NORM_ATTR=\&"_attribute_\&"
+.It Em SC_NORM_REV_ATTR=\&"_attribute_\&"
+.It Em SC_KERNEL_CONS_ATTR=\&"_attribute_\&"
+.It Em SC_KERNEL_CONS_REV_ATTR=\&"_attribute_\&"
+These options will set the default colors.
+Available colors are defined in
+.Pa /usr/include/machine/pc/display.h .
+See
+.Sx EXAMPLE
+below.
 .It Em SC_DFLT_FONT
 This option will specify the default font.
 Available fonts are: iso, iso2, koi8-r, cp437, cp850, cp865 and cp866.
@@ -400,6 +430,23 @@ Note that the keyboard controller driver
 is required by the keyboard driver
 .Nm atkbd .
 .Pp
+The following lines will set the default colors. 
+The normal text will be green on black background. 
+The reversed text will be yellow on green background.
+Note that you cannot put any white space inside the quoted string,
+because of the current implementation of
+.Xr config 8 .
+.Pp
+.Dl "options SC_NORM_ATTR"=\&"(FG_GREEN|BG_BLACK)\&"
+.Dl "options SC_NORM_REV_ATTR"=\&"(FG_YELLOW|BG_GREEN)\&"
+.Pp
+The following lines will set the default colors of the kernel message. 
+The kernel message will be printed bright red on black background.
+The reversed message will be black on red background.
+.Pp
+.Dl "options SC_KERNEL_CONS_ATTR"=\&"(FG_LIGHTRED|BG_BLACK)\&"
+.Dl "options SC_KERNEL_CONS_REV_ATTR"=\&"(FG_BLACK|BG_RED)\&"
+.Pp
 The following example adds the font files
 .Pa cp850-8x16.fnt ,
 .Pa cp850-8x14.font