actually generate hypertext links to the man pages, like they do
know when the pages themselves are formatted. The obvious problem
is that if you aren't a man page, you don't know where the man
pages are.
tweaks to the "Quick install for the impatient", particularly changing the
recommendation to MS-DOS floppy with bootloader and kernel instead of
boot floppy image
common/sysinst
add .To 2 tags for macppc-specific sections
common/postinstall
change tlp0 to de0 in description of typical ethernet interface
Mention how to manually create /dev entries, since the suggested "Re-install
sets" option doesn't automatically do this (leaving the user without
/dev/console)
.Te adds an entry at a specified depth and also outputs the entry name
in the output stream, .To "only" adds the entry. .To is necessaary where
markup issues prevent the use of .Te.
all on page one and they add needless clutter. Additionally
doc2html doesn't output a tag for them, so we cannot link to them.
Lower indent level for Ss and Ss2
Add special HTML support: emit an HREF on each TOC line. There's some
nasty kludging with extending the dot-leader tab stop by the width
of the href, but that's life in mdoc2html.
TOCs need to be regenerated, but I'm not going to bother for a while.
This makes it _much_ more user-friendly, as it allows users
to skip to the parts they want easily.
At present, the TOCs are generated files, and can be regenerated
with "make tocs" (probably has to be run twice to account for
the size of the table itself).
TOCs are named INSTALL.{PostScript,ASCII,HTML,more}.toc instead of
INSTALL.{ps,txt,html,more}.toc because that's what \*[format]
expands to.
quick start info about bootable CD-R image
common/sysinst:
point to FAQ entry on missing hard drives
macppc/hardware:
fix info on D-Link 530TX (vr) and 530TX+ (rtk)
Some PowerBooks (FireWire and G4) won't work with FirmWare update 4.1.8,
need to use -current
mention that AirPort/AirMac 802.11b wireless is supported in -current
mention that CPU upgrades are supported
macppc/install:
point to partition numbering explanation in FAQ
fix kernel name on bootable cd-rom and mention case sensitivity
macppc/prep:
mention that people unfamiliar with MacOS should mail the port-macppc
list.
Some PowerBooks (FireWire and G4) won't work with FirmWare update 4.1.8,
need to use -current
Umax S900 isn't supported by System Disk
describe how to use Disk Copy to create the bootable floppy
point to partition numbering explanation in FAQ
point to ISO mirror site list
quick guide for impatient reword netboot section, also macppc can netboot
macppc/hardware:
mention that some older models not listed might work, but are untested
mention that some iMac (Bondi Blue) and PowerMacintosh G3 (Blue and White)
systems have keyboard problems
mention that ttya is "modem" port, and ttyb is "printer" port
macppc/install:
describe the keyboard workaround for PM G3 (B&W), and that 1.4.3 works
fine for it and the iMac (Bondi)
macppc/prep:
make the whole BootROM/Open Firmware distinction clearer
describe that some models have to remove internal modem or set
input/output devices to ttyb since int modem usurps ttya.
macppc/whatis:
mention important changes, such as ELF, binary compatability, newly
supported models that don't require kernel patches, and that the install
procedure described now works for all models (i.e. Open Firmware 3
machines with only one hard drive).
identifisers => identifiers
wording in the 1.5.1 section release explanation
Xr ifconfig(8) for cloning pseudointerfaces
Consistently reference security advisories.
(XXX: do we need to explain them better? a footnote?)
wording of dhcp bullet
\(em
s/together with a 1.5 kernel/running under a 1.5 kernel/
macppc/install:
add description of "bad partition number, using 0no bootable HFS
partition" error message
mention that boot floppy must be booted from Open Firmware, you don't just
pop it in the floppy drive like a normal MacOS boot floppy.
example of how to read directory of CD or HD from OF (I think I got the
backslashes generated properly)
describe how to boot a kernel from an HFS partition
reiterate that some OF 1.0.5 machines can't seem to netboot
reverse recommendation of ultra0 and ultra1 busses
common/postinstall:
mention stty erase '^h' or '^?'
macppc/hardware:
mention that Sonnet Tempo ATA/66 card doesn't yet work with macppc
mention that adaptec 294x cards don't boot
mention that promise ultra66 works, but isn't bootable
macppc/prep:
mention that A/UX style partitions are interpreted as NetBSD-style
partitions, also that they're unreadable from MacOS
also describe the printenv command and give examples
mention that you can't hold down command-option-o-f on a PS/2 keyboard
rehash the partitioning section to describe under what conditions you can
have a drive with MacOS and NetBSD partitions, and what are the criteria
for a drive to be bootable under NetBSD.
define what "boot media" and "distribution media" mean
macppc/install:
corrected the text in example of booting system
corrected partition number to use in example of booting from HFS partition
added example of how to use MacOS X to print partition table using pdisk
macppc/prep:
actually drive setup 1.8.1 (ships with MacOS 9.0) works too
actually describe what netbsd.ram.gz is (installation kernel)
common/postinstall:
macppc uses vt100 for console, not vt220
describe how to mount root filesystem to edit /etc/rc.conf
order of recommendations for installation methods.
macppc/hardware:
update list of unsupported models
macppc/prep:
mention that ofwboot.elf is obsoleted, and all users should be using
ofwboot.xcf instead
link to partitioning HOW-TO on website
added some info on the "official" NetBSD/macppc-1.5.1 CD-R image
added some info on cdrecord
added note that netboot must be from on-board ethernet
macppc/install:
added a few more details to some of the open firmware error messages
reordered error messages to be in order user might encounter them
removed "pciide0:0:0: lost interrupt" since this is fixed in 1.5.1
added "TFTP timeout" and explanation to list of possible problems
point to macppc X11R6 HOW-TO
common/postinstall:
point to macppc X11R6 HOW-TO
common/xfer:
recommend waiting until later to create media for distribution sets
common/sysinst:
control-C to stop sysint, but added that you can re-run it from the
command prompt, no need to reboot.
added an example of what the sysinst main menu looks like
I've organized the topics by Open Firmware version, since many users found
the old scheme way too confusing (clause out Open Firmware version-specific
content).
It's still really confusing to read (particularly the .txt version which
doesn't adequately distinguish headings from the body)
Also added a bit more info on partitioning vs. OF version.
capitalize X Window System
kill gratuitous newline
periods after sentences.
s/Domain Name Service/the Domain Name System/
s/new install system/current install system/
Be consistent and say 'ip address' not 'ip number'
Grammar (comma)
s/GMT/UTC/
Update document date.
Periods at ends of sentences.
Don't hyphenate NetBSD (for .ps versions)
Avoid wording that implies the current release is 1.5.
Emdashes are \(em and not -- and especially not '-'; no surrounding whitespace
bound checking => bounds checking
Grammar (including parallelism, articles, etc.)
Tagged lists spaced from largest tag.
Semicolons for list delimitters where commas are ambiguous.
Colons after text before examples.
s/1.4 or later/1.4 or prior/
Simon Burge is a pmax portmaster now
Havard Eidnes -> H\(oavard Eidnes
Jaromir Dolecek -> Jarom\('ir Dolecek [can we do better?]
note The End
they are suitable (for i386).
* Mention xf86config(1) for ports that use XFree86.
* Since i386 INSTALL kernels do not have symbols, point users at
the symbol files should they need them (hopefully not).
* mention additional kernels in binary/kernel/ dir: GENERIC_LAPTOP, etc
* note that we also include firewall software (besides X, ...)
* don't Xref the BUGS file, as it's gone
* update some file sizes (source .tgz files) to match BETA2
* mention that syssrc contains the source for all architectures
* Sysinst now allows setting root password and timezone - note that.
* Explain how to actually install binary packages, giving some
examples that people may want to install.
* Mention rawrite32 near rawrite.
* Don't show preparation of install tape on i386
* update i386 hardware a bit. This needs to be generated automatically...
* Many minor nits & typos.
sysinst: tsubai-san says that macppc doesn't suffer from install-related
pcmcia interrupt problems. removed those for macppc
upgrade: add conditional for macppc and sparc (don't need to boot
from floppy)
- use .Ic, .Pa, .Key, .Ul, .Tn, .Sq, .Dq as appropriate
- use .Dl instead of .(disp when formatting changes are required (the latter
doesn't cope too well when font change macros are used)
- wrap .Dl blocks with .Pp
- consistently use `file system' instead of `filesystem'
- migrate macppc to common/xfer
- document rc.d in `compatability issues with previous releases' section
- wrap .Dl blocks with .Pp
- use .Ul, .Pa, .Tn, .Bx, ...
- use .Pp after .Ss (since .Ss2 does this, and it looks slightly better)
- add tv@ to releng
- fix up sizes for various sets based on info from tv@ (any errors are
probably due to my conversion rather than his data)
- .Ic commands, .Pa paths, .Tn trade names
- define string `A' to contain the arch name (defaults to the port
name)
- define registers \*A and _\*A if
- deprecate _FOR_RELEASE, and just use FOR_RELEASE
- optimize suggested commands (e.g, tar usage, ...)
- consistently use `@netbsd.org' in email addresses
- remember to thank the people who host the WWW, GNATS, CVS and CVSweb servers
- add blurb about trademark ownership
- update MACHINE_LIST for the 31 ports we support (as of 1.5)
- define registers for MACHINE_ARCH, depending upon \*M; may set one
of the following as appropriate: _m68k, _mips, _powerpc, _sh3
- change to using various new macros added in ../common/macros
and doesn't explicitly provide a .It
- add .(bullet & .bullet), which provide bulleted/hyphenated lists.
(alternates between -bullet & -hyphen at each alternate depth).
.(bullet does .It as well.
- add .(enum & .enum); enumerated list. the former does .It as well
- add .(item & .item); enumerated list. the former does .It as well
- add .Nx*M, which generates `NetBSD/machine', except that `NetBSD'
is done using .Nx so gets the appropriate markup from that
- remove .(note and .note), leaving .(Note and .Note)
- document \*M, \*V, \*[.CURDIR]
- suggest looking in /etc/defaults/rc.conf or rc.conf(5) for rc.conf settings
- spell "separate" correctly
- use "third party" instead of "3rd party"
- move notes about /etc/localtime; sysinst does it for us
- update copyright date
bjh21