[src/trunk]: src/usr.bin/printf Explicitly mention use of -- for format strin...

[dholland <dholland%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/cb583fbea37b
branches:  trunk
changeset: 321335:cb583fbea37b
user:      dholland <dholland%NetBSD.org@localhost>
date:      Mon Mar 12 00:42:05 2018 +0000

description:
Explicitly mention use of -- for format strings beginning with -,
per PR 21970.

diffstat:

 usr.bin/printf/printf.1 |  11 +++++++++--
 1 files changed, 9 insertions(+), 2 deletions(-)

diffs (32 lines):

diff -r ffa0d93db48f -r cb583fbea37b usr.bin/printf/printf.1
--- a/usr.bin/printf/printf.1   Sun Mar 11 23:49:39 2018 +0000
+++ b/usr.bin/printf/printf.1   Mon Mar 12 00:42:05 2018 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: printf.1,v 1.25 2014/04/13 01:45:34 snj Exp $
+.\"    $NetBSD: printf.1,v 1.26 2018/03/12 00:42:05 dholland Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -32,7 +32,7 @@
 .\"
 .\"    from: @(#)printf.1      8.1 (Berkeley) 6/6/93
 .\"
-.Dd May 6, 2008
+.Dd March 11, 2018
 .Dt PRINTF 1
 .Os
 .Sh NAME
@@ -358,6 +358,13 @@
 In no case does a non-existent or small field width cause truncation of
 a field; padding takes place only if the specified field width exceeds
 the actual width.
+.Pp
+If the first character of
+.Ar format
+is a dash,
+.Ar format
+must be preceded by a word consisting of two dashes (--) to prevent it
+from being interpreted as an option string.
 .Sh EXIT STATUS
 .Ex -std
 .Sh SEE ALSO