--- a/docs/ccguide/chmod.refentry	Thu Nov 14 03:55:12 2002 +0000
+++ b/docs/ccguide/chmod.refentry	Fri Nov 15 21:49:51 2002 +0000
@@ -20,9 +20,30 @@
 
 <refsect1><title>Description</title>
 <para>
-Placeholder
+Chmod changes the permission bits associated with a file.
+"Fname" must be a pointer to a file name, and "perm" should
+contain the desired bit pattern,
+</para>
+<para>
+The allowable bit patterns are defined in the include file as follows:
+</para>
+<programlisting>
+/* permissions */
+#define  S_IREAD   0x01     /* owner read */
+#define  S_IWRITE  0x02     /* owner write */
+#define  S_IEXEC   0x04     /* owner execute */
+#define  S_IOREAD  0x08     /* public read */
+#define  S_IOWRITE 0x10     /* public write */
+#define  S_IOEXEC  0x20     /* public execute */
+#define  S_ISHARE  0x40     /* sharable */
+#define  S_IFDIR   0x80     /* directory */
+</programlisting>
+<para>
+Only the owner or the super user may change the permissions of
+a file.
 </para>
 </refsect1>
+
 <refsect1><title>Diagnostics</title>
 <para>
 A successful call returns 0. A -1 is returned if the
@@ -31,4 +52,10 @@
 </para>
 </refsect1>
 
+<refsect1><title>See Also</title>
+<para>
+OS-9 command "attr"
+</para>
+</refsect1>
+
 </refentry>