===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/rcs/buf.c,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- src/usr.bin/rcs/buf.c	2010/09/08 15:13:39	1.17
+++ src/usr.bin/rcs/buf.c	2010/09/08 20:49:11	1.18
@@ -1,4 +1,4 @@
-/*	$OpenBSD: buf.c,v 1.17 2010/09/08 15:13:39 tobias Exp $	*/
+/*	$OpenBSD: buf.c,v 1.18 2010/09/08 20:49:11 nicm Exp $	*/
 /*
  * Copyright (c) 2003 Jean-Francois Brousseau <jfb@openbsd.org>
  * All rights reserved.
@@ -53,11 +53,9 @@
 static void	buf_grow(BUF *, size_t);
 
 /*
- * buf_alloc()
- *
  * Create a new buffer structure and return a pointer to it.  This structure
- * uses dynamically-allocated memory and must be freed with buf_free(),
- * once the buffer is no longer needed.
+ * uses dynamically-allocated memory and must be freed with buf_free(), once
+ * the buffer is no longer needed.
  */
 BUF *
 buf_alloc(size_t len)
@@ -78,8 +76,6 @@
 }
 
 /*
- * buf_load()
- *
  * Open the file specified by <path> and load all of its contents into a
  * buffer.
  * Returns the loaded buffer on success or NULL on failure.
@@ -147,11 +143,9 @@
 }
 
 /*
- * buf_release()
- *
  * Free the buffer <b>'s structural information but do not free the contents
  * of the buffer.  Instead, they are returned and should be freed later using
- * free().
+ * xfree().
  */
 void *
 buf_release(BUF *b)
@@ -163,9 +157,6 @@
 	return (tmp);
 }
 
-/*
- * buf_get()
- */
 u_char *
 buf_get(BUF *b)
 {
@@ -173,8 +164,6 @@
 }
 
 /*
- * buf_empty()
- *
  * Empty the contents of the buffer <b> and reset pointers.
  */
 void
@@ -185,8 +174,6 @@
 }
 
 /*
- * buf_putc()
- *
  * Append a single character <c> to the end of the buffer <b>.
  */
 void
@@ -202,10 +189,7 @@
 }
 
 /*
- * buf_getc()
- *
  * Return u_char at buffer position <pos>.
- *
  */
 u_char
 buf_getc(BUF *b, size_t pos)
@@ -214,11 +198,9 @@
 }
 
 /*
- * buf_append()
- *
  * Append <len> bytes of data pointed to by <data> to the buffer <b>.  If the
- * buffer is too small to accept all data, it
- * will get resized to an appropriate size to accept all data.
+ * buffer is too small to accept all data, it will get resized to an
+ * appropriate size to accept all data.
  * Returns the number of bytes successfully appended to the buffer.
  */
 size_t
@@ -239,10 +221,6 @@
 	return (rlen);
 }
 
-/*
- * buf_fappend()
- *
- */
 size_t
 buf_fappend(BUF *b, const char *fmt, ...)
 {
@@ -264,8 +242,6 @@
 }
 
 /*
- * buf_len()
- *
  * Returns the size of the buffer that is being used.
  */
 size_t
@@ -275,8 +251,6 @@
 }
 
 /*
- * buf_write_fd()
- *
  * Write the contents of the buffer <b> to the specified <fd>
  */
 int
@@ -305,8 +279,6 @@
 }
 
 /*
- * buf_write()
- *
  * Write the contents of the buffer <b> to the file whose path is given in
  * <path>.  If the file does not exist, it is created with mode <mode>.
  */
@@ -336,11 +308,9 @@
 }
 
 /*
- * buf_write_stmp()
- *
  * Write the contents of the buffer <b> to a temporary file whose path is
- * specified using <template> (see mkstemp.3). NB. This function will modify
- * <template>, as per mkstemp
+ * specified using <template> (see mkstemp.3).
+ * NB. This function will modify <template>, as per mkstemp
  */
 void
 buf_write_stmp(BUF *b, char *template)
@@ -361,8 +331,6 @@
 }
 
 /*
- * buf_grow()
- *
  * Grow the buffer <b> by <len> bytes.  The contents are unchanged by this
  * operation regardless of the result.
  */