Build your Javadoc
This part presents the way of building your javadoc in your downloaded archive of Mascopt. You can also find an online javadoc of MascoptLib.
The Public Javadoc
Mascopt Lib
The mascopt documentation is based on the use of the javadoc tool. When writting code, you need to use the javadoc to find quickly the methods and attributes of classes. Moreover, the javadoc integrates the J2SE 1.4 javadoc; then, the documentation of your algorithms and classes are also produced and linked to the J2SE. You can find the mascopt javadoc at docs/mascoptLib/index.html. To create it, you have to build it launching the following command:
ant javadoc
Using the Makefile, this is the same:
make javadoc
Mascopt Dev
When using the Mascopt Dev package, you can build the javadoc of your own classes or the javadoc of our experimental files (not contained in Mascopt Lib). To do so, this is the same command:
ant javadoc
Then, you can find two javadoc archives:
- The javadoc of mascoptDev, situated at docs/mascoptDev/index.html
- The optional javadoc of mascoptCplex, situated at docs/mascoptCplex/index.html
Note that this documentation is linked to the tags of Mascopt Lib and Java.
The Protected and Private Javadoc
Note that when constructing the javadoc, you can only view the public attribute and member functions. You may want to view the protected functions and in some case, the private functions. Some special flags have to be given to the javadoc tools and have been included in the Makefile. To build the javadoc with protected or private stuff, use one of the following:
ant javadocProtected ant javadocPrivate
Latex
We provides a javadoc under Postscript format, made with Latex. You can find the Mascopt Lib javadoc postscript in docs/tex. To generate the latex file of Mascopt Dev, just run:
ant javadocTex