Fixed clarity in libmdocml.c.

[mandoc.git] / libmdocml.h

diff --git a/libmdocml.h b/libmdocml.h
index 208cf75c67483c5214276a9a6fb60a936f1d85d2..58c16a1f5c36aee25b15bdaa254bc3a57488cd5f 100644 (file)
--- a/libmdocml.h
+++ b/libmdocml.h
@@ -1,4 +1,4 @@
-/* $Id: libmdocml.h,v 1.1 2008/11/22 14:53:29 kristaps Exp $ */
+/* $Id: libmdocml.h,v 1.6 2008/11/23 23:12:47 kristaps Exp $ */
 /*
  * Copyright (c) 2008 Kristaps Dzonsons <kristaps@kth.se>
  *
@@ -19,8 +19,48 @@
 #ifndef LIBMDOCML_H
 #define LIBMDOCML_H
 
+#include <sys/types.h>
+
+struct         md_params_dummy {
+       int              dummy;
+};
+
+struct         md_params_html4_strict {
+       int              dummy;
+};
+
+union  md_params {
+       struct md_params_dummy dummy;
+       struct md_params_html4_strict html4_strict;
+};
+
+enum   md_type {
+       MD_DUMMY,               /* Dummy type echoes input. */
+       MD_HTML4_STRICT         /* HTML4.01-strict. */
+};
+
+struct md_args {
+       union md_params  params;/* Parameters for parser. */
+       enum md_type     type;  /* Type of parser. */
+       int              dbg;   /* Debug level. */
+#define        MD_DBG_TREE      1
+};
+
+struct md_buf {
+       int              fd;    /* Open file descriptor. */
+       char            *name;  /* Name of file/socket/whatever. */
+       char            *buf;   /* Buffer for storing data. */
+       size_t           bufsz; /* Size of buf. */
+};
+
 __BEGIN_DECLS
 
+/* Run the parser over prepared input and output buffers.  Returns -1 on
+ * failure and 0 on success.
+ */
+int    md_run(const struct md_args *,
+               const struct md_buf *, const struct md_buf *);
+
 __END_DECLS
 
 #endif /*!LIBMDOCML_H*/