From 7cff5fceaa8f0420e0e962a7f1caf10dac7773dd Mon Sep 17 00:00:00 2001 From: neocotic Date: Mon, 4 Feb 2013 15:07:23 +0000 Subject: [PATCH] added man page --- docs/md.1 | 102 +++++++++++++++++++++++++++++++++++++++++++++++++++ package.json | 3 +- 2 files changed, 104 insertions(+), 1 deletion(-) create mode 100644 docs/md.1 diff --git a/docs/md.1 b/docs/md.1 new file mode 100644 index 0000000..ba43781 --- /dev/null +++ b/docs/md.1 @@ -0,0 +1,102 @@ +.TH MD 1 "February 2013" "" "General Commands Manual" + +.SH NAME +.B md +\- HTML to Markdown converter + +.SH SYNOPSIS + +.B md +[ +.B \-adlp +] +[ +.B \-o +.I output_dir +] +[ +.I paths +] +.br + [ +.B \-dp +] +[ +.B \-e +.I html +] +.br + [ +.B \-v +] + +.SH DESCRIPTION + +html.md is a JavaScript library which allows HTML to be +converted into valid Markdown. It also supports file +systems to provide a complete command line utility. + +.SH OPTIONS + +.TP 15 +.B \-a/\-\-absolute +Always use absolute URLs for converted links. + +.TP +.B \-d/\-\-debug +Debug mode. Causes +.B md +to print debugging messages about its progress. + +.HP +.B \-e/\-\-eval +.I html +.br +Specifies the HTML string to be evaluated. + +.TP +.B \-l/\-\-long-ext +Generated Markdown files should have the long file +extension. When used, files will be created in the +.I output_dir +will have a .markdown file extension. + +.HP +.B \-o/\-\-output +.I output_dir +.br +Specifies the output directory to which generated +Markdown files will be created. + +.TP +.B \-p/\-\-print +Print out converted Markdown to the +.B stdout +stream. + +.TP +.B \-v/\-\-version +Display the version number and exit. + +.SH BUGS + +Inline HTML is not yet supported in the resulting +Markdown. + +.SH CAVEATS + +It is always recommended to pair option +.B \-p +with +.B \-e +otherwise +.B md +does all of the work but you won't see the outcome. + +.SH AUTHOR + +Alasdair Mercer < +.I mercer.alasdair@gmail.com +> ( +.I http://neocotic.com +) diff --git a/package.json b/package.json index 0708ddd..81656b7 100644 --- a/package.json +++ b/package.json @@ -42,8 +42,9 @@ , "scripts": { "test": "tap ./test" } + , "man": "./docs/md.1" , "bin": { "md": "./bin/md" } , "main": "./lib/md" -} \ No newline at end of file +}