From mistral@imasy.or.jp  Sat Mar 11 07:32:13 2006
Return-Path: <mistral@imasy.or.jp>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id E2A0C16A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 11 Mar 2006 07:32:13 +0000 (GMT)
	(envelope-from mistral@imasy.or.jp)
Received: from yumi.yamayuri.org (yumi.yamayuri.org [218.45.22.23])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0845E43D5A
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 11 Mar 2006 07:32:12 +0000 (GMT)
	(envelope-from mistral@imasy.or.jp)
Received: from shimako.yamayuri.org (shimako.yamayuri.org [IPv6:3ffe:505:2020:0:213:ceff:fe04:a832])
	by yumi.yamayuri.org (8.13.3/8.13.3) with ESMTP id k2B7WBAM009544
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL)
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 11 Mar 2006 16:32:11 +0900 (JST)
	(envelope-from mistral@imasy.or.jp)
Received: from shimako.yamayuri.org (localhost [127.0.0.1])
	by shimako.yamayuri.org (8.13.4/8.13.4/shimako) with ESMTP id k2B7WAir009821
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO)
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 11 Mar 2006 16:32:10 +0900 (JST)
	(envelope-from mistral@imasy.or.jp)
Received: (from sarumaru@localhost)
	by shimako.yamayuri.org (8.13.4/8.13.4/Submit) id k2B7W9Cv009820;
	Sat, 11 Mar 2006 16:32:09 +0900 (JST)
	(envelope-from sarumaru)
Message-Id: <200603110732.k2B7W9Cv009820@shimako.yamayuri.org>
Date: Sat, 11 Mar 2006 16:32:09 +0900 (JST)
From: Yoshihiko Sarumaru <mistral@imasy.or.jp>
Reply-To: Yoshihiko Sarumaru <mistral@imasy.or.jp>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] desctiption and example mismatch
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         94312
>Category:       docs
>Synopsis:       [patch] nc(1): description and example mismatch
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    remko
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Mar 11 07:40:40 GMT 2006
>Closed-Date:    Mon Mar 13 19:39:44 GMT 2006
>Last-Modified:  Mon Mar 13 19:39:44 GMT 2006
>Originator:     Yoshihiko Sarumaru
>Release:        FreeBSD 6.1-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD shimako.yamayuri.org 6.1-PRERELEASE FreeBSD 6.1-PRERELEASE #1: Fri Feb 24 00:52:39 JST 2006 sarumaru@shimako.yamayuri.org:/usr/obj/usr/src/sys/VGN-T72 i386


	
>Description:
	In nc(1), there are some examples presented, but in one exapmple,
	hostname are mismatch in description and command line.

	This PR related to docs/94158
>How-To-Repeat:
	man 1 nc
>Fix:
--- /usr/src/contrib/netcat/nc.1	Mon Jun 27 16:07:55 2005
+++ nc.1	Sat Mar 11 03:04:04 2006
@@ -401,7 +401,7 @@
 .Pp
 .Dl $ nc -s 10.1.2.3 example.host 42
 .Pp
-Send UDP packets to ports 20-30 of example.host, and report which ones
+Send UDP packets to ports 20-30 of hostname, and report which ones
 responded with an ICMP packet after three seconds:
 .Pp
 .Dl $ nc -uvz -w 3 hostname 20-30
>Release-Note:
>Audit-Trail:

From: Remko Lodder <remko@FreeBSD.org>
To: Yoshihiko Sarumaru <mistral@imasy.or.jp>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/94312: [PATCH] desctiption and example mismatch
Date: Sat, 11 Mar 2006 18:10:29 +0100

 Yoshihiko Sarumaru wrote:
 > 	
 >> Description:
 > 	In nc(1), there are some examples presented, but in one exapmple,
 > 	hostname are mismatch in description and command line.
 > 
 > 	This PR related to docs/94158
 >> How-To-Repeat:
 > 	man 1 nc
 >> Fix:
 > --- /usr/src/contrib/netcat/nc.1	Mon Jun 27 16:07:55 2005
 > +++ nc.1	Sat Mar 11 03:04:04 2006
 > @@ -401,7 +401,7 @@
 >  .Pp
 >  .Dl $ nc -s 10.1.2.3 example.host 42
 >  .Pp
 > -Send UDP packets to ports 20-30 of example.host, and report which ones
 > +Send UDP packets to ports 20-30 of hostname, and report which ones
 >  responded with an ICMP packet after three seconds:
 >  .Pp
 >  .Dl $ nc -uvz -w 3 hostname 20-30
 
 Hi,
 
 This is a somewhat difficult change i think.  We have various
 instances of "hostname" and various instances of "example.host".
 
 I would like to be consistent though and make them all "example.host"
 which describes the items best.  What do others think of this?
 
 Cheers,
 Remko
 
 -- 
 Kind regards,
 
       Remko Lodder               ** remko@elvandar.org
       FreeBSD                    ** remko@FreeBSD.org
 
       /* Quis custodiet ipsos custodes */

From: mistral@imasy.or.jp (Yoshihiko Sarumaru)
To: remko@FreeBSD.org
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/94312: [PATCH] desctiption and example mismatch
Date: Mon, 13 Mar 2006 00:36:41 +0900

 > Yoshihiko Sarumaru wrote:
 > > 	
 > >> Description:
 > > 	In nc(1), there are some examples presented, but in one exapmple,
 > > 	hostname are mismatch in description and command line.
 > > 
 > > 	This PR related to docs/94158
 > >> How-To-Repeat:
 > > 	man 1 nc
 > >> Fix:
 > > --- /usr/src/contrib/netcat/nc.1	Mon Jun 27 16:07:55 2005
 > > +++ nc.1	Sat Mar 11 03:04:04 2006
 > > @@ -401,7 +401,7 @@
 > >  .Pp
 > >  .Dl $ nc -s 10.1.2.3 example.host 42
 > >  .Pp
 > > -Send UDP packets to ports 20-30 of example.host, and report which ones
 > > +Send UDP packets to ports 20-30 of hostname, and report which ones
 > >  responded with an ICMP packet after three seconds:
 > >  .Pp
 > >  .Dl $ nc -uvz -w 3 hostname 20-30
 > 
 > Hi,
 > 
 > This is a somewhat difficult change i think.  We have various
 > instances of "hostname" and various instances of "example.host".
 > 
 > I would like to be consistent though and make them all "example.host"
 > which describes the items best.  What do others think of this?
 
 I don't mind whichever, but I also feel something inconsistency
 to the both "hostname" and "example.host" are used.
 
 Regars,
 
 --
 sarumaru
Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: remko 
Responsible-Changed-When: Sun Mar 12 20:16:27 UTC 2006 
Responsible-Changed-Why:  
As mentioned on -doc I will grab the PR and work together with 
Yoshihiko to get this fixed at the netcat side of the world. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=94312 
State-Changed-From-To: open->feedback 
State-Changed-By: remko 
State-Changed-When: Sun Mar 12 20:17:57 UTC 2006 
State-Changed-Why:  
Place the PR in feedback mode, after we created the required 
patch it will be sent to the netcat team from which we will 
wait till we get some information back. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=94312 
State-Changed-From-To: feedback->closed 
State-Changed-By: remko 
State-Changed-When: Mon Mar 13 19:38:57 UTC 2006 
State-Changed-Why:  
Submitted will contact delphij (who imported the netcat contributed source) 
and ask him to update the netcat code in which the document will be 
fixed.  In the meantime it is OK to close the PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=94312 
>Unformatted:
