jessevdk / cldoc

clang based documentation generator for C and C++
GNU General Public License v2.0
552 stars 58 forks source link

Markdown output #127

Open rvkennedy opened 7 years ago

rvkennedy commented 7 years ago

This branch contains modifications to cldoc I have made in order to output in markdown for input into Github Pages or any Jekyll-based site. I'm not sure if it's of interest for the main branch of cldoc, the intention was to allow me to switch away from Doxygen and generate Jekyll-friendly output. The generated .md files go in a ref/ folder in the target site, while merged .md files go in the root to serve as main documentation pages.

jessevdk commented 6 years ago

There is a lot of unrelated stuff in here. I like the idea of a markdown output though. Do you think you could clean this up to a state where we can discuss merging it?

rvkennedy commented 6 years ago

I'll see if I can distill it to its essence. There's a lot in the original that I don't fully understand, so many of the changes are no doubt sub-optimal.