stdio/FreeBSD/printf.3.patch

   1 --- printf.3.orig       2004-11-25 11:38:35.000000000 -0800
   2 +++ printf.3    2005-08-09 22:37:08.000000000 -0700
   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 or SSE vector,
  23 +or other multi-value unit.
  24 +.Pp
  25 +NOTE: This is an extension to 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,34 @@
  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 or SSE 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 extensions to 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 +.Pp
  64 +As a further extension, for SSE2 64-bit units:
  65 +.Bl -tag -compact
  66 +.It Cm vll, llv
  67 +Treat the argument as a vector of 2 64-bit units.
  68 +.El
  69  .It
  70  A character that specifies the type of conversion to be applied.
  71  .El
  72 @@ -792,12 +840,8 @@
  73  .Xr fmtcheck 3 ,
  74  .Xr scanf 3 ,
  75  .Xr setlocale 3 ,
  76 -.Xr wprintf 3
  77 -.Rs
  78 -.%T "The FreeBSD Security Architecture"
  79 -.Re
  80 -(See
  81 -.Pa "/usr/share/doc/{to be determined}" . )
  82 +.Xr wprintf 3 ,
  83 +.Xr printf_l 3
  84  .Sh STANDARDS
  85  Subject to the caveats noted in the
  86  .Sx BUGS