Description: Adding man pages for markdown2html example program
Author: Massimo Manghi <mxmanghi@apache.org>
Reviewed-by: Natacha Porté <natbsd@instinctive.eu>
Last-Update: 2015-05-10
---
This patch header follows DEP-3: http://dep.debian.net/deps/dep3/

--- /dev/null
+++ b/markdown2html.1
@@ -0,0 +1,60 @@
+.\"                                      Hey, EMACS: -*- nroff -*-
+.\" (C) Copyright 2009 Natasha Porté <natbsd@instinctive.eu>,
+.\"
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH MARKDOWN2HTML 1 2009
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.PP
+.SH NAME
+markdown2html \- converts a markdown document into HTML
+.SH SYNOPSIS
+.B markdown2html
+.RI [-h | -x] [-d | -m | -n]  [input-file]
+.SH DESCRIPTION
+.B markdown2html
+converts a markdown document into HTML. The program was
+meant as an example of programming with the markdown 
+parser implemented in libsoldout, nonetheless it's usable
+in real life applications as an HTML generator from 
+markdown documents.
+.SH OPTIONS
+.PP
+
+    -d, --discount  Enable some Discount extensions (image size 
+                    specficiation, class blocks and 'abbr:', 
+                    'class:', 'id:' and 'raw:' pseudo-protocols)
+.br
+    -H, --html      Output HTML-style self-closing tags (e.g. <br>)
+.br
+    -h, --help      Display this help text and exit without
+                    further processing
+.br
+    -m, --markdown  Disable all extensions and use strict markdown 
+                    syntax
+.br
+    -n, --natext    Enable support Discount extensions and 
+                    Natasha's own extensions (id header attribute,
+                    class paragraph attribute, 'ins' and 'del'
+                    elements, and plain span elements)
+.br
+    -x, --xhtml     Output XHTML-style self-closing tags (e.g. <br />)
+.PP
+.SH COPYRIGHT
+  Copyright \(co 2009 Natasha Porte' <natbsd@instinctive.eu>
+  Manual Page written by Massimo Manghi <mxmanghi@apache.org>
+.SH SEE ALSO
+.BR libsoldout(3)
+.br
