3

I saw in a wikipedia page (Comparison of documentation generators) that pandoc can be used as a Documentation Generator (like doxygen does).

But I didn't find in pandoc's documentation or in it's site a way to extract documentation from source code comments, as others documentation generator does.

So how can I use pandoc to do this? There is a way to extract pandoc's markup language from code comments and create a PDF or HTML document from it? Or the wikipedia's comparison list is wrong?

Seninha
  • 329
  • 1
  • 12
  • 1
    some work needed, like: http://www.ucalgary.ca/rzach/blog/2014/05/simple-way-to-document-code-with-markdown-grep-and-pandoc.html – mb21 Jul 22 '14 at 18:22

1 Answers1

2

Taking the method described in http://www.ucalgary.ca/rzach/blog/2014/05/simple-way-to-document-code-with-markdown-grep-and-pandoc.html as mb21 mentions a bash script like the one below does the job

"makedoc"

#!/bin/bash

grep -e "^%" -e "^$$" $1.tex | cut --bytes=3-| pandoc -f markdown  -o $1.pdf
z--
  • 2,186
  • 17
  • 33