Switch debian build system to dh

[onak.git] / charfuncs.h

diff --git a/charfuncs.h b/charfuncs.h
index e3501431ab8e86a64481aca9819bba6511f11648..19f38f82279917299128c1e9e1ba4f2190f57a61 100644 (file)
--- a/charfuncs.h
+++ b/charfuncs.h
@@ -1,11 +1,21 @@
-/*
- * 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>
  *
- * Jonathan McDowell <noodles@earth.li>
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the Free
+ * Software Foundation; version 2 of the License.
  *
- * Copyright 2002 Project Purple
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ * more details.
  *
- * $Id: charfuncs.h,v 1.2 2003/06/04 20:57:07 noodles Exp $
+ * 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.
  */
 
 #ifndef __CHARFUNCS_H__
@@ -14,46 +24,55 @@
 #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;
-       int offset;
-       int size;
+       /** 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, unsigned char *c);
+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, unsigned char *c);
+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, unsigned char *c);
+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, unsigned char *c);
+int file_putchar(void *fd, size_t count, void *c);
 
+/**
+ * @brief Gets a char from stdin.
+ */
+int stdin_getchar(void *ctx, size_t count, void *c);
+
+/**
+ * @brief Puts a char to stdout.
+ */
+int stdout_putchar(void *ctx, size_t count, void *c);
 
 #endif /* __CHARFUNCS_H__ */