From owner-freebsd-doc@FreeBSD.ORG Mon Jan 5 03:01:26 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3261C16A4CE for ; Mon, 5 Jan 2004 03:01:26 -0800 (PST) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 07A6643D31 for ; Mon, 5 Jan 2004 03:01:24 -0800 (PST) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) by abigail.blackend.org (8.12.9/8.12.3) with ESMTP id i05B1LBb078038; Mon, 5 Jan 2004 12:01:21 +0100 (CET) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.9/8.12.3/Submit) id i05B1KJc078037; Mon, 5 Jan 2004 12:01:20 +0100 (CET) (envelope-from marc) Date: Mon, 5 Jan 2004 12:01:20 +0100 From: Marc Fonvieille To: Rostislav Krasny Message-ID: <20040105120120.A77825@abigail.blackend.org> References: <20040105102850.61513.qmail@web14806.mail.yahoo.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20040105102850.61513.qmail@web14806.mail.yahoo.com>; from rosti_bsd@yahoo.com on Mon, Jan 05, 2004 at 02:28:50AM -0800 X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.8-STABLE cc: freebsd-doc@freebsd.org Subject: Re: Confusing reuse of "enable the swap file" phrase in the Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 05 Jan 2004 11:01:26 -0000 On Mon, Jan 05, 2004 at 02:28:50AM -0800, Rostislav Krasny wrote: > 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". > In fact you really enable the swapfile via the mentioned line in the rc.conf file. As any rc.conf addition, you need a reboot. If you want to enable directly the swapfile (i.e. without a reboot) the text gives you the right command. This is similar to for example sshd which can be enable via a specific line in rc.conf and a reboot of the box or directly via the sshd command at prompt. > 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? > I agree, it's not consistent. Marc