5025 import and use mandoc
Reviewed by: Hans Rosenfeld <hans.rosenfeld@nexenta.com>
Reviewed by: Igor Kozhukhov <ikozhukhov@gmail.com>
Reviewed by: Robert Mustacchi <rm@joyent.com>
Reviewed by: Albert Lee <trisk@nexenta.com>
Approved by: TBD

          --- old/usr/src/man/man3c/towlower.3c
          +++ new/usr/src/man/man3c/towlower.3c

   1    1  '\" te
   2    2  .\"
   3    3  .\" This file and its contents are supplied under the terms of the
   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   14  .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
  15   15  .\"
  16   16  .TH TOWLOWER 3C "Jun 21, 2014"
  17   17  .SH NAME
  18   18  towlower, towlower_l \- transliterate upper-case wide characters to lower-case

  19   19  .SH SYNOPSIS
  20   20  .LP
  21   21  .nf
  22   22  #include <wctype.h>
  23   23  
  24   24  \fBwint_t\fR \fBtowlower\fR(\fBwint_t\fR \fIwc\fR);
  25   25  .fi
  26   26  .LP
  27   27  .nf
  28   28  \fBwint_t\fR \fBtowlower_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
  29      -.nf
       29 +.fi
  30   30  .SH DESCRIPTION
  31   31  The function
  32   32  .BR towlower()
  33   33  is the wide character equivalent of the function
  34   34  .BR tolower (3C).
  35   35  It converts the upper-case wide character
  36   36  .I wc
  37   37  to the equivalent lower-case
  38   38  wide character, if one exists. If one does not exist, it returns
  39   39  .I wc

  40   40  unchanged.
  41   41  .LP
  42   42  The function
  43   43  .B towlower_l()
  44   44  is equivalent to the function
  45   45  .BR towlower() ,
  46   46  but instead of operating in the current locale, operates in the
  47   47  locale specified by
  48   48  .IR loc .
  49   49  .SH RETURN VALUES
  50   50  On successful completion,
  51   51  .B towlower()
  52   52  and
  53   53  .B towlower_l()
  54   54  return the lower-case character that corresponds to the argument passed.
  55   55  Otherwise, they return the argument unchanged.
  56   56  .SH ERRORS
  57   57  No errors are defined.
  58   58  .SH ATTRIBUTES
  59   59  .TS
  60   60  box;
  61   61  c | c
  62   62  l | l .
  63   63  ATTRIBUTE TYPE  ATTRIBUTE VALUE
  64   64  _
  65   65  Interface Stability     Standard
  66   66  _
  67   67  MT-Level        MT-Safe
  68   68  .TE
  69   69  
  70   70  .SH SEE ALSO
  71   71  .BR newlocale (3C),
  72   72  .BR setlocale (3C),
  73   73  .BR towupper (3C),
  74   74  .BR uselocale (3C),
  75   75  .BR locale (5)

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX