improved comments

diff --git a/bin/rndc/include/rndc/os.h b/bin/rndc/include/rndc/os.h
index 1d0f822cfbcff1e2ca8f5677a0c35af466438091..292f7b6a14a4cabb389b04c772bc1499a8dd4a3d 100644 (file)
--- a/bin/rndc/include/rndc/os.h
+++ b/bin/rndc/include/rndc/os.h
@@ -2,7 +2,7 @@
  * Copyright
  */
 
-/* $Id: os.h,v 1.1 2001/08/03 05:56:22 marka Exp $ */
+/* $Id: os.h,v 1.2 2001/08/03 23:06:46 gson Exp $ */
 
 #ifndef RNDC_OS_H
 #define RNDC_OS_H 1
@@ -19,13 +19,16 @@ ISC_LANG_BEGINDECLS
 
 FILE *safe_create(const char *filename);
 /*
- * Create and open 'filename' for writing.  Fail if 'filename' exist.
+ * Create and open 'filename' for writing.
+ * Return NULL if 'filename' already exists.
  */
 
 int set_user(FILE *fd, const char *user);
 /*
  * Set the owner of the file refernced by 'fd' to 'user'.
- * Fail is insufficient permissions or 'user' does not exist.
+ * Returns:
+ *   0                 success
+ *   -1        insufficient permissions, or 'user' does not exist.
  */
 
 ISC_LANG_ENDDECLS