I know it isn't a good thing to have many copy-and-pasted contents
(set file descriptions etc) in all MD files, but it's much more annoying
to maintain a bunch of .if \n [${MACHINE}] conditionals for all ports
and maintainers rarely notice that they also have to prepare or update
MD contents in MI content file with messy ifdefs.
XXX: of course common text should be shared by mdoc macro etc.
but I doubt playing mdoc(7) is really worth...
from common/xfer with messy mdoc .if conditionals
into MD xfer files so that developers can see
what contents are missing or obsolete and should be
written or updated
- remove some useless MD description for maintainability
XXX: still a bunch of unmaintained .if \n [${MACHINE}] in common files
Cleanup dd options accordingly to the following policy:
1) put if, of, bs, conv in this order
2) for reading/writing from/to disk don't use sync
4) reading from tape - use sync
3) writing to tape - use osync
Noted by Don Yuniskis (auryn at gci-net.com) via install/13749. Thanks!
Reviewed by <martin>. Thank you!
sun-rbootd package for NetBSD/hp300 and OpenBSD/hp300, which
works on more other OSs including SunOS 4.x, Solaris 2.x, HP-UX 10,
HP-UX 9, NEWS-OS 4.x, FreeBSD, and Linux.
kernel is incompatible with older version of SYS_UBOOT).
add section headings
describe how to prepare the miniroot easier than normal installation methods
mention that you have to reboot manually after miniroot is done
and instead generate them each and every time (twice!).
Based on a suggestion from Alan Barrett, allow setting MAKETOC=no
to permit rebuilding the install notes without regenerating the
.toc files, to allow more speedy debugging of markup changes.
- "this is the xxx major release"
- features added and bugs fixed in 1.5
- use .Nx instead of NetBSD
- use .Sq instead of ' [...] ' or ` [ ... ] '
- use .Dq instead of " [...] "
- update for 1.5 (still more MD stuff to check)
- use new macros in ../common/macros as appropriate
- introduce some CONSISTENCY between the various ports' install docs
- use various mdoc macros as appropriate, including .Li, .Pa, .Sy, and .Ic.
- migrate more stuff into ../common/*
- whitespace cleanup
- lots of other little things i'm sure...
riz