stdio/FreeBSD/printf.3.patch

   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