Print this page
Garrett's man page edits.

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man3c/towlower.3c
          +++ new/usr/src/man/man3c/towlower.3c
↓ open down ↓ 3 lines elided ↑ open up ↑
   4    4  .\" Common Development and Distribution License ("CDDL"), version 1.0.
   5    5  .\" You may only use this file in accordance with the terms of version
   6    6  .\" 1.0 of the CDDL.
   7    7  .\"
   8    8  .\" A full copy of the text of the CDDL should have accompanied this
   9    9  .\" source.  A copy of the CDDL is also available via the Internet at
  10   10  .\" http://www.illumos.org/license/CDDL.
  11   11  .\"
  12   12  .\"
  13   13  .\" Copyright (c) 2014 Joyent, Inc.  All rights reserved.
       14 +.\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
  14   15  .\"
  15      -.TH TOWLOWER 3C "Jun 11, 2014"
  16      -
       16 +.TH TOWLOWER 3C "Jun 21, 2014"
  17   17  .SH NAME
  18      -
  19   18  towlower, towlower_l \- transliterate upper-case wide characters to lower-case
  20      -
  21   19  .SH SYNOPSIS
  22      -
  23   20  .LP
  24   21  .nf
  25   22  #include <wctype.h>
  26   23  
  27      -.BI "wint_t towlower(wint_t" wc );
  28      -.BI "wint_t towlower_l(wint_t" wc, " locale_t " loc );
  29      -
       24 +\fBwint_t\fR \fBtowlower\fR(\fBwint_t\fR \fIwc\fR);
       25 +.fi
       26 +.LP
       27 +.nf
       28 +\fBwint_t\fR \fBtowlower_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
       29 +.nf
  30   30  .SH DESCRIPTION
  31      -
  32   31  The function
  33      -.BR towlower
       32 +.BR towlower()
  34   33  is the wide character equivalent of the function
  35      -.BR tolower .
       34 +.BR tolower (3C).
  36   35  It converts the upper-case wide character
  37      -.I loc
       36 +.I wc
  38   37  to the equivalent lower-case
  39   38  wide character, if one exists. If one does not exist, it returns
  40      -.I loc
       39 +.I wc
  41   40  unchanged.
  42      -
  43   41  .LP
  44   42  The function
  45      -.B towlower_l
       43 +.B towlower_l()
  46   44  is equivalent to the function
  47      -.BR towlower ,
  48      -but instead of operating in the current environemnt, operates on the
  49      -environment specified by
       45 +.BR towlower() ,
       46 +but instead of operating in the current locale, operates in the
       47 +locale specified by
  50   48  .IR loc .
  51      -
  52   49  .SH RETURN VALUES
  53      -
  54   50  On successful completion,
  55   51  .B towlower()
  56   52  and
  57   53  .B towlower_l()
  58   54  return the lower-case character that corresponds to the argument passed.
  59   55  Otherwise, they return the argument unchanged.
  60      -
  61   56  .SH ERRORS
  62      -
  63   57  No errors are defined.
  64      -
  65   58  .SH ATTRIBUTES
  66      -.sp
  67   59  .TS
  68   60  box;
  69   61  c | c
  70   62  l | l .
  71   63  ATTRIBUTE TYPE  ATTRIBUTE VALUE
  72   64  _
  73   65  Interface Stability     Standard
  74   66  _
  75      -MT-Level        Safe
       67 +MT-Level        MT-Safe
  76   68  .TE
  77   69  
  78   70  .SH SEE ALSO
  79      -.BR duplocale (3C),
  80   71  .BR newlocale (3C),
  81   72  .BR setlocale (3C),
  82   73  .BR towupper (3C),
  83      -.BR environ (5),
       74 +.BR uselocale (3C),
  84   75  .BR locale (5)
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX