From jhs@berklix.org  Thu Mar  6 11:29:08 2008
Return-Path: <jhs@berklix.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 97E12106566B
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  6 Mar 2008 11:29:08 +0000 (UTC)
	(envelope-from jhs@berklix.org)
Received: from flat.berklix.org (flat.berklix.org [83.236.223.115])
	by mx1.freebsd.org (Postfix) with ESMTP id 0002A8FC28
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  6 Mar 2008 11:29:07 +0000 (UTC)
	(envelope-from jhs@berklix.org)
Received: from js.berklix.net (p549A60F6.dip.t-dialin.net [84.154.96.246])
	(authenticated bits=0)
	by flat.berklix.org (8.13.8/8.13.8) with ESMTP id m26BT4EE024772
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 6 Mar 2008 12:29:05 +0100 (CET)
	(envelope-from jhs@berklix.org)
Received: from fire.js.berklix.net (fire.js.berklix.net [192.168.91.41])
	by js.berklix.net (8.13.8/8.13.8) with ESMTP id m26BT58O016118
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 6 Mar 2008 12:29:05 +0100 (CET)
	(envelope-from jhs@berklix.org)
Received: from fire.js.berklix.net (localhost [127.0.0.1])
	by fire.js.berklix.net (8.13.8/8.13.8) with ESMTP id m26BSt25052376
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 6 Mar 2008 12:29:00 +0100 (CET)
	(envelope-from jhs@fire.js.berklix.net)
Received: (from jhs@localhost)
	by fire.js.berklix.net (8.13.8/8.13.8/Submit) id m26BSouS052375;
	Thu, 6 Mar 2008 12:28:50 +0100 (CET)
	(envelope-from jhs)
Message-Id: <200803061128.m26BSouS052375@fire.js.berklix.net>
Date: Thu, 6 Mar 2008 12:28:50 +0100 (CET)
From: "Julian H. Stacey" <jhs@berklix.org>
Reply-To: "Julian H. Stacey" <jhs@berklix.org>
To: FreeBSD-gnats-submit@freebsd.org
Subject: Rectify ambiguous English in manual
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         121424
>Category:       bin
>Synopsis:       [patch] [ipfw] Rectify ambiguous English in manual
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 06 11:30:02 UTC 2008
>Closed-Date:    Sat Mar 20 14:42:56 UTC 2010
>Last-Modified:  Sat Mar 20 14:50:01 UTC 2010
>Originator:     "Julian H. Stacey" <jhs@berklix.com>
>Release:        FreeBSD 6.2-RELEASE i386
>Organization:
http://berklix.com BSD Linux Unix Consultancy, Munich/Muenchen.
>Environment:
System: FreeBSD fire.js.berklix.net 6.2-RELEASE FreeBSD 6.2-RELEASE #0: Mon Sep 17 23:01:21 CEST 2007 jhs@fire.js.berklix.net:/usr1/src/sys/amd64/compile/FIRE64.small amd64


	
>Description:
	Rectify ambiguous English, make it easier to read 1st. time,
	("may" can be read as a command, EG "you may not drive without a licence"
	"might" is more indicative, needs less chance of a 2nd. read).

>How-To-Repeat:
	-
>Fix:
	This patch applies to at least all between 4.0 & 7.0
	I append a copy of
	http://berklix.com/~jhs/src/bsd/fixes/FreeBSD/src/gen/sbin/ipfw/ipfw.8.REL=ALL.diff

Rectify ambiguous English, make it easier to read 1st. time,
("may" can be read as a command, EG "you may not drive without a licence"
"might" is more indicative, needs less chance of a 2nd. read).

*** 4.0-RELEASE/src/sbin/ipfw/ipfw.8.orig	Tue Jul 18 13:48:16 2000
--- gen/src/sbin/ipfw/ipfw.8	Tue Jul 18 13:49:20 2000
***************
*** 577,583 ****
  .Cm recv
  is invalid.
  .Pp
! A packet may not have a receive or transmit interface: packets
  originating from the local host have no receive interface,
  while packets destined for the local host have no transmit
  interface.
--- 577,583 ----
  .Cm recv
  is invalid.
  .Pp
! A packet might not have a receive or transmit interface: packets
  originating from the local host have no receive interface,
  while packets destined for the local host have no transmit
  interface.
# *** 3.4-RELEASE/src/sbin/ipfw/ipfw.8	Thu Apr 13 11:25:36 2000
# --- jhs/src/sbin/ipfw/ipfw.8	Fri Apr 14 08:37:46 2000
# ***************
# *** 596,602 ****
#   .Ar recv
#   is invalid.
#   .Pp
# ! A packet may not have a receive or transmit interface: packets originating
#   from the local host have no receive interface. while packets destined for
#   the local host have no transmit interface.
#   .Pp
# --- 596,602 ----
#   .Ar recv
#   is invalid.
#   .Pp
# ! A packet might not have a receive or transmit interface: packets originating
#   from the local host have no receive interface. while packets destined for
#   the local host have no transmit interface.
#   .Pp


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: brucec 
Responsible-Changed-When: Wed Mar 25 17:20:32 UTC 2009 
Responsible-Changed-Why:  
Over to maintainer(s). 

http://www.freebsd.org/cgi/query-pr.cgi?pr=121424 
State-Changed-From-To: open->closed 
State-Changed-By: gavin 
State-Changed-When: Sat Mar 20 14:42:31 UTC 2010 
State-Changed-Why:  
Fied in head.  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=121424 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: bin/121424: commit references a PR
Date: Sat, 20 Mar 2010 14:42:27 +0000 (UTC)

 Author: gavin
 Date: Sat Mar 20 14:42:16 2010
 New Revision: 205372
 URL: http://svn.freebsd.org/changeset/base/205372
 
 Log:
   Tweak language to make one point potentially clearer for non-native spekers
   
   PR:		bin/121424
   Submitted by:	"Julian H. Stacey" <jhs berklix.org>
 
 Modified:
   head/sbin/ipfw/ipfw.8
 
 Modified: head/sbin/ipfw/ipfw.8
 ==============================================================================
 --- head/sbin/ipfw/ipfw.8	Sat Mar 20 14:36:39 2010	(r205371)
 +++ head/sbin/ipfw/ipfw.8	Sat Mar 20 14:42:16 2010	(r205372)
 @@ -1,7 +1,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd June 24, 2009
 +.Dd March 20, 2010
  .Dt IPFW 8
  .Os
  .Sh NAME
 @@ -1501,7 +1501,7 @@ is invalid) whenever
  .Cm xmit
  is used.
  .Pp
 -A packet may not have a receive or transmit interface: packets
 +A packet might not have a receive or transmit interface: packets
  originating from the local host have no receive interface,
  while packets destined for the local host have no transmit
  interface.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
