X-Git-Url: https://the.earth.li/gitweb/?p=onak.git;a=blobdiff_plain;f=charfuncs.h;h=5dadf6631d86925939761c1071466396d7181ef9;hp=b9c9c4638674bc7d777f8599cff2e1c74e0a9296;hb=58ed9a0076feb9604154b99da6ed1907ca7df089;hpb=5e1b22d763640c4d7a09d07920403d8d491b4410

diff --git a/charfuncs.h b/charfuncs.h
index b9c9c46..5dadf66 100644
--- a/charfuncs.h
+++ b/charfuncs.h
@@ -1,5 +1,6 @@
-/*
- * charfuncs.h - Routines for dealing with character streams.
+/**
+ * @file charfuncs.h
+ * @brief Routines for dealing with character streams.
  *
  * Copyright 2002 Jonathan McDowell <noodles@earth.li>
  *
@@ -13,8 +14,7 @@
  * more details.
  *
  * You should have received a copy of the GNU General Public License along with
- * this program; if not, write to the Free Software Foundation, Inc., 51
- * Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
 #ifndef __CHARFUNCS_H__
@@ -23,54 +23,54 @@
 #include <stdlib.h>
 
 /**
- *	buffer_ctx - Shared with CGI buffer stuff...
- *	@buffer: The data buffer.
- *	@offset: Our current position in the buffer.
- *	@size: The size of the data buffer.
+ * @brief Shared with CGI buffer stuff...
  */
 struct buffer_ctx {
+	/** The data buffer. */
 	char *buffer;
+	/** Our current position in the buffer. */
 	size_t offset;
+	/** The size of the data buffer. */
 	size_t size;
 };
 
 /**
- *	buffer_fetchchar - Fetches a char from a buffer.
- *	@ctx: Our buffer context structure.
- *	@count: The number of characters to get from the buffer.
- *	@c: Where to put the characters retrieved.
+ * @brief Fetches a char from a buffer.
+ * @param ctx Our buffer context structure.
+ * @param count The number of characters to get from the buffer.
+ * @param c Where to put the characters retrieved.
  */
 int buffer_fetchchar(void *ctx, size_t count, void *c);
 
 /**
- *	buffer_putchar - Puts a char to a buffer.
- *	@ctx: Our buffer context structure.
- *	@count: The number of characters to put into the buffer.
- *	@c: The characters to add to the buffer.
+ * @brief Puts a char to a buffer.
+ * @param ctx Our buffer context structure.
+ * @param count The number of characters to put into the buffer.
+ * @param c The characters to add to the buffer.
  *
- *	Adds characters to the buffer references by the buffer context. If we
- *	fill it then we double the size of the current buffer and then add the
- *	rest.
+ * Adds characters to the buffer references by the buffer context. If we
+ * fill it then we double the size of the current buffer and then add the
+ * rest.
  */
 int buffer_putchar(void *ctx, size_t count, void *c);
 
 /**
- *	file_fetchchar - Fetches a char from a file.
+ * @brief Fetches a char from a file.
  */
 int file_fetchchar(void *fd, size_t count, void *c);
 
 /**
- *	file_putchar - Puts a char to a file.
+ * @brief Puts a char to a file.
  */
 int file_putchar(void *fd, size_t count, void *c);
 
 /**
- *	stdin_getchar - Gets a char from stdin.
+ * @brief Gets a char from stdin.
  */
 int stdin_getchar(void *ctx, size_t count, void *c);
 
 /**
- *	stdout_putchar - Puts a char to stdout.
+ * @brief Puts a char to stdout.
  */
 int stdout_putchar(void *ctx, size_t count, void *c);