Changeset 178

Timestamp:

05/26/06 17:46:47 (2 years ago)

Author:

xi

Message:

Doxygenify the header file.

Add basic reader fields to the parser structure.

Start implementing basic parser functions.

Files:

• libyaml/trunk/doc/doxygen.cfg (modified) (4 diffs)
• libyaml/trunk/include/Makefile.am (modified) (1 diff)
• libyaml/trunk/include/yaml/yaml.h (modified) (3 diffs)
• libyaml/trunk/include/yaml/yaml_version.h (modified) (3 diffs)
• libyaml/trunk/src/Makefile.am (modified) (1 diff)
• libyaml/trunk/src/api.c (added)

libyaml/trunk/doc/doxygen.cfg

@@ -11 +11 @@
-USE_WINDOWS_ENCODING   = NO
-BRIEF_MEMBER_DESC      = YES
-NO
+YES
-ABBREVIATE_BRIEF       = 
-ALWAYS_DETAILED_SEC    = NO
@@ -19 +19 @@
-STRIP_FROM_INC_PATH    = 
-SHORT_NAMES            = NO
-NO
+YES
-MULTILINE_CPP_IS_BRIEF = NO
-DETAILS_AT_TOP         = NO
@@ -47 +47 @@
-SHOW_INCLUDE_FILES     = YES
-INLINE_INFO            = YES
-YES
+NO
-SORT_BRIEF_DOCS        = NO
-SORT_BY_SCOPE_NAME     = NO
@@ -118 +118 @@
-TOC_EXPAND             = NO
-DISABLE_INDEX          = NO
-4
+1
-GENERATE_TREEVIEW      = NO
-TREEVIEW_WIDTH         = 250

libyaml/trunk/include/Makefile.am

@@ -1 @@
-
+#
-DOXYGEN_CFG = $(top_srcdir)/doc/doxygen.cfg
-

libyaml/trunk/include/yaml/yaml.h

@@ -3 +3 @@
- * @brief Public interface for libyaml.
- * 
-
+ the code:
- * @code
- * #include <yaml/yaml.h>
@@ -18 +18 @@
-#include <stdlib.h>
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-    YAML_UTF8_ENCODING,
-    YAML_UTF16LE_ENCODING,
-    YAML_UTF16BE_ENCODING
-} yaml_encoding_t;
+
+/** @} */
+
+/*
+
+typedef enum {
+    YAML_NO_ERROR,
+
+    YAML_MEMORY_ERROR,
+
+    YAML_READER_ERROR,
+    YAML_SCANNER_ERROR,
+    YAML_PARSER_ERROR,
+
+    YAML_WRITER_ERROR,
+    YAML_EMITTER_ERROR
+} yaml_error_type_t;
-
-typedef enum {
@@ -183 +235 @@
-} yaml_event_t;
-
+*/
+
+
+/**
+ * @defgroup parser Parser Definitions
+ * @{
+ */
+
+/**
+ * The prototype of a read handler.
+ *
+ * The read handler is called when the parser needs to read more bytes from the
+ * source.  The handler should write not more than @a size bytes to the @a
+ * buffer.  The number of written bytes should be set to the @a length variable.
+ *
+ * @param[in]   ext     A pointer to an application data specified by
+ *                      @c yaml_parser_set_read_handler.
+ * @param[out]  buffer  The buffer to write the data from the source.
+ * @param[in]   size    The size of the buffer.
+ * @param[out]  length  The actual number of bytes read from the source.
+ *
+ * @returns On success, the handler should return @c 1.  If the handler failed,
+ * the returned value should be @c 0.  On EOF, the handler should set the
+ * @a length to @c 0 and return @c 1.
+ */
+typedef int yaml_read_handler_t(void *ext, yaml_char_t *buffer, size_t size,
+        size_t *length);
+
+
+/**
+ * The parser structure.
+ *
+ * All members are internal.  Manage the structure using the @c yaml_parser_
+ * family of functions.
+ */
+
+typedef struct {
+
+    /**
+     * @name Reader stuff
+     * @{
+     */
+
+    /** Read handler */
+    yaml_read_handler_t *reader;
+
+    /** A pointer for passing to the read handler. */
+    void *reader_ext;
+
+    /** EOF flag */
+    int eof;
+
+    /** The pointer to the beginning of the working buffer. */
+    yaml_char_t *buffer;
+
+    /** The pointer to the current character in the working buffer. */
+    yaml_char_t *pointer;
+
+    /** The remaining undecoded characters. */
+    unsigned char *raw_buffer;
+
+    /** The size of the raw buffer. */
+    size_t raw_buffer_size;
+
+    /** The input encoding. */
+    yaml_encoding_t encoding;
+
+    /**
+     * @}
+     */
+
+} yaml_parser_t;
+
+/**
+ * Create a new parser.
+ *
+ * This function creates a new parser object.  An application is responsible
+ * for destroying the object using the @c yaml_parser_delete function.
+ *
+ * @returns A new parser object; @c NULL on error.
+ */
+
+yaml_parser_t *
+yaml_parser_new(void);
+
+/**
+ * Destroy a parser.
+ *
+ * @param[in]   parser  A parser object.
+ */
+
+void
+yaml_parser_delete(yaml_parser_t *parser);
+
+/** @} */
+
-/*
-typedef struct {
-} yaml_parser_t;
-
-typedef struct {
-} yaml_emitter_t;

libyaml/trunk/include/yaml/yaml_version.h

@@ -1 @@
-*
+
- * @file yaml_version.h
- * @brief Version information.
@@ -13 +13 @@
-#endif
-
-*
+
- * @brief Get the library version.
- */
@@ -20 +20 @@
-yaml_get_version_string(void);
-
-*
+
- * @brief Get the library version numbers.
- */

libyaml/trunk/src/Makefile.am

@@ -1 +1 @@
-AM_CPPFLAGS = -I$(top_srcdir)/include
-lib_LTLIBRARIES = libyaml.la
-
+ api.c
-libyaml_la_LDFLAGS = -release $(YAML_LT_RELEASE) -version-info $(YAML_LT_CURRENT):$(YAML_LT_REVISION):$(YAML_LT_AGE)