| Summary: | manpage for awk(1) is terribly small and loses important notes | ||
|---|---|---|---|
| Product: | Documentation | Reporter: | Seva Gluschenko <gvs> |
| Component: | Books & Articles | Assignee: | freebsd-doc (Nobody) <doc> |
| Status: | Closed FIXED | ||
| Severity: | Affects Only Me | ||
| Priority: | Normal | ||
| Version: | Latest | ||
| Hardware: | Any | ||
| OS: | Any | ||
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 This is contributed software, please send patches to Brian Kernighan. |
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 ;)