From cc2843b8cb769f0fa60c45a2e0f8f781dff9e845 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Sat, 13 Dec 2014 20:46:16 -0800 Subject: Write API docs in cmark.h using markdown. `man/make_man_page.py` now converts using cmark. --- man/man3/cmark.3 | 134 +++++++++++++++++++++++++++---------------------------- 1 file changed, 66 insertions(+), 68 deletions(-) (limited to 'man/man3') diff --git a/man/man3/cmark.3 b/man/man3/cmark.3 index 5f6d296..5228cf1 100644 --- a/man/man3/cmark.3 +++ b/man/man3/cmark.3 @@ -1,12 +1,13 @@ .TH cmark 3 "December 13, 2014" "LOCAL" "Library Functions Manual" -.SH NAME - -.B cmark -\- CommonMark parsing, manipulating, and rendering - -.SH DESCRIPTION +.SH +NAME +.PP +\f[B]cmark\f[] \- CommonMark parsing, manipulating, and rendering -.SS Simple Interface +.SH +DESCRIPTION +.SS +Simple Interface .nf \f[C] @@ -16,17 +17,16 @@ \f[] .fi -.PP Current version of library. \fIchar *\fR \fBcmark_markdown_to_html\fR(\fIconst char *text\fR, \fIint len\fR) -.PP Convert \fItext\fR (assumed to be a UTF-8 encoded string with length \fIlen\fR from CommonMark Markdown to HTML, returning a null-terminated, UTF-8-encoded string. -.SS Node Structure +.SS +Node Structure .nf \f[C] @@ -67,7 +67,7 @@ typedef enum { \f[] .fi -.PP + .nf \f[C] @@ -81,7 +81,7 @@ typedef enum { \f[] .fi -.PP + .nf \f[C] @@ -94,209 +94,207 @@ typedef enum { \f[] .fi -.PP -.SS Creating and Destroying Nodes +.SS +Creating and Destroying Nodes \fIcmark_node*\fR \fBcmark_node_new\fR(\fIcmark_node_type type\fR) -.PP -\fIvoid\fR \fBcmark_node_free\fR(\fIcmark_node *node\fR) -.PP +\fIvoid\fR \fBcmark_node_free\fR(\fIcmark_node *node\fR) -\fIcmark_node*\fR \fBcmark_node_next\fR(\fIcmark_node *node\fR) -.PP -.SS Tree Traversal +.SS +Tree Traversal \fIcmark_node*\fR \fBcmark_node_previous\fR(\fIcmark_node *node\fR) -.PP + \fIcmark_node*\fR \fBcmark_node_parent\fR(\fIcmark_node *node\fR) -.PP + \fIcmark_node*\fR \fBcmark_node_first_child\fR(\fIcmark_node *node\fR) -.PP + \fIcmark_node*\fR \fBcmark_node_last_child\fR(\fIcmark_node *node\fR) -.PP -.SS Iterator +.SS +Iterator \fIcmark_iter*\fR \fBcmark_iter_new\fR(\fIcmark_node *root\fR) -.PP + \fIvoid\fR \fBcmark_iter_free\fR(\fIcmark_iter *iter\fR) -.PP + \fIcmark_event_type\fR \fBcmark_iter_next\fR(\fIcmark_iter *iter\fR) -.PP + \fIcmark_node*\fR \fBcmark_iter_get_node\fR(\fIcmark_iter *iter\fR) -.PP -.SS Accessors +.SS +Accessors \fIcmark_node_type\fR \fBcmark_node_get_type\fR(\fIcmark_node *node\fR) -.PP + \fIconst char*\fR \fBcmark_node_get_string_content\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_set_string_content\fR(\fIcmark_node *node\fR, \fIconst char *content\fR) -.PP + \fIint\fR \fBcmark_node_get_header_level\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_set_header_level\fR(\fIcmark_node *node\fR, \fIint level\fR) -.PP + \fIcmark_list_type\fR \fBcmark_node_get_list_type\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_set_list_type\fR(\fIcmark_node *node\fR, \fIcmark_list_type type\fR) -.PP + \fIint\fR \fBcmark_node_get_list_start\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_set_list_start\fR(\fIcmark_node *node\fR, \fIint start\fR) -.PP + \fIint\fR \fBcmark_node_get_list_tight\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_set_list_tight\fR(\fIcmark_node *node\fR, \fIint tight\fR) -.PP + \fIconst char*\fR \fBcmark_node_get_fence_info\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_set_fence_info\fR(\fIcmark_node *node\fR, \fIconst char *info\fR) -.PP + \fIconst char*\fR \fBcmark_node_get_url\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_set_url\fR(\fIcmark_node *node\fR, \fIconst char *url\fR) -.PP + \fIconst char*\fR \fBcmark_node_get_title\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_set_title\fR(\fIcmark_node *node\fR, \fIconst char *title\fR) -.PP + \fIint\fR \fBcmark_node_get_start_line\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_get_start_column\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_get_end_line\fR(\fIcmark_node *node\fR) -.PP -.SS Tree Manipulation +.SS +Tree Manipulation \fIvoid\fR \fBcmark_node_unlink\fR(\fIcmark_node *node\fR) -.PP + \fIint\fR \fBcmark_node_insert_before\fR(\fIcmark_node *node\fR, \fIcmark_node *sibling\fR) -.PP + \fIint\fR \fBcmark_node_insert_after\fR(\fIcmark_node *node\fR, \fIcmark_node *sibling\fR) -.PP + \fIint\fR \fBcmark_node_prepend_child\fR(\fIcmark_node *node\fR, \fIcmark_node *child\fR) -.PP + \fIint\fR \fBcmark_node_append_child\fR(\fIcmark_node *node\fR, \fIcmark_node *child\fR) -.PP -.SS Parsing +.SS +Parsing \fIcmark_parser *\fR \fBcmark_parser_new\fR(\fI\fR) -.PP + \fIvoid\fR \fBcmark_parser_free\fR(\fIcmark_parser *parser\fR) -.PP + \fIcmark_node *\fR \fBcmark_parser_finish\fR(\fIcmark_parser *parser\fR) -.PP + \fIvoid\fR \fBcmark_parser_feed\fR(\fIcmark_parser *parser\fR, \fIconst char *buffer\fR, \fIsize_t len\fR) -.PP + \fIcmark_node *\fR \fBcmark_parse_document\fR(\fIconst char *buffer\fR, \fIsize_t len\fR) -.PP + \fIcmark_node *\fR \fBcmark_parse_file\fR(\fIFILE *f\fR) -.PP -.SS Rendering +.SS +Rendering \fIchar *\fR \fBcmark_render_ast\fR(\fIcmark_node *root\fR) -.PP + \fIchar *\fR \fBcmark_render_html\fR(\fIcmark_node *root\fR) -.PP + \fIchar *\fR \fBcmark_render_man\fR(\fIcmark_node *root\fR) -.PP -.SH AUTHORS +.SH +AUTHORS +.PP John MacFarlane, Vicent Marti, Kārlis Gaņģis, Nick Wellnhofer. -- cgit v1.2.3