stdio/FreeBSD/printf.3.patch

   1 --- printf.3.orig       Fri Mar 11 17:08:43 2005
   2 +++ printf.3    Fri Mar 11 17:04:50 2005
   3 @@ -101,6 +101,12 @@
   4  dynamically allocate a new string with
   5  .Xr malloc 3 .
   6  .Pp
   7 +Extended locale versions of these functions are documented in
   8 +.Xr printf_l 3 .
   9 +See
  10 +.Xr xlocale 3
  11 +for more information.
  12 +.Pp
  13  These functions write the output under the control of a
  14  .Fa format
  15  string that specifies how subsequent arguments
  16 @@ -287,6 +293,20 @@
  17  .Xr localeconv 3 .
  18  .El
  19  .It
  20 +An optional separator character (
  21 +.Cm \ , | \;  | \ : | _
  22 +) used for separating multiple values when printing an AltiVec vector,
  23 +or other multi-value unit.
  24 +.Pp
  25 +NOTE: This is an AltiVec only extension onto the
  26 +.Fn printf
  27 +specification.
  28 +Behaviour of these values for
  29 +.Fn printf
  30 +is only defined for operating systems conforming to the
  31 +AltiVec Technology Programming Interface Manual.
  32 +(At time of writing this includes only Mac OS X 10.2 and later.)
  33 +.It
  34  An optional decimal digit string specifying a minimum field width.
  35  If the converted value has fewer characters than the field width, it will
  36  be padded with spaces on the left (or right, if the left-adjustment
  37 @@ -379,6 +399,28 @@
  38  .It Sy Modifier Ta Cm c Ta Cm s
  39  .It Cm l No (ell) Ta Vt wint_t Ta Vt "wchar_t *"
  40  .El
  41 +.Pp
  42 +The AltiVec Technology Programming Interface Manual also defines five additional length modifiers
  43 +which can be used (in place of the conventional length modifiers) for the printing of AltiVec vectors:
  44 +.Bl -tag -compact
  45 +.It Cm v
  46 +Treat the argument as a vector value, unit length will be determined by the conversion
  47 +specifier (default = 16 8-bit units for all integer conversions,
  48 +4 32-bit units for floating point conversions).
  49 +.It Cm vh, hv
  50 +Treat the argument as a vector of 8 16-bit units.
  51 +.It Cm vl, lv
  52 +Treat the argument as a vector of 4 32-bit units.
  53 +.El
  54 +.Pp
  55 +NOTE: The vector length specifiers are AltiVec only extensions onto the
  56 +.Fn printf
  57 +specification.
  58 +Behaviour of these values for
  59 +.Fn printf
  60 +is only defined for operating systems conforming to the
  61 +AltiVec Technology Programming Interface Manual.
  62 +(At time of writing this includes only Mac OS X 10.2 and later.)
  63  .It
  64  A character that specifies the type of conversion to be applied.
  65  .El
  66 @@ -792,12 +834,8 @@
  67  .Xr fmtcheck 3 ,
  68  .Xr scanf 3 ,
  69  .Xr setlocale 3 ,
  70 -.Xr wprintf 3
  71 -.Rs
  72 -.%T "The FreeBSD Security Architecture"
  73 -.Re
  74 -(See
  75 -.Pa "/usr/share/doc/{to be determined}" . )
  76 +.Xr wprintf 3 ,
  77 +.Xr printf_l 3
  78  .Sh STANDARDS
  79  Subject to the caveats noted in the
  80  .Sx BUGS