docs/72383: manpage for awk(1) is terribly small and loses important notes

[Seva Gluschenko]

>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 at 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: