From: kn <kn@openbsd.org>
Date: Sun, 4 Apr 2021 15:25:11 +0000 (+0000)
Subject: Document support subset of conversion specification
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=429fb3324a2eea2d6e89123a709b98659a2e9247;p=openbsd

Document support subset of conversion specification

Clarify that printf(9) only knows
%[width][size]conversion
contrary to printf(3)'s
%[argno$][flags][width][.precision][size]conversion

Feedback OK jmc
OK deraadt
---

diff --git a/share/man/man9/printf.9 b/share/man/man9/printf.9
index c31fb0cb42e..a7de554db19 100644
--- a/share/man/man9/printf.9
+++ b/share/man/man9/printf.9
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: printf.9,v 1.24 2015/11/07 03:48:25 mmcc Exp $
+.\"	$OpenBSD: printf.9,v 1.25 2021/04/04 15:25:11 kn Exp $
 .\"     $NetBSD: kprintf.9,v 1.6 1999/03/16 00:40:47 garbled Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
@@ -28,7 +28,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: November 7 2015 $
+.Dd $Mdocdate: April 4 2021 $
 .Dt PRINTF 9
 .Os
 .Sh NAME
@@ -119,6 +119,18 @@ send formatted strings to the ddb console, and are only used to implement
 Since each of these kernel functions is a variant of its user space
 counterpart, this page describes only the differences between the user
 space and kernel versions.
+.Pp
+Only a subset of the user space conversion specification is available to the
+kernel version:
+.Bd -filled -offset indent
+.Sm off
+.Cm %
+.Op Ar width
+.Op Ar size
+.Ar conversion
+.Sm on
+.Ed
+.Pp
 Refer to
 .Xr printf 3
 for functional details.