Subject: misc/18549: New entries for the wscons faq
To: None <gnats-bugs@gnats.netbsd.org>
From: Julio Merino <jmmv@hispabsd.org>
List: netbsd-bugs
Date: 10/06/2002 12:27:45
>Number:         18549
>Category:       misc
>Synopsis:       New entries for the wscons faq
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    misc-bug-people
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Sun Oct 06 03:24:00 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator:     Julio Merino
>Release:        NetBSD 1.6H
>Organization:
HispaBSD
>Environment:
	
	
System: NetBSD darkstar.local 1.6H NetBSD 1.6H (DARKSTAR) #0: Sat Sep 28 19:58:50 CEST 2002 jmmv@darkstar.local:/var/build/kernel/DARKSTAR i386
Architecture: i386
Machine: i386
>Description:
	I've done some additions to the Wscons FAQ:
	- New section "How do I use a serial mouse?".
	- New section "How do I enable mouse console support?".
	- Add `es' keymap to the list of keymaps.
	- Add a special "trick" to the section "How do I change the text
	  display colors".
	- Cleanup of trailing whitespace.

	The following patch does all of these ;)
>How-To-Repeat:
	
>Fix:

Index: index.html
===================================================================
RCS file: /cvsroot/htdocs/Documentation/wscons/index.html,v
retrieving revision 1.16
diff -u -u -r1.16 index.html
--- index.html	2002/07/17 10:11:46	1.16
+++ index.html	2002/10/06 10:20:41
@@ -44,6 +44,10 @@
 <a href="#mouseres">How do I change the mouse resolution?</a></font></li>
 <li><font face="helvetica, arial, sans-serif">
 <a href="#fontedit">Is there a font editor?</a></font></li>
+<li><font face="helvetica, arial, sans-serif">
+<a href="#moused">How do I use a serial mouse?</a></font></li>
+<li><font face="helvetica, arial, sans-serif">
+<a href="#wsmoused">How do I enable mouse console support?</a></font></li>
 </ul>
 
 
@@ -68,7 +72,7 @@
 screens, like macppc, mac68k, and alpha to name a few.
 <p>
 For systems on which they are supported, the installation procedure
-will take care to set them up upon installation. The steps involved 
+will take care to set them up upon installation. The steps involved
 to do so manually are:
 <ul>
 <li>Edit /etc/rc.conf and change "wscons" to "yes"
@@ -98,6 +102,7 @@
     <ul>
 	<li><tt>de</tt>
 	<li><tt>dk</tt>
+	<li><tt>es</tt>
 	<li><tt>fr</tt>
 	<li><tt>it</tt>
 	<li><tt>jp</tt>
@@ -130,15 +135,15 @@
     <P>
 
     If your favourite keymap is not supported, you can start digging
-    in 
+    in
     <a href="http://cvsweb.netbsd.org/cgi-bin/cvsweb.cgi/syssrc/sys/dev/wscons/wsksymdef.h"><tt>sys/dev/wscons/wsksymdef.h</tt></a> and
-    <a href="http://cvsweb.netbsd.org/cgi-bin/cvsweb.cgi/syssrc/sys/dev/pckbc/wskbdmap_mfii.c"><tt>sys/dev/pckbc/wskbdmap_mfii.c</tt></a> 
+    <a href="http://cvsweb.netbsd.org/cgi-bin/cvsweb.cgi/syssrc/sys/dev/pckbc/wskbdmap_mfii.c"><tt>sys/dev/pckbc/wskbdmap_mfii.c</tt></a>
     to make your own. Be sure to <a href="../../Misc/send-pr.html#submitting">send-pr</a> a change-request PR with your work, so others can
     make use of it!
     <p>
-    A different way to implement your own keymap is documented in 
+    A different way to implement your own keymap is documented in
     <a href="http://www.NetBSD.org/cgi-bin/query-pr-single.pl?number=10976">PR 10976</a>, which puts the definitions for a russian
-    keymap into a file that's loaded later on. A hungarian keymap is 
+    keymap into a file that's loaded later on. A hungarian keymap is
     available that way in <a href="http://www.NetBSD.org/cgi-bin/query-pr-single.pl?number=11457">PR 11457</a>.
     <p>
 
@@ -168,6 +173,9 @@
 different color, which can be customized.  Look for
 <code>WS_KERNEL_FG</code> and <code>WS_KERNEL_BG</code> in your kernel
 config file.  Change these to taste, and recompile your kernel.
+<p>
+A special trick is to set both variables to
+<code>WSCOL_BLACK</code> which will disable kernel messages.
 
 </dd></dl>
 <p><h3>
@@ -248,10 +256,66 @@
 </h3><dl><dt><dd>
 
 There are several fonts in <tt>/usr/share/wscons/fonts</tt> that
-can be loaded as console fonts. If you want to edit any of them, 
+can be loaded as console fonts. If you want to edit any of them,
 you can use the old pcvt utils that are available in the
 <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/sysutils/pcvt-utils/README.html">pcvt-utils</a> package.
 <p>
+
+
+</dd></dl>
+<p><h3>
+<font face="helvetica, arial, sans-serif"><a name="moused">How do I use a serial mouse?</a></font>
+<font size="-1">(<a href="#top">top</a>)</font>
+</h3><dl><dt><dd>
+
+The wsmouse device (part of wscons) does not directly support serial
+mice. The <a href="http://man.netbsd.org/cgi-bin/man-cgi?moused+8+NetBSD-current">moused(8)</a> daemon is provided to read serial mouse data,
+convert it into wsmouse events and inject them in wscons' event queue,
+so the mouse can be used through the abstraction layer provided by
+wsmouse.
+<p>
+
+A typical use can be: <tt>wsmoused -p /dev/tty00</tt>. This will try
+to determine the type of mouse connected to the first serial port and
+start reading its data. The <a href="http://man.netbsd.org/cgi-bin/man-cgi?moused+8+NetBSD-current">moused(8)</a> manpage contains more examples.
+
+
+</dd></dl>
+<p><h3>
+<font face="helvetica, arial, sans-serif"><a name="wsmoused">How do I enable mouse console support?</a></font>
+<font size="-1">(<a href="#top">top</a>)</font>
+</h3><dl><dt><dd>
+
+Mouse console support is available since NetBSD 1.6B through the
+<a href="http://man.netbsd.org/cgi-bin/man-cgi?wsmoused+8+NetBSD-current">wsmoused(8)</a> daemon. This program provides <i>copy & paste</i> support
+to the wscons console using the mouse pointer.
+<p>
+
+This is currently available in all architectures that use the <a href="http://man.netbsd.org/cgi-bin/man-cgi?vga+1+NetBSD-current">vga(1)</a>
+video driver as a backend of wscons, to know: alpha, arc, bebox, cats,
+hp700, i386 and prep.
+<p>
+
+Here is a step by step list of things to do to get <a href="http://man.netbsd.org/cgi-bin/man-cgi?wsmoused+8+NetBSD-current">wsmoused(8)</a> working
+(note that the manpage contains more information):
+
+<ol>
+  <li>Enable the <code>WSDISPLAY_CHARFUNCS</code> option in your
+  kernel configuration file, recompile and install.</li>
+
+  <li>Edit /etc/ttys: disable /dev/console and enable /dev/ttyE0;
+  wsmoused will use the later.</li>
+
+  <li>Optionally edit /etc/wscons.conf to enable <code>screen 0</code>
+  (/dev/ttyE0) if needed.</li>
+
+  <li>Add <code>wsmoused=yes</code> to your /etc/rc.conf. If you use
+  the X Window System, you may also want to add
+  <code>wsmoused_flags="-X 4"</code> to the file; this tells the
+  daemon which console is X11 running on.</li>
+
+  <li>Reboot and have fun!</li>
+</ol>
 
 </dd></dl>
 <hr>
Index: index.list
===================================================================
RCS file: /cvsroot/htdocs/Documentation/wscons/index.list,v
retrieving revision 1.12
diff -u -u -r1.12 index.list
--- index.list	2002/07/17 10:05:25	1.12
+++ index.list	2002/10/06 10:20:41
@@ -31,7 +31,7 @@
 screens, like macppc, mac68k, and alpha to name a few.
 <p>
 For systems on which they are supported, the installation procedure
-will take care to set them up upon installation. The steps involved 
+will take care to set them up upon installation. The steps involved
 to do so manually are:
 <ul>
 <li>Edit /etc/rc.conf and change "wscons" to "yes"
@@ -57,6 +57,7 @@
     <ul>
 	<li><tt>de</tt>
 	<li><tt>dk</tt>
+	<li><tt>es</tt>
 	<li><tt>fr</tt>
 	<li><tt>it</tt>
 	<li><tt>jp</tt>
@@ -89,15 +90,15 @@
     <P>
 
     If your favourite keymap is not supported, you can start digging
-    in 
+    in
     <a href="http://cvsweb.netbsd.org/cgi-bin/cvsweb.cgi/syssrc/sys/dev/wscons/wsksymdef.h"><tt>sys/dev/wscons/wsksymdef.h</tt></a> and
-    <a href="http://cvsweb.netbsd.org/cgi-bin/cvsweb.cgi/syssrc/sys/dev/pckbc/wskbdmap_mfii.c"><tt>sys/dev/pckbc/wskbdmap_mfii.c</tt></a> 
+    <a href="http://cvsweb.netbsd.org/cgi-bin/cvsweb.cgi/syssrc/sys/dev/pckbc/wskbdmap_mfii.c"><tt>sys/dev/pckbc/wskbdmap_mfii.c</tt></a>
     to make your own. Be sure to <a href="../../Misc/send-pr.html#submitting">send-pr</a> a change-request PR with your work, so others can
     make use of it!
     <p>
-    A different way to implement your own keymap is documented in 
+    A different way to implement your own keymap is documented in
     <a href="http://www.NetBSD.org/cgi-bin/query-pr-single.pl?number=10976">PR 10976</a>, which puts the definitions for a russian
-    keymap into a file that's loaded later on. A hungarian keymap is 
+    keymap into a file that's loaded later on. A hungarian keymap is
     available that way in <a href="http://www.NetBSD.org/cgi-bin/query-pr-single.pl?number=11457">PR 11457</a>.
     <p>
 
@@ -119,6 +120,9 @@
 different color, which can be customized.  Look for
 <code>WS_KERNEL_FG</code> and <code>WS_KERNEL_BG</code> in your kernel
 config file.  Change these to taste, and recompile your kernel.
+<p>
+A special trick is to set both variables to
+<code>WSCOL_BLACK</code> which will disable kernel messages.
 
 <ENTRY>muxdevices How do I use the wscons "mux" devices?
 The wscons "mux" devices let you multiplex the input streams from more than one
@@ -187,10 +191,58 @@
 <ENTRY>fontedit Is there a font editor?
 
 There are several fonts in <tt>/usr/share/wscons/fonts</tt> that
-can be loaded as console fonts. If you want to edit any of them, 
+can be loaded as console fonts. If you want to edit any of them,
 you can use the old pcvt utils that are available in the
 <PKGSRC>sysutils/pcvt-utils package.
 <p>
+
+
+<ENTRY>moused How do I use a serial mouse?
+
+The wsmouse device (part of wscons) does not directly support serial
+mice. The moused(8) daemon is provided to read serial mouse data,
+convert it into wsmouse events and inject them in wscons' event queue,
+so the mouse can be used through the abstraction layer provided by
+wsmouse.
+<p>
+
+A typical use can be: <tt>wsmoused -p /dev/tty00</tt>. This will try
+to determine the type of mouse connected to the first serial port and
+start reading its data. The moused(8) manpage contains more examples.
+
+
+<ENTRY>wsmoused How do I enable mouse console support?
+
+Mouse console support is available since NetBSD 1.6B through the
+wsmoused(8) daemon. This program provides <i>copy & paste</i> support
+to the wscons console using the mouse pointer.
+<p>
+
+This is currently available in all architectures that use the vga(1)
+video driver as a backend of wscons, to know: alpha, arc, bebox, cats,
+hp700, i386 and prep.
+<p>
+
+Here is a step by step list of things to do to get wsmoused(8) working
+(note that the manpage contains more information):
+
+<ol>
+  <li>Enable the <code>WSDISPLAY_CHARFUNCS</code> option in your
+  kernel configuration file, recompile and install.</li>
+
+  <li>Edit /etc/ttys: disable /dev/console and enable /dev/ttyE0;
+  wsmoused will use the later.</li>
+
+  <li>Optionally edit /etc/wscons.conf to enable <code>screen 0</code>
+  (/dev/ttyE0) if needed.</li>
+
+  <li>Add <code>wsmoused=yes</code> to your /etc/rc.conf. If you use
+  the X Window System, you may also want to add
+  <code>wsmoused_flags="-X 4"</code> to the file; this tells the
+  daemon which console is X11 running on.</li>
+
+  <li>Reboot and have fun!</li>
+</ol>
 
 </LIST>
 

	Thank you!

>Release-Note:
>Audit-Trail:
>Unformatted: