changeset 474:31ce96b2dc9d

entered: chdir chmod qsort strass toupper tsleep wait
author roug
date Sun, 06 Oct 2002 09:10:36 +0000
parents 091a1e4ae051
children c8d3a5ef9537
files docs/ccguide/toupper.refentry
diffstat 1 files changed, 25 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/docs/ccguide/toupper.refentry	Sun Oct 06 09:10:36 2002 +0000
+++ b/docs/ccguide/toupper.refentry	Sun Oct 06 09:10:36 2002 +0000
@@ -11,7 +11,19 @@
 </funcsynopsisinfo>
 <funcprototype>
   <funcdef><function>toupper</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>int <parameter>c</parameter></paramdef>
+</funcprototype>
+<funcprototype>
+  <funcdef><function>tolower</function></funcdef>
+  <paramdef>int <parameter>c</parameter></paramdef>
+</funcprototype>
+<funcprototype>
+  <funcdef><function>_toupper</function></funcdef>
+  <paramdef>int <parameter>c</parameter></paramdef>
+</funcprototype>
+<funcprototype>
+  <funcdef><function>_tolower</function></funcdef>
+  <paramdef>int <parameter>c</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
@@ -19,7 +31,18 @@
 
 <refsect1><title>Description</title>
 <para>
-Placeholder
+The functions toupper and tolower have as their domain the
+integers in the range -1 to 255. Toupper converts lower-case
+to upper-case, and tolower converts upper-case to lower-case.
+All other arguments are returned unchanged.
+</para>
+<para>
+The macros _toupper and _tolower do the same things as the
+corresponding functions, but they have restricted domains and
+they are faster. The argument to _toupper must be lower-case,
+and the argument to _tolower must be upper-case. Arguments
+that are outside each macros domain, such as passing a lower-case
+to _tolower, yield garbage results.
 </para>
 </refsect1>
 </refentry>