Date: Sun, 22 Sep 2002 18:00:24 +0100
From: "Richard Dawe" <rich AT phekda DOT freeserve DOT co DOT uk>
Sender: rich AT phekda DOT freeserve DOT co DOT uk
To: djgpp-workers AT delorie DOT com
X-Mailer: Emacs 21.3.50 (via feedmail 8.3.emacs20_6 I) and Blat ver 1.8.6
Subject: Patch: Improve %D, %O, %U conversion type docs
Message-Id: <E17t9wK-0000Kp-00@phekda.freeserve.co.uk>
Reply-To: djgpp-workers AT delorie DOT com

Hello.

FWIW %D, %O and %U are marked as obsolete and just there for
backwards compatibility in the man pages on FreeBSD 4.2.

Below is a patch to improve the documentation for the %D, %O and %U
conversion types.

OK to commit?

(Juan Manuel, if you'd rather integrate this into your patch,
then that's fine - just let me know.)

Bye, Rich =]

Index: src/libc/ansi/stdio/printf.txh
===================================================================
RCS file: /cvs/djgpp/djgpp/src/libc/ansi/stdio/printf.txh,v
retrieving revision 1.4
diff -p -u -3 -r1.4 printf.txh
--- src/libc/ansi/stdio/printf.txh	30 Jun 2001 14:05:40 -0000	1.4
+++ src/libc/ansi/stdio/printf.txh	22 Sep 2002 16:46:23 -0000
@@ -77,15 +77,16 @@ The conversion type specifier:
 
 @item c
 
-A single character
+A single character.
 
 @item d
 
-A signed integer
+A signed integer.
 
 @item D
 
-A signed long integer
+A signed long integer.  This is non-standard and obsolete.
+Please use @code{ld} instead.
 
 @item e
 @itemx E
@@ -119,6 +120,11 @@ characters generated so far is stored in
 
 A unsigned integer, printed in base 8 instead of base 10.
 
+@item O
+
+A unsigned long integer, printed in base 8 instead of base 10.
+This is non-standard and obsolete.  Please use @code{lo} instead.
+
 @item p
 
 A pointer.  This is printed with an @code{x} specifier.
@@ -133,7 +139,8 @@ An unsigned integer.
 
 @item U
 
-An unsigned long integer.
+An unsigned long integer.  This is non-standard and obsolete.
+Please use @code{lu} instead.
 
 @item x
 @itemx X
@@ -154,6 +161,9 @@ A single percent symbol is printed.
 The number of characters written.
 
 @subheading Portability
+
+The @code{D}, @code{O} and @code{U} conversion types are non-standard.
+gcc may generate warnings, if you use them.
 
 @portability ansi, posix