From gvs@road.yandex.ru  Wed Oct  6 14:06:51 2004
Return-Path: <gvs@road.yandex.ru>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 857E716A4D0
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  6 Oct 2004 14:06:51 +0000 (GMT)
Received: from road.yandex.ru (road.yandex.ru [213.180.193.165])
	by mx1.FreeBSD.org (Postfix) with ESMTP id B8E1343D5C
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  6 Oct 2004 14:06:49 +0000 (GMT)
	(envelope-from gvs@road.yandex.ru)
Received: from road.yandex.ru (localhost.yandex.net [127.0.0.1] (may be forged))
	by road.yandex.ru (8.13.1/8.13.1) with ESMTP id i96E72Wb002595
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 6 Oct 2004 18:07:02 +0400 (MSD)
	(envelope-from gvs@road.yandex.ru)
Received: (from gvs@localhost)
	by road.yandex.ru (8.13.1/8.13.1/Submit) id i96E72ik002594;
	Wed, 6 Oct 2004 18:07:02 +0400 (MSD)
	(envelope-from gvs)
Message-Id: <200410061407.i96E72ik002594@road.yandex.ru>
Date: Wed, 6 Oct 2004 18:07:02 +0400 (MSD)
From: Seva Gluschenko <gvs@rinet.ru>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: manpage for awk(1) is terribly small and loses important notes
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         72383
>Category:       docs
>Synopsis:       manpage for awk(1) is terribly small and loses important notes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Oct 06 14:10:21 GMT 2004
>Closed-Date:    Thu Oct 12 10:57:02 GMT 2006
>Last-Modified:  Thu Oct 12 10:57:02 GMT 2006
>Originator:     Seva Gluschenko
>Release:        FreeBSD 5.3-BETA3 i386
>Organization:
Yandex LLC
>Environment:
System: FreeBSD road.yandex.ru 5.3-BETA3 FreeBSD 5.3-BETA3 #11: Tue Sep 7 19:13:32 MSD 2004 gvs@road.yandex.ru:/local/obj/local/usr/src/sys/ROAD i386


	
>Description:
	Cite from gawk (bundled with FreeBSD-4.x) manpage:

       Each field in the input record may be referenced by its  position,  $1,
       $2,  and  so  on.  $0 is the whole record.  The value of a field may be
       assigned to as well.  Fields need not be referenced by constants:

              n = 5
              print $n
	[etc]

	This piece of information is quite important for successful usage
	of awk, so omitting it is not good. I suppose, it's not the only
	example of poorness of BSD awk manpage.

>How-To-Repeat:
	$ man awk

	;)
>Fix:

	At least, include the note above about fields. At most, review
	and fill awk manpage with all necessary details.


>Release-Note:
>Audit-Trail:

From: Tom Rhodes <trhodes@FreeBSD.org>
To: Seva Gluschenko <gvs@rinet.ru>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/72383: manpage for awk(1) is terribly small and loses
 important notes
Date: Wed, 6 Oct 2004 10:39:06 -0400

 On Wed, 6 Oct 2004 18:07:02 +0400 (MSD)
 Seva Gluschenko <gvs@rinet.ru> wrote:
 
 > Cite from gawk (bundled with FreeBSD-4.x) manpage:
 > 
 > Each field in the input record may be referenced by its  position,  $1,
 > $2,  and  so  on.  $0 is the whole record.  The value of a field may be
 > assigned to as well.  Fields need not be referenced by constants:
 
 To the best of my knowledge, this is contrib software and these
 should either be fixed on the vendor branch or we need permission
 to take the manual page off the vendor branch.  I'm only keen on
 the first option though.
 
 -- 
 Tom Rhodes
State-Changed-From-To: open->closed 
State-Changed-By: ru 
State-Changed-When: Thu Oct 12 10:55:48 UTC 2006 
State-Changed-Why:  
This is contributed software, please send patches to Brian Kernighan. 

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