Currency Quotes

[Raymond Chen]

In article <8229 at hubcap.clemson.edu> billwolf at hazel.cs.clemson.edu writes:
>   a) inappropriate, since the static nature of the rates is part
>   of the specification and should not be listed in the defects
>   section, 

Okay, part of the problem is not realizing that the BUGS section
of a man page is misnamed.

	The BUGS section is also somewhat misnamed.  Defects reported
	here aren't so much bugs as shortcomings---simple bugs should
	be fixed before the command in installed.

				-Kernighan and Pike
				 "The UNIX Programming Environment"
				 p. 311

It really should be called "POTENTIALLY PROBLEM-CAUSING BEHAVIOR".  So
defects in the specification or any behavior which someone might
possibly think is a bug (even if it isn't) go into the BUGS section.
For example, the sentence

	The precedence rules are somewhat nonintuitive.

belongs in the BUGS section even though it isn't a bug.