changeset 570:253b6096ee01

All function prototypes are added.
author roug
date Fri, 01 Nov 2002 10:02:34 +0000
parents 3cd7606d9c7b
children 24956f96b7dd
files docs/ccguide/ccguide.docbook docs/ccguide/chap4.chapter docs/ccguide/chown.refentry docs/ccguide/crc.refentry docs/ccguide/creat.refentry docs/ccguide/exit.refentry docs/ccguide/fclose.refentry docs/ccguide/feof.refentry docs/ccguide/fflush.refentry docs/ccguide/fopen.refentry docs/ccguide/fread.refentry docs/ccguide/fseek.refentry docs/ccguide/getc.refentry docs/ccguide/getpid.refentry docs/ccguide/gets.refentry docs/ccguide/getstat.refentry docs/ccguide/getuid.refentry docs/ccguide/intercept.refentry docs/ccguide/isalpha.refentry docs/ccguide/kill.refentry docs/ccguide/lseek.refentry docs/ccguide/makefile docs/ccguide/mknod.refentry docs/ccguide/mktemp.refentry docs/ccguide/modload.refentry
diffstat 25 files changed, 215 insertions(+), 74 deletions(-) [+]
line wrap: on
line diff
--- a/docs/ccguide/ccguide.docbook	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/ccguide.docbook	Fri Nov 01 10:02:34 2002 +0000
@@ -58,7 +58,7 @@
   <!ENTITY writeref       SYSTEM "write.refentry">
 
   <!ENTITY atofref       SYSTEM "atof.refentry">
-  <!ENTITY fflushref       SYSTEM "fflush.refentry">
+  <!ENTITY fcloseref       SYSTEM "fclose.refentry">
   <!ENTITY feofref       SYSTEM "feof.refentry">
   <!ENTITY findstrref       SYSTEM "findstr.refentry">
   <!ENTITY fopenref       SYSTEM "fopen.refentry">
--- a/docs/ccguide/chap4.chapter	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/chap4.chapter	Fri Nov 01 10:02:34 2002 +0000
@@ -13,7 +13,7 @@
 </para>
 
 &atofref;
-&fflushref;
+&fcloseref;
 &feofref;
 &findstrref;
 &fopenref;
--- a/docs/ccguide/chown.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/chown.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -8,7 +8,8 @@
 <funcsynopsis>
 <funcprototype>
   <funcdef><function>chown</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>char *<parameter>fname</parameter></paramdef>
+  <paramdef>int <parameter>ownerid</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/crc.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/crc.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -8,7 +8,9 @@
 <funcsynopsis>
 <funcprototype>
   <funcdef><function>crc</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>char *<parameter>start</parameter></paramdef>
+  <paramdef>int <parameter>count</parameter></paramdef>
+  <paramdef>char <parameter>accum</parameter>[3]</paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/creat.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/creat.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -11,7 +11,8 @@
 </funcsynopsisinfo>
 <funcprototype>
   <funcdef><function>creat</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>char *<parameter>fname</parameter></paramdef>
+  <paramdef>int <parameter>perm</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/exit.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/exit.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -9,7 +9,12 @@
 <funcsynopsis>
 <funcprototype>
   <funcdef><function>exit</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>int <parameter>status</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef><function>_exit</function></funcdef>
+  <paramdef>int <parameter>status</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/ccguide/fclose.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -0,0 +1,40 @@
+<refentry id="fclose">
+<refnamediv>
+<refname>Fclose</refname>
+<refname>Fflush</refname>
+<refpurpose>flush or close a file</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<funcsynopsis>
+<funcsynopsisinfo>
+#include &lt;stdio.h&gt;
+</funcsynopsisinfo>
+
+<funcprototype>
+  <funcdef><function>fclose</function></funcdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef><function>fflush</function></funcdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
+</funcprototype>
+
+</funcsynopsis>
+
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+Placeholder
+</para>
+</refsect1>
+<refsect1><title>Diagnostics</title>
+<para>
+EOF is returned if "fp" does not refer to an output file or
+there is an error writing to the file.
+</para>
+</refsect1>
+
+</refentry>
--- a/docs/ccguide/feof.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/feof.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -1,7 +1,10 @@
 <refentry id="feof">
 <refnamediv>
-<refname>feof</refname>
-<refpurpose>Placeholder</refpurpose>
+<refname>Feof</refname>
+<refname>Ferror</refname>
+<refname>Clearerr</refname>
+<refname>Fileno</refname>
+<refpurpose>return status information of files</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -11,7 +14,22 @@
 </funcsynopsisinfo>
 <funcprototype>
   <funcdef><function>feof</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef><function>ferror</function></funcdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef><function>clearerr</function></funcdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef><function>fileno</function></funcdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/fflush.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,32 +0,0 @@
-<refentry id="fflush">
-<refnamediv>
-<refname>fflush</refname>
-<refpurpose>Placeholder</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<funcsynopsis>
-<funcsynopsisinfo>
-#include &lt;stdio.h&gt;
-</funcsynopsisinfo>
-<funcprototype>
-  <funcdef><function>fflush</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
-</funcprototype>
-</funcsynopsis>
-
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-Placeholder
-</para>
-</refsect1>
-<refsect1><title>Diagnostics</title>
-<para>
-EOF is returned if "fp" does not refer to an output file or
-there is an error writing to the file.
-</para>
-</refsect1>
-
-</refentry>
--- a/docs/ccguide/fopen.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/fopen.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -1,7 +1,7 @@
 <refentry id="fopen">
 <refnamediv>
 <refname>fopen</refname>
-<refpurpose>Placeholder</refpurpose>
+<refpurpose>open a file and return a file pointer</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -162,7 +162,7 @@
 <para>
 System call
 <link linkend="open">open()</link>,
-<link linkend="fflush">fclose()</link>
+<link linkend="fclose">fclose()</link>
 </para>
 </refsect1>
 
--- a/docs/ccguide/fread.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/fread.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -1,7 +1,8 @@
 <refentry id="fread">
 <refnamediv>
-<refname>fread</refname>
-<refpurpose>Placeholder</refpurpose>
+<refname>Fread</refname>
+<refname>Fwrite</refname>
+<refpurpose>read/write binary data</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -11,7 +12,18 @@
 </funcsynopsisinfo>
 <funcprototype>
   <funcdef><function>fread</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>char *<parameter>ptr</parameter></paramdef>
+  <paramdef>int <parameter>size</parameter></paramdef>
+  <paramdef>int <parameter>number</parameter></paramdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef><function>fwrite</function></funcdef>
+  <paramdef>char *<parameter>ptr</parameter></paramdef>
+  <paramdef>int <parameter>size</parameter></paramdef>
+  <paramdef>int <parameter>number</parameter></paramdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/fseek.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/fseek.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -1,7 +1,9 @@
 <refentry id="fseek">
 <refnamediv>
-<refname>fseek</refname>
-<refpurpose>Placeholder</refpurpose>
+<refname>Fseek</refname>
+<refname>Rewind</refname>
+<refname>Ftell</refname>
+<refpurpose>position in a file or report current position</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -9,9 +11,22 @@
 <funcsynopsisinfo>
 #include &lt;stdio.h&gt;
 </funcsynopsisinfo>
+
 <funcprototype>
   <funcdef><function>fseek</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
+  <paramdef>long <parameter>offset</parameter></paramdef>
+  <paramdef>int <parameter>place</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef><function>rewind</function></funcdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef>long <function>ftell</function></funcdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/getc.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/getc.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -1,7 +1,9 @@
 <refentry id="getc">
 <refnamediv>
-<refname>getc</refname>
-<refpurpose>Placeholder</refpurpose>
+<refname>Getc</refname>
+<refname>Getchar</refname>
+<refname>Getw</refname>
+<refpurpose>return next character to be read from a file</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -9,9 +11,18 @@
 <funcsynopsisinfo>
 #include &lt;stdio.h&gt;
 </funcsynopsisinfo>
+
 <funcprototype>
-  <funcdef><function>getc</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <funcdef>int <function>getc</function></funcdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
+</funcprototype>
+<funcprototype>
+  <funcdef>int <function>getchar</function></funcdef>
+  <void>
+</funcprototype>
+<funcprototype>
+  <funcdef>int <function>getw</function></funcdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/getpid.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/getpid.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -8,7 +8,7 @@
 <funcsynopsis>
 <funcprototype>
   <funcdef><function>getpid</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <void>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/gets.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/gets.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -1,7 +1,8 @@
 <refentry id="gets">
 <refnamediv>
-<refname>gets</refname>
-<refpurpose>Placeholder</refpurpose>
+<refname>Gets</refname>
+<refname>Fgets</refname>
+<refpurpose>input a string</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -10,8 +11,15 @@
 #include &lt;stdio.h&gt;
 </funcsynopsisinfo>
 <funcprototype>
-  <funcdef><function>gets</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <funcdef>char *<function>gets</function></funcdef>
+  <paramdef>char *<parameter>s</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef>char *<function>fgets</function></funcdef>
+  <paramdef>char *<parameter>s</parameter></paramdef>
+  <paramdef>int <parameter>n</parameter></paramdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/getstat.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/getstat.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -9,9 +9,44 @@
 <funcsynopsisinfo>
 #include &lt;sgstat.h&gt;
 </funcsynopsisinfo>
+
+<funcsynopsisinfo>
+/* code 0 */
+</funcsynopsisinfo>
+<funcprototype>
+  <funcdef><function>getstat</function></funcdef>
+  <paramdef>int <parameter>code</parameter></paramdef>
+  <paramdef>int <parameter>filenum</parameter></paramdef>
+  <paramdef>char *<parameter>buffer</parameter></paramdef>
+</funcprototype>
+
+<funcsynopsisinfo>
+/* codes 1 and 6 */
+</funcsynopsisinfo>
 <funcprototype>
   <funcdef><function>getstat</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>int <parameter>code</parameter></paramdef>
+  <paramdef>int <parameter>filenum</parameter></paramdef>
+</funcprototype>
+
+<funcsynopsisinfo>
+/* code 2 */
+</funcsynopsisinfo>
+<funcprototype>
+  <funcdef><function>getstat</function></funcdef>
+  <paramdef>int <parameter>code</parameter></paramdef>
+  <paramdef>int <parameter>filenum</parameter></paramdef>
+  <paramdef>long *<parameter>size</parameter></paramdef>
+</funcprototype>
+
+<funcsynopsisinfo>
+/* code 5 */
+</funcsynopsisinfo>
+<funcprototype>
+  <funcdef><function>getstat</function></funcdef>
+  <paramdef>int <parameter>code</parameter></paramdef>
+  <paramdef>int <parameter>filenum</parameter></paramdef>
+  <paramdef>long *<parameter>pos</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/getuid.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/getuid.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -8,7 +8,7 @@
 <funcsynopsis>
 <funcprototype>
   <funcdef><function>getuid</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <void>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/intercept.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/intercept.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -8,7 +8,8 @@
 <funcsynopsis>
 <funcprototype>
   <funcdef><function>intercept</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+    <paramdef>int <parameter>(* func)</parameter>
+        <funcparams>int</funcparams></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/isalpha.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/isalpha.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -1,7 +1,16 @@
 <refentry id="isalpha">
 <refnamediv>
-<refname>isalpha</refname>
-<refpurpose>Placeholder</refpurpose>
+<refname>Isalpha</refname>
+<refname>Isupper</refname>
+<refname>Islower</refname>
+<refname>Isdigit</refname>
+<refname>Isalnum</refname>
+<refname>Isspace</refname>
+<refname>Ispunct</refname>
+<refname>Isprint</refname>
+<refname>Iscntrl</refname>
+<refname>Isascii</refname>
+<refpurpose>character classification</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -9,9 +18,10 @@
 <funcsynopsisinfo>
 #include &lt;ctype.h&gt;
 </funcsynopsisinfo>
+
 <funcprototype>
   <funcdef><function>isalpha</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>int <parameter>c</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/kill.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/kill.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -11,7 +11,8 @@
 </funcsynopsisinfo>
 <funcprototype>
   <funcdef><function>kill</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>int <parameter>tid</parameter></paramdef>
+  <paramdef>int <parameter>interrupt</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/lseek.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/lseek.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -8,7 +8,9 @@
 <funcsynopsis>
 <funcprototype>
   <funcdef><function>lseek</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>int <parameter>pn</parameter></paramdef>
+  <paramdef>long <parameter>position</parameter></paramdef>
+  <paramdef>int <parameter>type</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/makefile	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/makefile	Fri Nov 01 10:02:34 2002 +0000
@@ -3,7 +3,7 @@
 
 PREFACE		= intro.preface
 CHAPTERS	= chap1.chapter chap2.chapter chap3.chapter chap4.chapter
-STDLIB		= atof.refentry fflush.refentry feof.refentry \
+STDLIB		= atof.refentry fclose.refentry feof.refentry \
 		findstr.refentry fopen.refentry fread.refentry \
 		fseek.refentry getc.refentry gets.refentry isalpha.refentry \
 		l3tol.refentry longjmp.refentry malloc.refentry \
--- a/docs/ccguide/mknod.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/mknod.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -11,7 +11,8 @@
 </funcsynopsisinfo>
 <funcprototype>
   <funcdef><function>mknod</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>char *<parameter>fname</parameter></paramdef>
+  <paramdef>int <parameter>desc</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/mktemp.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/mktemp.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -1,14 +1,14 @@
 <refentry id="mktemp">
 <refnamediv>
-<refname>mktemp</refname>
-<refpurpose>Placeholder</refpurpose>
+<refname>Mktemp</refname>
+<refpurpose>create unique temporary file name</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
 <funcsynopsis>
 <funcprototype>
-  <funcdef><function>mktemp</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <funcdef>char *<function>mktemp</function></funcdef>
+  <paramdef>char *<parameter>name</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
--- a/docs/ccguide/modload.refentry	Thu Oct 31 22:05:32 2002 +0000
+++ b/docs/ccguide/modload.refentry	Fri Nov 01 10:02:34 2002 +0000
@@ -9,9 +9,19 @@
 <funcsynopsisinfo>
 #include &lt;module.h&gt;
 </funcsynopsisinfo>
+
 <funcprototype>
-  <funcdef><function>modload</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <funcdef>mod_exec *<function>modlink</function></funcdef>
+  <paramdef>char *<parameter>modname</parameter></paramdef>
+  <paramdef>int <parameter>type</parameter></paramdef>
+  <paramdef>int <parameter>language</parameter></paramdef>
+</funcprototype>
+
+<funcprototype>
+  <funcdef>mod_exec *<function>modload</function></funcdef>
+  <paramdef>char *<parameter>modname</parameter></paramdef>
+  <paramdef>int <parameter>type</parameter></paramdef>
+  <paramdef>int <parameter>language</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>