]> git.saurik.com Git - apple/libc.git/blame_incremental - stdio/FreeBSD/printf.3.patch
Libc-339.tar.gz
[apple/libc.git] / stdio / FreeBSD / printf.3.patch
... / ...
CommitLineData
1--- printf.3.orig Fri May 28 14:31:32 2004
2+++ printf.3 Fri May 28 14:33:23 2004
3@@ -287,6 +287,20 @@
4 .Xr localeconv 3 .
5 .El
6 .It
7+An optional separator character (
8+.Cm \ , | \; | \ : | _
9+) used for separating multiple values when printing an AltiVec vector,
10+or other multi-value unit.
11+.Pp
12+NOTE: This is an AltiVec only extension onto the
13+.Fn printf
14+specification.
15+Behaviour of these values for
16+.Fn printf
17+is only defined for operating systems conforming to the
18+AltiVec Technology Programming Interface Manual.
19+(At time of writing this includes only Mac OS X 10.2 and later.)
20+.It
21 An optional decimal digit string specifying a minimum field width.
22 If the converted value has fewer characters than the field width, it will
23 be padded with spaces on the left (or right, if the left-adjustment
24@@ -377,6 +391,28 @@
25 .It Sy Modifier Ta Cm c Ta Cm s
26 .It Cm l No (ell) Ta Vt wint_t Ta Vt "wchar_t *"
27 .El
28+.Pp
29+The AltiVec Technology Programming Interface Manual also defines five additional length modifiers
30+which can be used (in place of the conventional length modifiers) for the printing of AltiVec vectors:
31+.Bl -tag -compact
32+.It Cm v
33+Treat the argument as a vector value, unit length will be determined by the conversion
34+specifier (default = 16 8-bit units for all integer conversions,
35+4 32-bit units for floating point conversions).
36+.It Cm vh, hv
37+Treat the argument as a vector of 8 16-bit units.
38+.It Cm vl, lv
39+Treat the argument as a vector of 4 32-bit units.
40+.El
41+.Pp
42+NOTE: The vector length specifiers are AltiVec only extensions onto the
43+.Fn printf
44+specification.
45+Behaviour of these values for
46+.Fn printf
47+is only defined for operating systems conforming to the
48+AltiVec Technology Programming Interface Manual.
49+(At time of writing this includes only Mac OS X 10.2 and later.)
50 .It
51 A character that specifies the type of conversion to be applied.
52 .El
53@@ -785,11 +821,6 @@
54 .Xr scanf 3 ,
55 .Xr setlocale 3 ,
56 .Xr wprintf 3
57-.Rs
58-.%T "The FreeBSD Security Architecture"
59-.Re
60-(See
61-.Pa "/usr/share/doc/{to be determined}" . )
62 .Sh STANDARDS
63 Subject to the caveats noted in the
64 .Sx BUGS