--- a/docs/ccguide/setbuf.refentry	Fri Oct 11 18:49:02 2002 +0000
+++ b/docs/ccguide/setbuf.refentry	Fri Oct 11 19:11:01 2002 +0000
@@ -1,7 +1,7 @@
 <refentry id="setbuf">
 <refnamediv>
-<refname>setbuf</refname>
-<refpurpose>Placeholder</refpurpose>
+<refname>Setbuf</refname>
+<refpurpose>fix file buffer</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -11,7 +11,8 @@
 </funcsynopsisinfo>
 <funcprototype>
   <funcdef><function>setbuf</function></funcdef>
-  <paramdef>type <parameter>arg1</parameter></paramdef>
+  <paramdef>FILE *<parameter>fp</parameter></paramdef>
+  <paramdef>char *<parameter>buffer</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
@@ -19,7 +20,33 @@
 
 <refsect1><title>Description</title>
 <para>
-Placeholder
+When the first character is written to or read from a file
+after it has been opened by "fopen()", a buffer is obtained
+from the system if required and assigned to it. Setbuf may be
+used to forestall this by assigning a user buffer to the file.
+</para>
+<para>
+Setbuf must be used after the file has been opened and before
+any I/O has taken place.
+</para>
+<para>
+The buffer must be of sufficient size and a value for a
+manifest constant, BUFSIZ, is defined in the header file for
+use in declarations.
+</para>
+<para>
+If the "buffer" argument is NULL (0), the file becomes unbuffered
+and characters are read or written singly.
+</para>
+<para>
+NOTE that the standard error output is unbuffered and the
+standard output is buffered.
+</para>
+</refsect1>
+<refsect1><title>See Also</title>
+<para>
+fopen(),getc(),putc()
 </para>
 </refsect1>
 </refentry>
+</refentry>