Bug 72383

Summary: manpage for awk(1) is terribly small and loses important notes
Product: Documentation Reporter: Seva Gluschenko <gvs>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Seva Gluschenko 2004-10-06 15:10:21 UTC
	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.

Fix: 

At least, include the note above about fields. At most, review
	and fill awk manpage with all necessary details.
How-To-Repeat: 	$ man awk

	;)
Comment 1 Tom Rhodes freebsd_committer freebsd_triage 2004-10-06 15:39:06 UTC
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
Comment 2 ru freebsd_committer freebsd_triage 2006-10-12 11:55:48 UTC
State Changed
From-To: open->closed

This is contributed software, please send patches to Brian Kernighan.