From 6ea8aad0266f43e8d461ea7309c2120a4cb799b6 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Sun, 30 Nov 2014 09:49:11 -0800 Subject: cmark.h: Use C89 comments. --- src/cmark.h | 237 +++++++++++++++++++++++++++++++++++++----------------------- 1 file changed, 147 insertions(+), 90 deletions(-) (limited to 'src') diff --git a/src/cmark.h b/src/cmark.h index 2bf882a..a834485 100644 --- a/src/cmark.h +++ b/src/cmark.h @@ -8,64 +8,72 @@ extern "C" { #endif -/// # NAME -/// -/// cmark - CommonMark parsing, manipulating, and rendering +/** # NAME + * + * cmark - CommonMark parsing, manipulating, and rendering + */ -/// # SIMPLE INTERFACE +/** # SIMPLE INTERFACE + */ -/// Current version of library. +/** Current version of library. + */ #define CMARK_VERSION "0.1" -/// Convert `text` (assumed to be a UTF-8 encoded string with length `len`) -/// from CommonMark Markdown to HTML, returning a null-terminated, -/// UTF-8-encoded string. +/** Convert `text` (assumed to be a UTF-8 encoded string with length `len`) + * from CommonMark Markdown to HTML, returning a null-terminated, + * UTF-8-encoded string. + */ CMARK_EXPORT char *cmark_markdown_to_html(const char *text, int len); -/// # NODE STRUCTURE +/** # NODE STRUCTURE + */ -/// +/** + */ typedef enum { - // Block - CMARK_NODE_DOCUMENT, - CMARK_NODE_BLOCK_QUOTE, - CMARK_NODE_LIST, - CMARK_NODE_LIST_ITEM, - CMARK_NODE_CODE_BLOCK, - CMARK_NODE_HTML, - CMARK_NODE_PARAGRAPH, - CMARK_NODE_HEADER, - CMARK_NODE_HRULE, - CMARK_NODE_REFERENCE_DEF, - - CMARK_NODE_FIRST_BLOCK = CMARK_NODE_DOCUMENT, - CMARK_NODE_LAST_BLOCK = CMARK_NODE_REFERENCE_DEF, - - // Inline - CMARK_NODE_TEXT, - CMARK_NODE_SOFTBREAK, - CMARK_NODE_LINEBREAK, - CMARK_NODE_INLINE_CODE, - CMARK_NODE_INLINE_HTML, - CMARK_NODE_EMPH, - CMARK_NODE_STRONG, - CMARK_NODE_LINK, - CMARK_NODE_IMAGE, - - CMARK_NODE_FIRST_INLINE = CMARK_NODE_TEXT, - CMARK_NODE_LAST_INLINE = CMARK_NODE_IMAGE, + /* Block */ + CMARK_NODE_DOCUMENT, + CMARK_NODE_BLOCK_QUOTE, + CMARK_NODE_LIST, + CMARK_NODE_LIST_ITEM, + CMARK_NODE_CODE_BLOCK, + CMARK_NODE_HTML, + CMARK_NODE_PARAGRAPH, + CMARK_NODE_HEADER, + CMARK_NODE_HRULE, + CMARK_NODE_REFERENCE_DEF, + + CMARK_NODE_FIRST_BLOCK = CMARK_NODE_DOCUMENT, + CMARK_NODE_LAST_BLOCK = CMARK_NODE_REFERENCE_DEF, + + /* Inline */ + CMARK_NODE_TEXT, + CMARK_NODE_SOFTBREAK, + CMARK_NODE_LINEBREAK, + CMARK_NODE_INLINE_CODE, + CMARK_NODE_INLINE_HTML, + CMARK_NODE_EMPH, + CMARK_NODE_STRONG, + CMARK_NODE_LINK, + CMARK_NODE_IMAGE, + + CMARK_NODE_FIRST_INLINE = CMARK_NODE_TEXT, + CMARK_NODE_LAST_INLINE = CMARK_NODE_IMAGE, } cmark_node_type; -/// +/** + */ typedef enum { CMARK_NO_LIST, CMARK_BULLET_LIST, CMARK_ORDERED_LIST } cmark_list_type; -/// +/** + */ typedef enum { CMARK_PERIOD_DELIM, CMARK_PAREN_DELIM @@ -74,181 +82,230 @@ typedef enum { typedef struct cmark_node cmark_node; typedef struct cmark_parser cmark_parser; -/// # CREATING AND DESTORYING NODES +/** + * # CREATING AND DESTORYING NODES + */ -/// +/** + */ CMARK_EXPORT cmark_node* cmark_node_new(cmark_node_type type); -/// +/** + */ CMARK_EXPORT void cmark_node_free(cmark_node *node); -/// # TREE TRAVERSAL - -/// +/** + * # TREE TRAVERSAL + */ CMARK_EXPORT cmark_node* cmark_node_next(cmark_node *node); -/// +/** + */ CMARK_EXPORT cmark_node* cmark_node_previous(cmark_node *node); -/// +/** + */ CMARK_EXPORT cmark_node* cmark_node_parent(cmark_node *node); -/// +/** + */ CMARK_EXPORT cmark_node* cmark_node_first_child(cmark_node *node); -/// +/** + */ CMARK_EXPORT cmark_node* cmark_node_last_child(cmark_node *node); -/// # ACCESSORS +/** + * # ACCESSORS + */ -/// +/** + */ CMARK_EXPORT cmark_node_type cmark_node_get_type(cmark_node *node); -/// +/** + */ CMARK_EXPORT const char* cmark_node_get_string_content(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_set_string_content(cmark_node *node, const char *content); -/// +/** + */ CMARK_EXPORT int cmark_node_get_header_level(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_set_header_level(cmark_node *node, int level); -/// +/** + */ CMARK_EXPORT cmark_list_type cmark_node_get_list_type(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_set_list_type(cmark_node *node, cmark_list_type type); -/// +/** + */ CMARK_EXPORT int cmark_node_get_list_start(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_set_list_start(cmark_node *node, int start); -/// +/** + */ CMARK_EXPORT int cmark_node_get_list_tight(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_set_list_tight(cmark_node *node, int tight); -/// +/** + */ CMARK_EXPORT const char* cmark_node_get_fence_info(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_set_fence_info(cmark_node *node, const char *info); -/// +/** + */ CMARK_EXPORT const char* cmark_node_get_url(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_set_url(cmark_node *node, const char *url); -/// +/** + */ CMARK_EXPORT const char* cmark_node_get_title(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_set_title(cmark_node *node, const char *title); -/// +/** + */ CMARK_EXPORT int cmark_node_get_start_line(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_get_start_column(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_get_end_line(cmark_node *node); -/// # TREE MANIPULATION +/** + * # TREE MANIPULATION + */ -/// +/** + */ CMARK_EXPORT void cmark_node_unlink(cmark_node *node); -/// +/** + */ CMARK_EXPORT int cmark_node_insert_before(cmark_node *node, cmark_node *sibling); -/// +/** + */ CMARK_EXPORT int cmark_node_insert_after(cmark_node *node, cmark_node *sibling); -/// +/** + */ CMARK_EXPORT int cmark_node_prepend_child(cmark_node *node, cmark_node *child); -/// +/** + */ CMARK_EXPORT int cmark_node_append_child(cmark_node *node, cmark_node *child); -/// # PARSING +/** + * # PARSING + */ -/// +/** + */ CMARK_EXPORT cmark_parser *cmark_parser_new(); -/// +/** + */ CMARK_EXPORT void cmark_parser_free(cmark_parser *parser); -/// +/** + */ CMARK_EXPORT cmark_node *cmark_parser_finish(cmark_parser *parser); -/// +/** + */ CMARK_EXPORT void cmark_parser_feed(cmark_parser *parser, const char *buffer, size_t len); -/// +/** + */ CMARK_EXPORT cmark_node *cmark_parse_document(const char *buffer, size_t len); -/// +/** + */ CMARK_EXPORT cmark_node *cmark_parse_file(FILE *f); -/// # RENDERING +/** + * # RENDERING + */ -/// +/** + */ CMARK_EXPORT char *cmark_render_ast(cmark_node *root); -/// +/** + */ CMARK_EXPORT char *cmark_render_html(cmark_node *root); -/// # AUTHORS -/// -/// John MacFarlane, Vicent Marti, Kārlis Gaņģis, Nick Wellnhofer. +/** # AUTHORS + * John MacFarlane, Vicent Marti, Kārlis Gaņģis, Nick Wellnhofer. + */ #ifndef CMARK_NO_SHORT_NAMES #define NODE_DOCUMENT CMARK_NODE_DOCUMENT -- cgit v1.2.3