[src/trunk]: src/share/man/man9 document recent changes

[macallan <macallan%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/b289b974aa7c
branches:  trunk
changeset: 772709:b289b974aa7c
user:      macallan <macallan%NetBSD.org@localhost>
date:      Fri Jan 13 16:06:20 2012 +0000

description:
document recent changes

diffstat:

 share/man/man9/rasops.9 |   7 +++++--
 share/man/man9/wsfont.9 |  25 +++++++++++++++++++------
 2 files changed, 24 insertions(+), 8 deletions(-)

diffs (78 lines):

diff -r 484458430c78 -r b289b974aa7c share/man/man9/rasops.9
--- a/share/man/man9/rasops.9   Fri Jan 13 16:05:14 2012 +0000
+++ b/share/man/man9/rasops.9   Fri Jan 13 16:06:20 2012 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: rasops.9,v 1.12 2010/12/02 12:54:13 wiz Exp $
+.\"     $NetBSD: rasops.9,v 1.13 2012/01/13 16:06:20 macallan Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -168,7 +168,10 @@
 .Fa wantrows
 and
 .Fa wantcols
-are the number of rows and columns we'd like.
+are the number of rows and columns we'd like. Passing zero for either one of
+them uses the default - normally 80x25 but it can be changed with
+options RASOPS_DEFAULT_WIDTH=80
+options RASOPS_DEFAULT_HEIGHT=25
 If calling
 .Fn rasops_reconfig
 to change the font and ri_wsfcookie \*[Ge] 0, you must call
diff -r 484458430c78 -r b289b974aa7c share/man/man9/wsfont.9
--- a/share/man/man9/wsfont.9   Fri Jan 13 16:05:14 2012 +0000
+++ b/share/man/man9/wsfont.9   Fri Jan 13 16:06:20 2012 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: wsfont.9,v 1.16 2011/06/13 15:24:21 nonaka Exp $
+.\"     $NetBSD: wsfont.9,v 1.17 2012/01/13 16:06:20 macallan Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -49,10 +49,10 @@
 .Fn wsfont_init "void"
 .Ft int
 .Fn wsfont_matches "struct wsdisplay_font *font" "const char *name" \
-"int width" "int height" "int stride"
+"int width" "int height" "int stride" "int flags"
 .Ft int
 .Fn wsfont_find "const char *name" "int width" "int height" "int stride" \
-"int bitorder" "int byteorder"
+"int bitorder" "int byteorder" "int flags"
 .Ft int
 .Fn wsfont_add "struct wsdisplay_font *font" "int copy"
 .Ft int
@@ -126,11 +126,14 @@
 with the specifications
 .Fa name ,
 .Fa width ,
-.Fa height
+.Fa height ,
+.Fa stride 
 and
-.Fa stride .
+.Fa flags .
 Return zero if not matched and non-zero if matched.
-.It Fn wsfont_find "name" "width" "height" "stride" "bitorder" "byteorder"
+The "flags" parameter has the same meaning as in 
+.Fn wsfont_find .
+.It Fn wsfont_find "name" "width" "height" "stride" "bitorder" "byteorder" "flags"
 Find the font called
 .Fa name
 from the fonts loaded into the kernel.
@@ -161,6 +164,16 @@
 The font is ordered right to left.
 .El
 .Pp
+The
+.Fa flags
+parameter determines what type of font can be returned.
+Any combination of the following values is allowed:
+.Bl -tag -width compact
+.It WSFONT_FIND_BITMAP
+To search bitmap fonts,
+.It WSFONT_FIND_ALPHA
+to search anti-aliased fonts.
+.El
 When more flexibility is required,
 .Fn wsfont_enum
 should be used.