CVS: cvs.openbsd.org: src

[Kenneth R Westerback <krw_(_at_)_cvs_(_dot_)_openbsd_(_dot_)_org>]

CVSROOT:	/cvs
Module name:	src
Changes by:	krw_(_at_)_cvs_(_dot_)_openbsd_(_dot_)_org	2001/02/21 17:54:46

Added files:
	share/man/man9 : bus_space.9 

Log message:
First attempt at bringing in bus_space.9 from NetBSD.

Changes from NetBSD bus_space.9 v1.15:

1) All references to the following functions were '.\"'d out:

bus_space_read_raw_multi_1
bus_space_read_raw_region_1
bus_space_read_stream_1
bus_space_read_stream_2
bus_space_read_stream_4
bus_space_read_stream_8
bus_space_vaddr
bus_space_write_raw_multi_1
bus_space_write_raw_region_1
bus_space_write_stream_1
bus_space_write_stream_2
bus_space_write_stream_4
bus_space_write_stream_8

2) All references to the following defines were '.\"'d out:

BUS_SPACE_MAP_PREFETCHABLE
BUS_SPACE_MAP_LINEAR

3) The entire COMPATIBILITY section with its discussion of of
__BUS_SPACE_COMPAT_OLDDEFS was deleted as __BUS_SPACE_COMPAT_OLDDEFS
does not seem to be used at all anywhere in the tree.

4) Added the already documented bus_space_alloc() to list of functions
at head of page

5) Added bus_space_set_multi_N(t,h,o,v,c) definitions and descriptions

6) Renamed bus_space_copy_region_N to bus_space_copy_N

7) Replaced *_stream_* documentation with *_raw_* documentation

8) Rename the parameter 'flags' in bus_space_map and bus_space_alloc
to 'cacheable' as that's the only flag we provide. Other more
descriptive parameter names were retained rather than change to
terse one/two letter parameter names used in bus.h

9) Eliminated short lines, made all new sentences start
on new line, deleted extraneous .Pp's, removed some excess
parenthesis, trailing white space, etc.

** Issues with bus_space.9 **

vax/bus.h and mac68k/bus.h still define

bus_space_copy_region_N()

instead of

bus_space_copy_N

like other architectures, though some of the comments do refer to
bus_space_copy_N.

powerpc/bus.h still defines

bus_space_read_raw_multi_1()
bus_space_write_raw_multi_1()

vax/bus.h still defines

BUS_SPACE_MAP_PREFETCHABLE

while vax/bus.h and mac68k/bus.h both still define

BUS_SPACE_MAP_LINEAR