Module Name: src
Committed By: tsutsui
Date: Wed Feb 9 14:13:09 UTC 2011
Modified Files:
src/share/man/man4/man4.hp300: dvbox.4 gbox.4 hyper.4 rbox.4 topcat.4
Log Message:
- update SYNOPSIS and SEE ALSO for wscons support
- remove descriptions about obsolete ioctl
To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/share/man/man4/man4.hp300/dvbox.4 \
src/share/man/man4/man4.hp300/gbox.4 src/share/man/man4/man4.hp300/rbox.4 \
src/share/man/man4/man4.hp300/topcat.4
cvs rdiff -u -r1.3 -r1.4 src/share/man/man4/man4.hp300/hyper.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/man4.hp300/dvbox.4
diff -u src/share/man/man4/man4.hp300/dvbox.4:1.5 src/share/man/man4/man4.hp300/dvbox.4:1.6
--- src/share/man/man4/man4.hp300/dvbox.4:1.5 Mon Mar 22 18:58:31 2010
+++ src/share/man/man4/man4.hp300/dvbox.4 Wed Feb 9 14:13:09 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: dvbox.4,v 1.5 2010/03/22 18:58:31 joerg Exp $
+.\" $NetBSD: dvbox.4,v 1.6 2011/02/09 14:13:09 tsutsui Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -33,7 +33,7 @@
.\"
.\" from: @(#)dv.4 8.1 (Berkeley) 6/9/93
.\"
-.Dd June 9, 1993
+.Dd February 9, 2011
.Dt DVBOX 4 hp300
.Os
.Sh NAME
@@ -41,6 +41,10 @@
.Nd
.Tn HP98730
``DaVinci'' graphics device interface
+.Sh SYNOPSIS
+.Cd "dvbox* at intio?"
+.Cd "dvbox* at dio? scode ?"
+.Cd "wsdisplay* at dvbox?"
.Sh DESCRIPTION
This driver is for the
.Tn HP98730
@@ -57,108 +61,6 @@
The hardware installation manual describes the procedure for
setting these values.
.Pp
-A user process communicates to the device initially by means of
-.Xr ioctl 2
-calls. For the
-.Tn HP-UX
-.Xr ioctl 2
-calls supported, refer to
-.Tn HP-UX
-manuals.
-The
-.Bx
-calls supported are:
-.Bl -tag -width indent
-.It Dv GRFIOCGINFO
-Get Graphics Info
-.Pp
-Get info about device, setting the entries in the
-.Ar grfinfo
-structure, as defined in
-.In hpdev/grfioctl.h .
-For the standard 98730, the number of planes should be 4. The number of
-colors would therefore be 15, excluding black. If one 98732A frame buffer
-board is installed, there will still be 4 planes, with the 4 planes on the
-colormap board becoming overlay planes. With each additional 98732 frame
-buffer board 4 planes will be added up to a maximum of 32 planes total.
-.It Dv GRFIOCON
-Graphics On
-.Pp
-Turn graphics on by enabling
-.Tn CRT
-output. The screen will come on, displaying
-whatever is in the frame buffer, using whatever colormap is in place.
-.It Dv GRFIOCOFF
-Graphics Off
-.Pp
-Turn graphics off by disabling output to the
-.Tn CRT .
-The frame buffer contents
-are not affected.
-.It Dv GRFIOCMAP
-Map Device to user space
-.Pp
-Map in control registers and frame buffer space. Once the device file is
-mapped, the frame buffer structure is accessible. The structure describing
-the 98730 is defined in
-.In hpdev/grf_dvreg.h .
-.El
-.Sh FILES
-.Bl -tag -width /dev/MAKEDEV.hpux -compact
-.It Pa /dev/grf?
-.Bx
-special file
-.It Pa /dev/crt98730
-.It Pa /dev/ocrt98730
-.Tn HP-UX
-.Em starbase
-special files
-.It Pa /dev/MAKEDEV.hpux
-script for creating
-.Tn HP-UX
-special files
-.El
-.Sh EXAMPLES
-This is a short segment of code showing how the device is opened and mapped
-into user process address space assuming that it is
-.Ql grf0 :
-.Bd -literal -offset indent
-struct dvboxfb *dvbox;
-u_char *Addr, frame_buffer;
-struct grfinfo gi;
-int disp_fd;
-
-disp_fd = open("/dev/grf0",1);
-
-if (ioctl (disp_fd, GRFIOCGINFO, \*[Am]gi) \*[Lt] 0) return -1;
-
-(void) ioctl (disp_fd, GRFIOCON, 0);
-
-Addr = (u_char *) 0;
-if (ioctl (disp_fd, GRFIOCMAP, \*[Am]Addr) \*[Lt] 0) {
-(void) ioctl (disp_fd, GRFIOCOFF, 0);
-return -1;
-}
-dvbox = (dvboxfb *) Addr; /* Control Registers */
-frame_buffer=(u_char *)Addr+gi.gd_regsize; /* Frame buffer memory */
-.Ed
-.Sh DIAGNOSTICS
-None under
-.Bx .
-.Tn HP-UX
-.Tn CE.utilities
-must be used.
-.Sh ERRORS
-.Bl -tag -width [EINVAL]
-.It Bq Er ENODEV
-no such device.
-.It Bq Er EBUSY
-Another process has the device open.
-.It Bq Er EINVAL
-Invalid ioctl specification.
-.El
.Sh SEE ALSO
-.Xr ioctl 2 ,
-.Xr grf 4
-.Sh BUGS
-Not tested for all configurations of scan board and frame buffer memory boards.
+.Xr wsdisplay 4 ,
+.Xr wscons 4
Index: src/share/man/man4/man4.hp300/gbox.4
diff -u src/share/man/man4/man4.hp300/gbox.4:1.5 src/share/man/man4/man4.hp300/gbox.4:1.6
--- src/share/man/man4/man4.hp300/gbox.4:1.5 Mon Mar 22 18:58:31 2010
+++ src/share/man/man4/man4.hp300/gbox.4 Wed Feb 9 14:13:09 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: gbox.4,v 1.5 2010/03/22 18:58:31 joerg Exp $
+.\" $NetBSD: gbox.4,v 1.6 2011/02/09 14:13:09 tsutsui Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -33,7 +33,7 @@
.\"
.\" from: @(#)gb.4 8.1 (Berkeley) 6/9/93
.\"
-.Dd June 9, 1993
+.Dd February 9, 2011
.Dt GB 4 hp300
.Os
.Sh NAME
@@ -41,6 +41,10 @@
.Nd
.Tn HP98700
``Gatorbox'' graphics device interface
+.Sh SYNOPSIS
+.Cd "gbox* at intio?"
+.Cd "gbox* at dio? scode ?"
+.Cd "wsdisplay* at gbox?"
.Sh DESCRIPTION
This driver is for the
.Tn HP98700
@@ -75,104 +79,6 @@
The
.%T 98700H Installation Guide
contains further configuration information.
-.Pp
-The
-.Xr ioctl 2
-calls supported by the
-.Bx
-system for the Gatorbox are:
-.Bl -tag -width indent
-.It Dv GRFIOCGINFO
-Get Graphics Info
-.Pp
-Get info about device, setting the entries in the
-.Em grfinfo
-structure, as defined in
-.In hpdev/grfioctl.h .
-For the standard 98700, the number of planes should be 4. The number of
-colors would therefore be 15, excluding black. With the 98701 option installed
-there will be another 4 planes for a total of 8, giving 255 colors.
-.It Dv GRFIOCON
-Graphics On
-.Pp
-Turn graphics on by enabling
-.Tn CRT
-output. The screen will come on, displaying
-whatever is in the frame buffer, using whatever colormap is in place.
-.It Dv GRFIOCOFF
-Graphics Off
-.Pp
-Turn graphics off by disabling output to the
-.Tn CRT .
-The frame buffer contents
-are not affected.
-.It Dv GRFIOCMAP
-Map Device to user space
-.Pp
-Map in control registers and framebuffer space. Once the device file is
-mapped, the frame buffer structure is accessible.
-The frame buffer structure describing the 98700
-is given in
-.In hpdev/grf_gbreg.h .
-.It Dv GRFIOCUNMAP
-Unmap Device
-.Pp
-Unmap control registers and framebuffer space.
-.Pp
-For further information about the use of ioctl see the man page.
-.El
-.Sh FILES
-.Bl -tag -width /dev/crt98700 -compact
-.It Pa /dev/grf?
-.Bx
-special file
-.It Pa /dev/crt98700
-.Tn HP-UX
-.Em starbase
-special file
-.El
-.Sh EXAMPLES
-A small example of opening, mapping and using the device is given below.
-For more examples of the details on the behavior of the device, see the device
-dependent source files for the X Window System, in the
-.Pa /usr/src/new/X/libhp.fb
-directory.
-.Bd -literal -offset indent
-struct gboxfb *gbox;
-u_char *Addr, frame_buffer;
-struct grfinfo gi;
-int disp_fd;
-
-disp_fd = open("/dev/grf0",1);
-
-if (ioctl (disp_fd, GRFIOCGINFO, \*[Am]gi) \*[Lt] 0) return -1;
-
-(void) ioctl (disp_fd, GRFIOCON, 0);
-
-Addr = (u_char *) 0;
-if (ioctl (disp_fd, GRFIOCMAP, \*[Am]Addr) \*[Lt] 0) {
-(void) ioctl (disp_fd, GRFIOCOFF, 0);
-return -1;
-}
-gbox = (gboxfb *) Addr; /* Control Registers */
-frame_buffer = (u_char *) Addr + gi.gd_regsize; /* Frame buffer memory */
-.Ed
-.Sh DIAGNOSTICS
-None under
-.Bx .
-.Tn HP-UX
-The
-.Tn CE.utilities/Crtadjust
-programs must be used.
-.Sh ERRORS
-.Bl -tag -width [EINVAL]
-.It Bq Er ENODEV
-no such device.
-.It Bq Er EBUSY
-Another process has the device open.
-.It Bq Er EINVAL
-Invalid ioctl specification.
-.El
.Sh SEE ALSO
-.Xr ioctl 2 ,
-.Xr grf 4
+.Xr wsdisplay 4 ,
+.Xr wscons 4
Index: src/share/man/man4/man4.hp300/rbox.4
diff -u src/share/man/man4/man4.hp300/rbox.4:1.5 src/share/man/man4/man4.hp300/rbox.4:1.6
--- src/share/man/man4/man4.hp300/rbox.4:1.5 Mon Mar 22 18:58:31 2010
+++ src/share/man/man4/man4.hp300/rbox.4 Wed Feb 9 14:13:09 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: rbox.4,v 1.5 2010/03/22 18:58:31 joerg Exp $
+.\" $NetBSD: rbox.4,v 1.6 2011/02/09 14:13:09 tsutsui Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -33,7 +33,7 @@
.\"
.\" from: @(#)rb.4 8.1 (Berkeley) 6/9/93
.\"
-.Dd September 10, 2001
+.Dd February 9, 2011
.Dt RBOX 4 hp300
.Os
.Sh NAME
@@ -44,6 +44,7 @@
.Sh SYNOPSIS
.Cd "rbox* at intio?"
.Cd "rbox* at dio? scode ?"
+.Cd "wsdisplay* at rbox?"
.Sh DESCRIPTION
This driver is for the
.Tn HP98720
@@ -59,113 +60,6 @@
At the internal address it will be the ``preferred'' console device.
The hardware installation manual describes the procedure for
setting these values.
-.Pp
-A user process communicates to the device initially by means of
-.Xr ioctl 2
-calls. For the
-.Tn HP-UX
-.Xr ioctl 2
-calls supported, refer to
-.Tn HP-UX
-manuals.
-The
-.Bx
-calls supported are:
-.Bl -tag -width indent
-.It Dv GRFIOCGINFO
-Get Graphics Info
-.Pp
-Get info about device, setting the entries in the
-.Ar grfinfo
-structure, as defined in
-.In hpdev/grfioctl.h .
-For the standard 98720, the number of planes should be 4. The number of
-colors would therefore be 15, excluding black. If one 98722A frame buffer
-board is installed, there will still be 4 planes, with the 4 planes on the
-colormap board becoming overlay planes. With each additional 98722 frame
-buffer board 4 planes will be added up to a maximum of 32 planes total.
-.It Dv GRFIOCON
-Graphics On
-.Pp
-Turn graphics on by enabling
-.Tn CRT
-output. The screen will come on, displaying
-whatever is in the frame buffer, using whatever colormap is in place.
-.It Dv GRFIOCOFF
-Graphics Off
-.Pp
-Turn graphics off by disabling output to the
-.Tn CRT .
-The frame buffer contents
-are not affected.
-.It Dv GRFIOCMAP
-Map Device to user space
-.Pp
-Map in control registers and framebuffer space. Once the device file is
-mapped, the frame buffer structure is accessible. The structure describing
-the 98720 is defined in
-.Pa hpdev/grf_rbreg.h .
-.El
-.Sh FILES
-.Bl -tag -width /dev/MAKEDEV.hpux -compact
-.It Pa /dev/grf?
-.Bx
-special file
-.It Pa /dev/crt98720
-.It Pa /dev/ocrt98720
-.Tn HP-UX
-.Em starbase
-special files
-.It Pa /dev/MAKEDEV.hpux
-script for creating
-.Tn HP-UX
-special files
-.El
-.Sh EXAMPLES
-This is a short segment of code showing how the device is opened and mapped
-into user process address space assuming that it is grf0:
-.Bd -literal
-struct rboxfb *rbox;
-u_char *Addr, frame_buffer;
-struct grfinfo gi;
-int disp_fd;
-
-disp_fd = open("/dev/grf0",1);
-
-if (ioctl (disp_fd, GRFIOCGINFO, \*[Am]gi) \*[Lt] 0) return -1;
-
-(void) ioctl (disp_fd, GRFIOCON, 0);
-
-Addr = (u_char *) 0;
-if (ioctl (disp_fd, GRFIOCMAP, \*[Am]Addr) \*[Lt] 0) {
- (void) ioctl (disp_fd, GRFIOCOFF, 0);
- return -1;
-}
-rbox = (rboxfb *) Addr; /* Control Registers */
-frame_buffer = (u_char *) Addr + gi.gd_regsize; /* Frame buffer memory */
-.Ed
-.Sh DIAGNOSTICS
-None under
-.Bx .
-The
-.Tn HP-UX
-.Tn CE.utilities
-must be used.
-.Sh ERRORS
-.Bl -tag -width [EINVAL]
-.It Bq Er ENODEV
-no such device.
-.It Bq Er EBUSY
-Another process has the device open.
-.It Bq Er EINVAL
-Invalid ioctl specification.
-.El
.Sh SEE ALSO
-.Xr ioctl 2 ,
-.Xr grf 4 ,
-.Xr ite 4
-.Pp
-For extensive code examples using the
-Renaissance, see the X device dependent source.
-.Sh BUGS
-Not tested for all configurations of scan board and frame buffer memory boards.
+.Xr wsdisplay 4 ,
+.Xr wscons 4
Index: src/share/man/man4/man4.hp300/topcat.4
diff -u src/share/man/man4/man4.hp300/topcat.4:1.5 src/share/man/man4/man4.hp300/topcat.4:1.6
--- src/share/man/man4/man4.hp300/topcat.4:1.5 Mon Mar 22 18:58:31 2010
+++ src/share/man/man4/man4.hp300/topcat.4 Wed Feb 9 14:13:09 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: topcat.4,v 1.5 2010/03/22 18:58:31 joerg Exp $
+.\" $NetBSD: topcat.4,v 1.6 2011/02/09 14:13:09 tsutsui Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -33,7 +33,7 @@
.\"
.\" from: @(#)tc.4 8.1 (Berkeley) 6/9/93
.\"
-.Dd September 10, 2001
+.Dd February, 2011
.Dt TOPCAT 4 hp300
.Os
.Sh NAME
@@ -44,6 +44,7 @@
.Sh SYNOPSIS
.Cd "topcat* at intio?"
.Cd "topcat* at dio? scode ?"
+.Cd "wsdisplay* at topcat?"
.Sh DESCRIPTION
This driver is for the
.Tn HP98544 ,
@@ -67,112 +68,6 @@
Terminal Emulator) defaults. The device can also be used as a graphics output
device.
.Pp
-The
-.Xr ioctl 2
-calls supported by the
-.Bx
-system for the Topcat are:
-.Bl -tag -width GRFIOCGINFO
-.It Dv GRFIOCGINFO
-Get Graphics Info
-.Pp
-Get info about device, setting the entries in the
-.Ar grfinfo
-structure, as defined in
-.In hpdev/grfioctl.h .
-For the 98544 or 98549,
-the number of planes should be 1, as they are monochrome devices.
-The number of planes for a 98545 is 4, translating to 15 colors,
-excluding black.
-The 98547 and 98548 cards have 6 planes, yielding 63 colors and black.
-The 98550 has 8 planes, yielding 255 colors and black.
-The displayed frame buffer size for the 98549 and 98550 is 2048 x 1024,
-for the others it is 1024 x 768.
-.It Dv GRFIOCON
-Graphics On
-.Pp
-Turn graphics on by enabling
-.Tn CRT
-output. The screen will come on, displaying
-whatever is in the frame buffer, using whatever colormap is in place.
-.It Dv GRFIOCOFF
-Graphics Off
-.Pp
-Turn graphics off by disabling output to the
-.Tn CRT .
-The frame buffer contents
-are not affected.
-.It Dv GRFIOCMAP
-Map Device to user space
-.Pp
-Map in control registers and framebuffer space. Once the device file is
-mapped, the frame buffer structure is accessible. The frame buffer structure
-describing Topcat/Catseye devices is defined in
-.In hpdev/grf_tcreg.h .
-.El
-.Pp
-For further information about the use of
-.Xr ioctl 2
-see the man page.
-.Sh FILES
-.Bl -tag -width /dev/MAKEDEV.hpux -compact
-.It Pa /dev/grf?
-.Bx
-special file
-.It Pa /dev/crt9837
-.It Pa /dev/crt98550
-.Tn HP-UX
-.Em starbase
-special files
-.It Pa /dev/MAKEDEV.hpux
-script for creating
-.Tn HP-UX
-special files
-.El
-.Sh EXAMPLES
-A small example of opening, mapping and using the device is given below.
-For more examples of the details on the behavior of the device, see the device
-dependent source files for the X Window System, in the
-.Pa /usr/src/new/X/libhp
-directory.
-.Bd -literal
-struct tcboxfb *tc;
-u_char *Addr, frame_buffer;
-struct grfinfo gi;
-int disp_fd;
-
-disp_fd = open("/dev/grf0",1);
-
-if (ioctl (disp_fd, GRFIOCGINFO, \*[Am]gi) \*[Lt] 0) return -1;
-
-(void) ioctl (disp_fd, GRFIOCON, 0);
-
-Addr = (u_char *) 0;
-if (ioctl (disp_fd, GRFIOCMAP, \*[Am]Addr) \*[Lt] 0) {
- (void) ioctl (disp_fd, GRFIOCOFF, 0);
- return -1;
-}
-tc = (tcboxfb *) Addr; /* Control Registers */
-frame_buffer = (u_char *) Addr + gi.gd_regsize; /* Frame buffer memory */
-.Ed
-.Sh DIAGNOSTICS
-None under
-.Bx .
-.Tn HP-UX
-.Tn /usr/CE.utilities/Crtadjust
-programs must be used.
-.Sh ERRORS
-.Bl -tag -width [EINVAL]
-.It Bq Er ENODEV
-no such device.
-.It Bq Er EBUSY
-Another process has the device open.
-.It Bq Er EINVAL
-Invalid
-.Xr ioctl 2
-specification.
-.El
.Sh SEE ALSO
-.Xr ioctl 2 ,
-.Xr grf 4 ,
-.Xr ite 4
+.Xr wsdisplay 4 ,
+.Xr wscons 4
Index: src/share/man/man4/man4.hp300/hyper.4
diff -u src/share/man/man4/man4.hp300/hyper.4:1.3 src/share/man/man4/man4.hp300/hyper.4:1.4
--- src/share/man/man4/man4.hp300/hyper.4:1.3 Wed Apr 30 13:10:56 2008
+++ src/share/man/man4/man4.hp300/hyper.4 Wed Feb 9 14:13:09 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: hyper.4,v 1.3 2008/04/30 13:10:56 martin Exp $
+.\" $NetBSD: hyper.4,v 1.4 2011/02/09 14:13:09 tsutsui Exp $
.\"
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd September 10, 2001
+.Dd February 9, 2011
.Dt HYPER 4 hp300
.Os
.Sh NAME
@@ -37,8 +37,9 @@
``Hyperion'' graphics device interface
.Sh SYNOPSIS
.Cd "hyper* at dio? scode ?"
+.Cd "wsdisplay* at hyper?"
.Sh DESCRIPTION
This driver is for the Hyperion monochrome framebuffer.
.Sh SEE ALSO
-.Xr grf 4 ,
-.Xr ite 4
+.Xr wsdisplay 4 ,
+.Xr wscons 4
