From owner-freebsd-doc@FreeBSD.ORG  Tue Dec 21 21:46:51 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 8A76C16A4CE
	for <freebsd-doc@freebsd.org>; Tue, 21 Dec 2004 21:46:51 +0000 (GMT)
Received: from rosebud.otenet.gr (rosebud.otenet.gr [195.170.0.26])
	by mx1.FreeBSD.org (Postfix) with ESMTP id C34C043D2F
	for <freebsd-doc@freebsd.org>; Tue, 21 Dec 2004 21:46:50 +0000 (GMT)
	(envelope-from keramida@freebsd.org)
Received: from gothmog.gr (patr530-a081.otenet.gr [212.205.215.81])
	iBLLklmV019833;	Tue, 21 Dec 2004 23:46:48 +0200
Received: from gothmog.gr (gothmog [127.0.0.1])
	by gothmog.gr (8.13.1/8.13.1) with ESMTP id iBLLkfmM001485;
	Tue, 21 Dec 2004 23:46:41 +0200 (EET)
	(envelope-from keramida@freebsd.org)
Received: (from giorgos@localhost)
	by gothmog.gr (8.13.1/8.13.1/Submit) id iBLLkfKY001484;
	Tue, 21 Dec 2004 23:46:41 +0200 (EET)
	(envelope-from keramida@freebsd.org)
Date: Tue, 21 Dec 2004 23:46:40 +0200
From: Giorgos Keramidas <keramida@freebsd.org>
To: Matteo Riondato <rionda@gufi.org>
Message-ID: <20041221214640.GB1340@gothmog.gr>
References: <1103658469.8516.53.camel@kaiser.sig11.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <1103658469.8516.53.camel@kaiser.sig11.org>
cc: freebsd-doc@freebsd.org
Subject: Re: Explaination of an extract from the handbook Firewall Section
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 21 Dec 2004 21:46:51 -0000

On 2004-12-21 20:47, Matteo Riondato <rionda@gufi.org> wrote:
> <para><literal>device pf</literal> tells the compile to include
>        Packet Filter as part of its core kernel.</para>
>
> What is "the compile"? I assume it should be "the compiler" but I can be
> wrong...
>
> What is "its" referred to? I don't think a "compile" (or a "compiler"
> does have core kernel.
>
> Is there a missing word?

Hi,

Good catch.  The nearby paragraphs use "the foo option _enables_ bar"
for describing kernel options.

Does the following change make this paragraph easier to understand?

% Index: chapter.sgml
% ===================================================================
% RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/firewalls/chapter.sgml,v
% retrieving revision 1.10
% diff -u -r1.10 chapter.sgml
% --- chapter.sgml        16 Dec 2004 22:45:35 -0000      1.10
% +++ chapter.sgml        21 Dec 2004 21:44:11 -0000
% @@ -245,8 +245,9 @@
%  device pflog
%  device pfsync</programlisting>
%
% -      <para><literal>device pf</literal> tells the compile to include
% -        Packet Filter as part of its core kernel.</para>
% +      <para><literal>device pf</literal> enables support for the
% +       <quote>Packet Filter</quote> firewall to the resulting
% +       kernel.</para>
%
%        <para><literal>device pflog</literal> enables the optional
%          &man.pflog.4; pseudo network device which can be used to log traffic