summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorJohn MacFarlane <jgm@berkeley.edu>2014-11-29 16:53:01 -0800
committerJohn MacFarlane <jgm@berkeley.edu>2014-11-29 16:53:01 -0800
commitdc5345daad121be5ee38e673acd532e69d5f8e75 (patch)
treeb5a97ed8e11a206aa727ab46f6e8e531503812cd /man
parente466700c9744dd361b4fb17f93382449a8a6a166 (diff)
Keep cmark.1 in repository, so pandoc isn't required to build.
See #224.
Diffstat (limited to 'man')
-rw-r--r--man/CMakeLists.txt18
-rw-r--r--man/man1/cmark.134
2 files changed, 47 insertions, 5 deletions
diff --git a/man/CMakeLists.txt b/man/CMakeLists.txt
index ddffc8d..4aba777 100644
--- a/man/CMakeLists.txt
+++ b/man/CMakeLists.txt
@@ -5,12 +5,20 @@ add_custom_target(manpages ALL
DEPENDS ${MANDEST}/man1/cmark.1
)
+# This is a temporary fallback until we get a cmark-based
+# build procedure for the man pages:
add_custom_command(OUTPUT ${MANDEST}/man1/cmark.1
- DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/cmark.1.md
- COMMAND pandoc "-s" "-t" "man"
- ${CMAKE_CURRENT_SOURCE_DIR}/cmark.1.md
- -o ${MANDEST}/man1/cmark.1
- VERBATIM)
+ DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/man1/cmark.1
+ COMMAND cp ${CMAKE_CURRENT_SOURCE_DIR}/man1/cmark.1
+ ${MANDEST}/man1/cmark.1 VERBATIM
+)
+
+# add_custom_command(OUTPUT ${MANDEST}/man1/cmark.1
+# DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/cmark.1.md
+# COMMAND pandoc "-s" "-t" "man"
+# ${CMAKE_CURRENT_SOURCE_DIR}/cmark.1.md
+# "-o" ${MANDEST}/man1/cmark.1
+# VERBATIM)
INSTALL(FILES ${MANDEST}/man1/cmark.1 DESTINATION share/man/man1)
diff --git a/man/man1/cmark.1 b/man/man1/cmark.1
new file mode 100644
index 0000000..3681456
--- /dev/null
+++ b/man/man1/cmark.1
@@ -0,0 +1,34 @@
+.TH "cmark" "1" "October 22, 2014" "cmark manual" ""
+.SH NAME
+.PP
+cmark \- convert CommonMark formatted text to HTML
+.SH SYNOPSIS
+.PP
+cmark [\f[I]options\f[]] [file*]
+.SH DESCRIPTION
+.PP
+\f[C]cmark\f[] acts as a pipe, reading from stdin or from the specified
+files and writing to stdout.
+It converts Markdown formatted plain text to HTML, using the conventions
+described in the CommonMark spec.
+If multiple files are specified, the contents of the files are simply
+concatenated before parsing.
+.SH OPTIONS
+.TP
+.B \f[C]\-\-ast\f[]
+Print an abstract syntax tree instead of HTML.
+.RS
+.RE
+.TP
+.B \f[C]\-\-help\f[]
+Print usage information.
+.RS
+.RE
+.TP
+.B \f[C]\-\-version\f[]
+Print version.
+.RS
+.RE
+.SH AUTHORS
+.PP
+John MacFarlane