- Trending Categories
- Data Structure
- Operating System
- C Programming
- Selected Reading
- UPSC IAS Exams Notes
- Developer's Best Practices
- Questions and Answers
- Effective Resume Writing
- HR Interview Questions
- Computer Glossary
- Who is Who
Generating MySQL Doxygen Documentation Content
The source code of MySQL contains a lot of internal documentation, which is written using Doxygen. This Doxygen content is available ata https://dev.mysql.com/doc/index-other.html. This Doxygen content can be generated locally from a MySQl source distribution. This can be done by following the below mentioned steps −
The first step is to install Doxygen 1.8.11 or a higher version of it. The distributions are available at http://www.doxygen.nl/.
Once it has been installed, the version number has to be verified. This can be done using the below command −
shell > doxygen −−version 1.8.13
Next step is to install PlantUML. When this is installed on Windows 10, it should be run as an administrator atleast once so that the registry keys can be created.
An administrator console can be opened, and the below code needs to be executed −
shell> java −jar path−to−plantuml.jar
The above command would open a GUI window, without any errors on the console.
Once this is done, the PLANTUML_JAR_PATH environment variable has to be set to the location where PlantUML was installed. Let us look at an example −
shell> export PLANTUML_JAR_PATH=path-to-plantuml.jar
The next step is to install Graphviz dot command.
Once this has been done, the dot availability needs to be verified. This can be done using the below commands −
shell> which dot /usr/bin/dot shell> dot −V dot − graphviz version 2.28.0 (20130928.0220)
The location of the top-level directory of the MySQL source distribution has to be changed. This can be done using the below command −
shell> cd your-mysql-source-directory shell> mkdir bld shell> cd bld shell> cmake ..
The cmake is executed first.
Generate Doxygen Documentation
The next step is to generate the doxygen documentation. This can be done by executing the below command −
shell> make doxygen
Once this is done, the error log has to be inspected. This is available in the doxyerror file which is present in the top−evel directory. Once the build has been executed properly, the generated output can be viewed on a browser. This can be done using the below command −
shell> firefox doxygen/html/index.html
- How to install Doxygen on Ubuntu
- Java documentation comments
- Generating a range of numbers in MySQL?
- Java API documentation generator
- Test Documentation in Software Testing
- Testing Documentation in Software Testing
- Generating a unique random 10 character string using MySQL?
- What is API Documentation in Postman?
- Generating OTP in Java
- Generating password in Java
- How to produce documentation for Python functions?
- How to Generate API Documentation in Postman?
- MySQL: Insert a row and get the content?
- Generating random numbers in Java
- Generating random numbers in C#