From owner-freebsd-doc@FreeBSD.ORG Mon Mar 13 00:44:40 2006 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> X-Original-To: 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 36AB516A404; Mon, 13 Mar 2006 00:44:38 +0000 (GMT) (envelope-from mistral@imasy.or.jp) Received: from shimako.yamayuri.org (yumi.yamayuri.org [218.45.22.23]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9241E43D45; Mon, 13 Mar 2006 00:44:37 +0000 (GMT) (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 k2D0ia47016517 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Mon, 13 Mar 2006 09:44:36 +0900 (JST) (envelope-from mistral@imasy.or.jp) Received: (from sarumaru@localhost) by shimako.yamayuri.org (8.13.4/8.13.4/Submit) id k2D0iZ7D016516; Mon, 13 Mar 2006 09:44:35 +0900 (JST) (envelope-from sarumaru) From: mistral@imasy.or.jp (Yoshihiko Sarumaru) To: remko@FreeBSD.org In-Reply-To: Your message of "Sun, 12 Mar 2006 21:14:59 +0100". <44148143.5040806@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII X-Mailer: mnews [version 1.22PL7] 2003-09/29(Mon) Date: Mon, 13 Mar 2006 09:44:35 +0900 Message-ID: <060313094435.M0218739@shimako.yamayuri.org> Cc: freebsd-doc@FreeBSD.org Subject: Re: docs/94312: [PATCH] desctiption and example mismatch X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 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: Mon, 13 Mar 2006 00:44:40 -0000 Remko Lodder wrote: > Yoshihiko Sarumaru wrote: > > The following reply was made to PR docs/94312; it has been noted by GNATS. > > > > 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 > > Ok, we can just say that we have an agreement over that it is > inconsistent at this time. But, after reading the diff a bit > better it seems that it is from contrib/ where we usually do > not change things because a new import of the software will > simply overwrite the changed lines. > > So, perhaps you and I can choose the desired road (I think > example.host is the way to go) and sent the patch towards > the netcat maintainers so that it will be fixed upstream. > > In the meantime I will grab the PR and make sure we finish this > together :-). > > What do you think about that? > > -- > Kind regards, > > Remko Lodder ** remko@elvandar.org > FreeBSD ** remko@FreeBSD.org > > /* Quis custodiet ipsos custodes */ I saw cvsweb on the OpenBSD web, and found they changed all of them to host.example.com on Rev.1.37, and also this example was removed due to it turned out useless. I wonder what revision is the best one to catch up with... I think just catch up to Rev.1.37 is the best in this time (in frozen state), and wait for someone will upgrade entire nc code, is the best. What do you think? -- sarumaru