<div dir="ltr"><div><div><div><div><div><div><div>Doxygen has some limitations, it is more of a reference than a tutorial for example, but it does have a lot of useful features when done properly.<br></div>- It generates LaTeX, HTML, and RTF from the sources, and other formats are available from these (like ps and pdf).<br></div>- If you copy one source file as the basis for annother device for ecample, the documentation is already mostly done for you.<br></div>- The documentation keeps up with the source better than seperate files.  Software developers never seem to update the documentation unless it's staring them in the face as they make their changes.<br></div>- References to structures in a parameter list are automatically cross linked.<br><br></div>As documentation for how to write code, it isn't that great because it's mostly just a list of available functions, but does give you several views of what edists. including links to the source code.<br><br></div>I don't think it works as the sole source of documentation, but it does provide a lot of useful information even if you don't have any comments coded in.<br><br></div>(I just tried playing with it) As a first try at using it. just install doxygen (and graphviz for extra credit), type 'doxygen -g' ay the top level simh directory, edit the generated 'Doxygen' configuration file, and list all of the subdirectories under the 'INPUT' option (along with a '.' for the top level directory), and then run 'doxygen'. Point your browser to './html/index.html' and brouse around. With the Graphviz, you also get relationship diagrams for structures.<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Sep 14, 2015 at 1:20 PM, Christian Gauger-Cosgrove <span dir="ltr"><<a href="mailto:captainkirk359@gmail.com" target="_blank">captainkirk359@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 14 September 2015 at 14:34, Mark Pizzolato - Info Comm<br>
<span class=""><<a href="mailto:Mark@infocomm.com">Mark@infocomm.com</a>> wrote:<br>
> That said, I've got a back-burner project which will migrate most of the simulator specific documentation to a more generic format which can leverage various display/output formats.  When that finally sees the light of day, we'll look at the remaining documents.<br>
><br>
</span>I know the discussion mentioned doxygen; but I'd been feeling it might<br>
be "nice" to transfer the SIMH documentation to LaTeX. Especially<br>
since it works very nicely with a version control system. And the<br>
documentation is kept separate from the source code.<br>
<br>
Then again, doxygen is a de facto standard in documenting software<br>
with annotated source code, but would require a large scale project to<br>
add all that information into the sources.<br>
<br>
Regards,<br>
Christian<br>
<span class="HOEnZb"><font color="#888888">--<br>
Christian M. Gauger-Cosgrove<br>
STCKON08DS0<br>
Contact information available upon request.<br>
</font></span><div class="HOEnZb"><div class="h5">_______________________________________________<br>
Simh mailing list<br>
<a href="mailto:Simh@trailing-edge.com">Simh@trailing-edge.com</a><br>
<a href="http://mailman.trailing-edge.com/mailman/listinfo/simh" rel="noreferrer" target="_blank">http://mailman.trailing-edge.com/mailman/listinfo/simh</a></div></div></blockquote></div><br></div>