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

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


Hello.

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
desired.
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
http://search.yahoo.com/top2003



More information about the freebsd-doc mailing list