Confusing reuse of "enable the swap file" phrase in the Handbook

Rostislav Krasny rosti_bsd at
Mon Jan 5 10:28:52 UTC 2004


There are two examples of creating a swap file on FreeBSD 4.x/5.x in a
"6.14.3 Swapfiles" section of the Handbook. Both examples have
following three lines:

5. enable the swap file in /etc/rc.conf:
      swapfile="/usr/swap0"   # Set to name of swapfile if aux swapfile
6. Reboot the machine or to enable the swap file immediately, type:

Reuse of "enable the swap file" phrase on these two example steps may
confuse someone. IMHO it is better to change the "enable" word of the
5th steps to something like "define" or "designate".

P.S. Whereas the first and the last steps of both examples are starting
by capital letters the rest are starting by small letters. Shouldn't
all the steps start by the same case letters?

Do you Yahoo!?
Find out what made the Top Yahoo! Searches of 2003

More information about the freebsd-doc mailing list