Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Javadoc with Equations?

Tags:

math

javadoc

I'm only familiar with the no-frills javadoc generator, however I'd like to include some mathematical equations in my javadoc (rather than constantly referencing another document).

Is there a convenient option to do something like include/properly render LaTeX (most preferred - then I could just cut-n-paste) or MathML tags?

like image 976
Carl Avatar asked Jul 01 '10 17:07

Carl


People also ask

What is Javadoc?

The JDK tool that generates API documentation from documentation comments. The Javadoc tool can generate output originating from four different types of "source" files: Source code files for Java classes (.java) - these contain class, interface, field, constructor and method comments.

How do I write basic JavaDocs and generate them?

This quick introduction tutorial covered how to write basic Javadocs and generate them with the Javadoc command line. An easier way to generate the documentation would to use any built-in IDE options or include the Maven plugin into our pom.xml file and run the appropriate commands. The code samples, as always, can be found over on GitHub.

What are the different types of Javadoc output?

The Javadoc tool can generate output originating from four different types of "source" files: Source code files for Java classes (.java) - these contain class, interface, field, constructor and method comments. Package comment files - these contain package comments Overview comment files - these contain comments about the set of packages

How do you write a method summary in Javadoc?

The first line contains the begin-comment delimiter ( /** ). Starting with Javadoc 1.4, the leading asterisks are optional. Write the first sentence as a short summary of the method, as Javadoc automatically places it in the method summary table (and index).


2 Answers

Check out Doxygen.

It's blazing fast, free, and supports embedded LaTeX.

like image 80
nsanders Avatar answered Sep 28 '22 04:09

nsanders


Maybe something like MathJax or jsMath could be your solution. They're both JavaScript libraries, so you'll have to find a way to add them into your javadocs pages.

like image 37
duffymo Avatar answered Sep 28 '22 04:09

duffymo