Bug 74978

Summary: [patch] update handbook: Add chapter 24 to preface
Product: Documentation Reporter: Joel Dahl <joel>
Component: Books & ArticlesAssignee: Giorgos Keramidas <keramida>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
fipref.diff none

Description Joel Dahl 2004-12-12 11:10:26 UTC
The preface in the handbook does not contain any information
about chapter 24 (the "firewalls" chapter), so let's add some!
Comment 1 Giorgos Keramidas freebsd_committer freebsd_triage 2004-12-13 09:51:11 UTC
Responsible Changed
From-To: freebsd-doc->keramida

I'll work with Joel on this.
Comment 2 Giorgos Keramidas freebsd_committer freebsd_triage 2004-12-13 09:51:56 UTC
On 2004-12-12 12:05, Joel Dahl <joel@automatvapen.se> wrote:
> --- fipref.diff begins here ---
> Index: preface.sgml
> ===================================================================
> RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/preface/preface.sgml,v
> retrieving revision 1.25
> diff -u -r1.25 preface.sgml
> --- preface.sgml	25 Aug 2004 19:54:41 -0000	1.25
> +++ preface.sgml	12 Dec 2004 10:24:14 -0000
> @@ -428,6 +428,15 @@
>        </listitem>
>      </varlistentry>
>      <varlistentry>
> +      <term><emphasis><xref linkend="firewalls">, Firewalls</emphasis></term>
> +      <listitem>
> +        <para>Explains the philosophy behind software based firewalls and
> +          provides detailed information about the configuration of the
> +          different firewall software applications available for
> +          FreeBSD.</para>
> +      </listitem>
> +    </varlistentry>
> +    <varlistentry>
>        <term><emphasis><xref linkend="advanced-networking">, Advanced Networking</emphasis></term>
>        <listitem>
>  	<para>Describes many networking topics, including sharing an
> --- fipref.diff ends here ---

The phrase "firewall software applications" strikes me as a bit odd,
since the firewalls are not "applications" in the usual sense of the
word (i.e. something you run as a normal user or something).  Does the
following look ok to you, Joel?

% Index: preface.sgml
% ===================================================================
% RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/preface/preface.sgml,v
% retrieving revision 1.25
% diff -u -u -r1.25 preface.sgml
% --- preface.sgml        25 Aug 2004 19:54:41 -0000      1.25
% +++ preface.sgml        13 Dec 2004 09:48:59 -0000
% @@ -428,6 +428,14 @@
%        </listitem>
%      </varlistentry>
%      <varlistentry>
% +      <term><emphasis><xref linkend="firewalls">, Firewalls</emphasis></term>
% +      <listitem>
% +        <para>Explains the philosophy behind software-based firewalls and
% +          provides detailed information about the configuration of the
% +          different firewalls available for FreeBSD.</para>
% +      </listitem>
% +    </varlistentry>
% +    <varlistentry>
%        <term><emphasis><xref linkend="advanced-networking">, Advanced Networking</emphasis></term>
%        <listitem>
%         <para>Describes many networking topics, including sharing an
Comment 3 Joel Dahl 2004-12-13 11:28:19 UTC
On Mon, 2004-12-13 at 11:51 +0200, Giorgos Keramidas wrote:
> The phrase "firewall software applications" strikes me as a bit odd,
> since the firewalls are not "applications" in the usual sense of the
> word (i.e. something you run as a normal user or something).  Does the
> following look ok to you, Joel?
> 
> % Index: preface.sgml
> % ===================================================================
> % RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/preface/preface.sgml,v
> % retrieving revision 1.25
> % diff -u -u -r1.25 preface.sgml
> % --- preface.sgml        25 Aug 2004 19:54:41 -0000      1.25
> % +++ preface.sgml        13 Dec 2004 09:48:59 -0000
> % @@ -428,6 +428,14 @@
> %        </listitem>
> %      </varlistentry>
> %      <varlistentry>
> % +      <term><emphasis><xref linkend="firewalls">, Firewalls</emphasis></term>
> % +      <listitem>
> % +        <para>Explains the philosophy behind software-based firewalls and
> % +          provides detailed information about the configuration of the
> % +          different firewalls available for FreeBSD.</para>
> % +      </listitem>
> % +    </varlistentry>
> % +    <varlistentry>
> %        <term><emphasis><xref linkend="advanced-networking">, Advanced Networking</emphasis></term>
> %        <listitem>
> %         <para>Describes many networking topics, including sharing an

Looks good to me, thanks.  The topic from chapter 24.3 inspired me use
"firewall software applications", maybe someone should reword that part
to something better...
Comment 4 Joel Dahl 2004-12-13 11:35:34 UTC
On Mon, 2004-12-13 at 12:28 +0100, Joel Dahl wrote:
> Looks good to me, thanks.  The topic from chapter 24.3 inspired me use
                                                                    ^
                                                                    to
Comment 5 Giorgos Keramidas freebsd_committer freebsd_triage 2004-12-13 11:47:47 UTC
State Changed
From-To: open->closed

Committed, thanks :)