is the example is quite spartan.
As pointed out by Bruce there are *three* different filenames being used:
cvs FREEBSD.README
groff FREEBSD-upgrade
libgmp FREEBSD-upgrade
libpcap FREEBSD-upgrade
tcpdump FREEBSD-upgrade
traceroute FREEBSD-upgrade
tcl README.FreeBSD
The handbook states "README.FreeBSD". Perhaps this should be changed?
This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.
Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.
pointed out by Rick Robinson. Found and fixed some grammar problems
at the same time.
Note: the reason for avoiding contractions is two-fold:
1) It makes the text easier to understand for people who speak English
as a second language.
2) Expanding the contractions often reveals poorly worded passages.