From 42ea18599f66a3af00887280770aa9479c453b21 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Tue, 26 Apr 2016 21:39:51 -0700 Subject: Clarify that it's the caller's responsibility to free the buffer... returned by cmark_render_html etc. Closes #124. --- man/man3/cmark.3 | 17 +++++++++++------ src/cmark.h | 9 +++++++-- 2 files changed, 18 insertions(+), 8 deletions(-) diff --git a/man/man3/cmark.3 b/man/man3/cmark.3 index cf0874a..7808aa9 100644 --- a/man/man3/cmark.3 +++ b/man/man3/cmark.3 @@ -1,4 +1,4 @@ -.TH cmark 3 "April 09, 2016" "LOCAL" "Library Functions Manual" +.TH cmark 3 "April 26, 2016" "LOCAL" "Library Functions Manual" .SH NAME .PP @@ -599,32 +599,37 @@ Rendering \fIchar *\f[] \fBcmark_render_xml\f[](\fIcmark_node *root\f[], \fIint options\f[]) .PP -Render a \f[I]node\f[] tree as XML. +Render a \f[I]node\f[] tree as XML. It is the caller's responsibility to +free the returned buffer. .PP \fIchar *\f[] \fBcmark_render_html\f[](\fIcmark_node *root\f[], \fIint options\f[]) .PP Render a \f[I]node\f[] tree as an HTML fragment. It is up to the user to -add an appropriate header and footer. +add an appropriate header and footer. It is the caller's responsibility +to free the returned buffer. .PP \fIchar *\f[] \fBcmark_render_man\f[](\fIcmark_node *root\f[], \fIint options\f[], \fIint width\f[]) .PP -Render a \f[I]node\f[] tree as a groff man page, without the header. +Render a \f[I]node\f[] tree as a groff man page, without the header. It +is the caller's responsibility to free the returned buffer. .PP \fIchar *\f[] \fBcmark_render_commonmark\f[](\fIcmark_node *root\f[], \fIint options\f[], \fIint width\f[]) .PP -Render a \f[I]node\f[] tree as a commonmark document. +Render a \f[I]node\f[] tree as a commonmark document. It is the caller's +responsibility to free the returned buffer. .PP \fIchar *\f[] \fBcmark_render_latex\f[](\fIcmark_node *root\f[], \fIint options\f[], \fIint width\f[]) .PP -Render a \f[I]node\f[] tree as a LaTeX document. +Render a \f[I]node\f[] tree as a LaTeX document. It is the caller's +responsibility to free the returned buffer. .SS Options diff --git a/src/cmark.h b/src/cmark.h index 40aa465..2f4e603 100644 --- a/src/cmark.h +++ b/src/cmark.h @@ -465,28 +465,33 @@ cmark_node *cmark_parse_file(FILE *f, int options); * ## Rendering */ -/** Render a 'node' tree as XML. +/** Render a 'node' tree as XML. It is the caller's responsibility + * to free the returned buffer. */ CMARK_EXPORT char *cmark_render_xml(cmark_node *root, int options); /** Render a 'node' tree as an HTML fragment. It is up to the user - * to add an appropriate header and footer. + * to add an appropriate header and footer. It is the caller's + * responsibility to free the returned buffer. */ CMARK_EXPORT char *cmark_render_html(cmark_node *root, int options); /** Render a 'node' tree as a groff man page, without the header. + * It is the caller's responsibility to free the returned buffer. */ CMARK_EXPORT char *cmark_render_man(cmark_node *root, int options, int width); /** Render a 'node' tree as a commonmark document. + * It is the caller's responsibility to free the returned buffer. */ CMARK_EXPORT char *cmark_render_commonmark(cmark_node *root, int options, int width); /** Render a 'node' tree as a LaTeX document. + * It is the caller's responsibility to free the returned buffer. */ CMARK_EXPORT char *cmark_render_latex(cmark_node *root, int options, int width); -- cgit v1.2.3