locale/FreeBSD/wcstol.3.patch

   1 --- wcstol.3.orig       2009-11-09 15:05:25.000000000 -0800
   2 +++ wcstol.3    2009-11-09 15:05:26.000000000 -0800
   3 @@ -28,15 +28,18 @@
   4  .Dt WCSTOL 3
   5  .Os
   6  .Sh NAME
   7 -.Nm wcstol , wcstoul ,
   8 -.Nm wcstoll , wcstoull ,
   9 -.Nm wcstoimax , wcstoumax
  10 +.Nm wcstoimax ,
  11 +.Nm wcstol ,
  12 +.Nm wcstoll ,
  13 +.Nm wcstoul ,
  14 +.Nm wcstoull ,
  15 +.Nm wcstoumax
  16  .Nd "convert a wide character string value to a"
  17 +.Vt intmax_t ,
  18  .Vt long ,
  19 -.Vt "unsigned long" ,
  20  .Vt "long long" ,
  21 +.Vt "unsigned long" ,
  22  .Vt "unsigned long long" ,
  23 -.Vt intmax_t
  24  or
  25  .Vt uintmax_t
  26  integer
  27 @@ -45,25 +48,50 @@ integer
  28  .Sh SYNOPSIS
  29  .In wchar.h
  30  .Ft long
  31 -.Fn wcstol "const wchar_t * restrict nptr" "wchar_t ** restrict endptr" "int base"
  32 -.Ft "unsigned long"
  33 -.Fn wcstoul "const wchar_t * restrict nptr" "wchar_t ** restrict endptr" "int base"
  34 +.Fo wcstol
  35 +.Fa "const wchar_t *restrict nptr"
  36 +.Fa "wchar_t **restrict endptr"
  37 +.Fa "int base"
  38 +.Fc
  39  .Ft "long long"
  40 -.Fn wcstoll "const wchar_t * restrict nptr" "wchar_t ** restrict endptr" "int base"
  41 +.Fo wcstoll
  42 +.Fa "const wchar_t *restrict nptr"
  43 +.Fa "wchar_t **restrict endptr"
  44 +.Fa "int base"
  45 +.Fc
  46 +.Ft "unsigned long"
  47 +.Fo wcstoul
  48 +.Fa "const wchar_t *restrict nptr"
  49 +.Fa "wchar_t **restrict endptr"
  50 +.Fa "int base"
  51 +.Fc
  52  .Ft "unsigned long long"
  53 -.Fn wcstoull "const wchar_t * restrict nptr" "wchar_t ** restrict endptr" "int base"
  54 +.Fo wcstoull
  55 +.Fa "const wchar_t *restrict nptr"
  56 +.Fa "wchar_t **restrict endptr"
  57 +.Fa "int base"
  58 +.Fc
  59 +.In stddef.h
  60  .In inttypes.h
  61  .Ft intmax_t
  62 -.Fn wcstoimax "const wchar_t * restrict nptr" "wchar_t ** restrict endptr" "int base"
  63 +.Fo wcstoimax
  64 +.Fa "const wchar_t *restrict nptr"
  65 +.Fa "wchar_t **restrict endptr"
  66 +.Fa "int base"
  67 +.Fc
  68  .Ft uintmax_t
  69 -.Fn wcstoumax "const wchar_t * restrict nptr" "wchar_t ** restrict endptr" "int base"
  70 +.Fo wcstoumax
  71 +.Fa "const wchar_t *restrict nptr"
  72 +.Fa "wchar_t **restrict endptr"
  73 +.Fa "int base"
  74 +.Fc
  75  .Sh DESCRIPTION
  76  The
  77  .Fn wcstol ,
  78  .Fn wcstoul ,
  79  .Fn wcstoll ,
  80  .Fn wcstoull ,
  81 -.Fn wcstoimax
  82 +.Fn wcstoimax ,
  83  and
  84  .Fn wcstoumax
  85  functions are wide-character versions of the
  86 @@ -71,23 +99,42 @@ functions are wide-character versions of
  87  .Fn strtoul ,
  88  .Fn strtoll ,
  89  .Fn strtoull ,
  90 -.Fn strtoimax
  91 +.Fn strtoimax ,
  92  and
  93  .Fn strtoumax
  94  functions, respectively.
  95  Refer to their manual pages (for example
  96  .Xr strtol 3 )
  97  for details.
  98 +.Pp
  99 +Extended locale versions of these functions are documented in
 100 +.Xr wcstol_l 3 .
 101 +See
 102 +.Xr xlocale 3
 103 +for more information.
 104 +.Sh LEGACY SYNOPSIS
 105 +.Fd #include <stddef.h>
 106 +.Fd #include <inttypes.h>
 107 +.Pp
 108 +The include file
 109 +.In stddef.h
 110 +is necessary for the
 111 +.Fn wcstoimax
 112 +and
 113 +.Fn wcstoumax
 114 +functions.
 115  .Sh SEE ALSO
 116  .Xr strtol 3 ,
 117 -.Xr strtoul 3
 118 +.Xr strtoul 3 ,
 119 +.Xr wcstol_l 3 ,
 120 +.Xr compat 5
 121  .Sh STANDARDS
 122  The
 123  .Fn wcstol ,
 124  .Fn wcstoul ,
 125  .Fn wcstoll ,
 126  .Fn wcstoull ,
 127 -.Fn wcstoimax
 128 +.Fn wcstoimax ,
 129  and
 130  .Fn wcstoumax
 131  functions conform to