svn commit: r224289 - stable/8/usr.bin/printf

[Jilles Tjoelker]

Author: jilles
Date: Sun Jul 24 17:24:26 2011
New Revision: 224289
URL: http://svn.freebsd.org/changeset/base/224289

Log:
  MFC r212374,r221026: printf(1): Document need for "--" before format strings
  starting with "-".
  
  Also move the remark that hexadecimal escapes are not provided to the new
  CAVEATS section.
  
  PR:		158846

Modified:
  stable/8/usr.bin/printf/printf.1
Directory Properties:
  stable/8/usr.bin/printf/   (props changed)

Modified: stable/8/usr.bin/printf/printf.1
==============================================================================
--- stable/8/usr.bin/printf/printf.1	Sun Jul 24 11:56:39 2011	(r224288)
+++ stable/8/usr.bin/printf/printf.1	Sun Jul 24 17:24:26 2011	(r224289)
@@ -332,6 +332,16 @@ command appeared in
 It is modeled
 after the standard library function,
 .Xr printf 3 .
+.Sh CAVEATS
+.Tn ANSI
+hexadecimal character constants were deliberately not provided.
+.Pp
+Trying to print a dash ("-") as the first character causes
+.Nm
+to interpret the dash as a program argument.
+.Nm --
+must be used before 
+.Ar format .
 .Sh BUGS
 Since the floating point numbers are translated from
 .Tn ASCII
@@ -343,9 +353,6 @@ The
 .Cm L
 modifier may produce additional precision, depending on the hardware platform.)
 .Pp
-.Tn ANSI
-hexadecimal character constants were deliberately not provided.
-.Pp
 The escape sequence \e000 is the string terminator.
 When present in the argument for the
 .Cm b