diff options
author | Antoine Beaupré <anarcat@debian.org> | 2016-04-09 10:40:46 -0400 |
---|---|---|
committer | Antoine Beaupré <anarcat@debian.org> | 2016-04-09 10:40:53 -0400 |
commit | 805b4e8405dd990d0c238bb018a5b19c56d760f7 (patch) | |
tree | a3c187ef16c5aa3006a7fcd326517513fd2eea99 /doc/todo | |
parent | ae5c265c372198930dff34128c0a00b517876dca (diff) |
attack the manpage problem
Diffstat (limited to 'doc/todo')
-rw-r--r-- | doc/todo/cleaner_hack_for_man_pages.mdwn | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/todo/cleaner_hack_for_man_pages.mdwn b/doc/todo/cleaner_hack_for_man_pages.mdwn new file mode 100644 index 000000000..5adce386d --- /dev/null +++ b/doc/todo/cleaner_hack_for_man_pages.mdwn @@ -0,0 +1,16 @@ +In recent history, we have realized that the small Perl script that +generates the man pages from Markdown is fairly limited. + +Two approaches have been considered: + +* go-md2man +* pandoc + +Here is how pandoc does it: + + $ pandoc -f markdown -t man doc/git-annex-shell.mdwn | pastebinit + http://paste.debian.net/424341/ + + +Both initially fail at setting a proper `.TH` line on top, but +otherwise seem to work more or less correctly. --[[anarcat]] |