Date: Wed, 6 Oct 2004 18:07:02 +0400 (MSD) From: Seva Gluschenko <gvs@rinet.ru> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/72383: manpage for awk(1) is terribly small and loses important notes Message-ID: <200410061407.i96E72ik002594@road.yandex.ru> Resent-Message-ID: <200410061410.i96EAMXo061104@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200410061407.i96E72ik002594>