From owner-freebsd-doc@FreeBSD.ORG Wed Oct 6 14:10:22 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9222116A4CE for ; Wed, 6 Oct 2004 14:10:22 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 67E2343D4C for ; Wed, 6 Oct 2004 14:10:22 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i96EAM5x061105 for ; Wed, 6 Oct 2004 14:10:22 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i96EAMXo061104; Wed, 6 Oct 2004 14:10:22 GMT (envelope-from gnats) Resent-Date: Wed, 6 Oct 2004 14:10:22 GMT Resent-Message-Id: <200410061410.i96EAMXo061104@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Seva Gluschenko Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 857E716A4D0 for ; 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 ; 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 ; 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 To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/72383: manpage for awk(1) is terribly small and loses important notes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 06 Oct 2004 14:10:22 -0000 >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: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Wed Oct 06 14:10:21 GMT 2004 >Closed-Date: >Last-Modified: >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: >Unformatted: