remove please from manual pages
ok jmc@ sthen@ millert@

delete bogus trailing comma from .Nm in NAME section

obvious cases of missing .An;
found with the new mandoc(1) MANDOCERR_AN_MISSING warning;
no text changes

obvious .Pa fixes; found with mandocdb(8)

Fix obvious typo in macro, bus_space_map() is .Fn, not .Fa.
Found with mandocdb(8).

Replace old-fashioned .Fd by new-fangled .In for #include lines.
Diff from Jan Klemkow <j dot klemkow at wemelug dot de> on tech@.
No objection from jmc@ against this type of change.

zap trailing whitespace;

remove the EXPECTED CHANGES TO THE BUS_SPACE FUNCTIONS section. talk is
cheap, if we wanted this stuff there'd be a diff by now.

requested by miod@ and kettenis@

useless comments are useless

bus_space_{read,write}_N dont take different arguments to their non raw
counterparts, so list them separately to the ones that do.

document bus_space_{read,write}_raw_N(). needs some polishing...

Document bus_space_mmap(9) from NetBSD with some tweaks by jmc@.

Make sure all platforms understand the flags argument of bus_space_map() and
bus_space_alloc() as a bitmask of flags, and not a boolean controlling
cacheability; and make sure the three MI BUS_SPACE_MAP_xxx values documented
in the manual page are defined on all platforms as well.

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@

convert to new .Dd format;

prefer `buses' to `busses' for the noun plural;

heh, two different spellings in the same sentence: co-exist and coexist;
prefer coexist, since all other man pages do too, and oxford agree.

escape `.' at eol to avoid double spacing issue;

ethernet -> Ethernet

Grammo ok many.

Tiny typo

list/display fixes, and whitespace;

- section reorder
- macro fixes
- kill whitespace at EOL
- use .Ox for OpenBSD, .Fx for FreeBSD

uncomment the bus_space_vaddr() since at least sparc64 has it

typos;

VOP, crypto and disklabel ok tedu@
audio(9) ok naddy@

missing comma; hiten@uk.FreeBSD.org

Powered by @mantoya:
o) start new sentence on a new line;
o) minor mdoc fixes;
millert@ ok

Tip of the day: www.mpechismazohist.com

speling; jsyn@nthought.com

make raw functions take count' to distract from evil bus.h remarks

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

REVERT TO PREVIOUS STATE OF AFFAIR.

If those pages are different from the NetBSD version, maybe there's a
reason ?

Like, possibly, I just read our source code, which just happens to do
things in DIFFERENT ways than NetBSD does ?

As far as the added pages go, they obviously haven't been checked against
actual code as well, hence they're worse than useless, since a large part
of the information is definitely misleading.

Add/update some man9 pages from NetBSD

delete bogus trailing comma from .Nm in NAME section

obvious cases of missing .An;
found with the new mandoc(1) MANDOCERR_AN_MISSING warning;
no text changes

obvious .Pa fixes; found with mandocdb(8)

Fix obvious typo in macro, bus_space_map() is .Fn, not .Fa.
Found with mandocdb(8).

Replace old-fashioned .Fd by new-fangled .In for #include lines.
Diff from Jan Klemkow <j dot klemkow at wemelug dot de> on tech@.
No objection from jmc@ against this type of change.

zap trailing whitespace;

remove the EXPECTED CHANGES TO THE BUS_SPACE FUNCTIONS section. talk is
cheap, if we wanted this stuff there'd be a diff by now.

requested by miod@ and kettenis@

useless comments are useless

bus_space_{read,write}_N dont take different arguments to their non raw
counterparts, so list them separately to the ones that do.

document bus_space_{read,write}_raw_N(). needs some polishing...

Document bus_space_mmap(9) from NetBSD with some tweaks by jmc@.

Make sure all platforms understand the flags argument of bus_space_map() and
bus_space_alloc() as a bitmask of flags, and not a boolean controlling
cacheability; and make sure the three MI BUS_SPACE_MAP_xxx values documented
in the manual page are defined on all platforms as well.

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@

convert to new .Dd format;

prefer `buses' to `busses' for the noun plural;

heh, two different spellings in the same sentence: co-exist and coexist;
prefer coexist, since all other man pages do too, and oxford agree.

escape `.' at eol to avoid double spacing issue;

ethernet -> Ethernet

Grammo ok many.

Tiny typo

list/display fixes, and whitespace;

- section reorder
- macro fixes
- kill whitespace at EOL
- use .Ox for OpenBSD, .Fx for FreeBSD

uncomment the bus_space_vaddr() since at least sparc64 has it

typos;

VOP, crypto and disklabel ok tedu@
audio(9) ok naddy@

missing comma; hiten@uk.FreeBSD.org

Powered by @mantoya:
o) start new sentence on a new line;
o) minor mdoc fixes;
millert@ ok

Tip of the day: www.mpechismazohist.com

speling; jsyn@nthought.com

make raw functions take count' to distract from evil bus.h remarks

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

REVERT TO PREVIOUS STATE OF AFFAIR.

If those pages are different from the NetBSD version, maybe there's a
reason ?

Like, possibly, I just read our source code, which just happens to do
things in DIFFERENT ways than NetBSD does ?

As far as the added pages go, they obviously haven't been checked against
actual code as well, hence they're worse than useless, since a large part
of the information is definitely misleading.

Add/update some man9 pages from NetBSD