[groff] 01/01: Improve documentation of pic(1) regarding printf.

[Ingo Schwarze]

schwarze pushed a commit to branch master
in repository groff.

commit 82ea31e7128286a3b22446294d4dbe7d6b2cf464
Author: Ingo Schwarze <address@hidden>
Date:   Sun Dec 29 14:47:08 2019 +0100

    Improve documentation of pic(1) regarding printf.
    
     * src/preproc/pic/pic.1.man:
       Document which conversion specifications are supported.
     * doc/pic.ms:
       Correct the list of supported conversion specifications.
    
    Both documentation bugs were reported by
    Doug McIlroy <doug at cs dot dartmouth dot edu>.
    OK esr@ on an earlier version, and using additional feedback
    from Ralph Corderoy <ralph at inputplus dot co dot uk>.
---
 ChangeLog                 |  9 +++++++++
 doc/pic.ms                |  3 ++-
 src/preproc/pic/pic.1.man | 14 ++++++++++++++
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index 727c367..90792bd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2019-12-29  Ingo Schwarze  <address@hidden>
+
+       Improve documentation of pic(1) regarding printf.
+
+       * src/preproc/pic/pic.1.man:
+         Document which conversion specifications are supported.
+       * doc/pic.ms:
+         Correct the list of supported conversion specifications.
+
 2019-12-21  Ingo Schwarze  <address@hidden>
 
        Update NetBSD, OpenBSD, FreeBSD, Darwin, and DragonFly version strings.
diff --git a/doc/pic.ms b/doc/pic.ms
index 6d581ba..b7dfe32 100644
--- a/doc/pic.ms
+++ b/doc/pic.ms
@@ -1722,7 +1722,8 @@ GNU \fBgpic\fP also documents a one-argument form or rand,
 version.
 .PP
 The function \fBsprintf()\fP behaves like a C \fIsprintf\/\fP(3)
-function that only takes %, %e, %f, and %g format strings.
+function that only takes %%, %e, %E, %f, %g, and %G conversion
+specifications.
 .
 .
 .NH 1
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index ae4c205..4fadf17 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -906,6 +906,20 @@ this will produce the arguments formatted according to
 which should be a string as described in
 .BR printf (3)
 appropriate for the number of arguments supplied.
+Only the flags
+.RB \(oq # \(cq,
+.RB \(oq \- \(cq,
+.RB \(oq + \(cq,
+and \(oq\ \(cq (space), a minimum field width, an optional precision,
+and the conversion specifications
+.BR %e ,
+.BR %E ,
+.BR %f ,
+.BR %g ,
+.BR %G ,
+and
+.B %%
+are supported.
 .
 .
 .LP