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
to call a shell script which outputs nothing if the file is not present.
Remove the "whatis" file for ports where it does not contain anything
useful and hasn't been updated for years. OK tsutsui@, hubertf@.
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...
