title: WYSIWYG in Doxygen
body: <p>I'm working on a fairly large project written in C. The idea was to build a library of modular blocks that can be reused across several platforms. Each module is associated with a word document in .docx format (huge pain to diff-merge). In these docs, an interface section is specified, listing datatypes and publicly accessible functions. These were often inconsistent with the actual implementation in code, and wading through all this documentation was a pain.</p>
  
  <p>I've been working to switch to doxygen to simplify document management. I haven't found a good way to embed the previously written documentation into the doxygen output. I've copy-pasted them into sections and used modules to group the sources together, but the document sections look ugly in the comments (the output is pretty) and since doxygen takes a while to parse through our code (about 30 mins), validating formatting is a pain.</p>
  
  <p>Is there some way to WYSIWYG large blocks of documentation into doxygen? I feel this would improve the number of people documenting their code, and the quality of that documentation. I considered linking to html, but that splits out the documentation. I also considered putting them inline in html, but this also seems like a pain and would mean everyone needs a WYSIWYG HTML editor (or some html skillz).</p>
  
  <p>Any ideas on how to make things easier and prettier?</p>
  
  <p>Thanks loads.</p>