Changes between Version 1 and Version 2 of Documentation/UserGuide/DoxygenDocumentation
- Timestamp:
- 2022-05-23T13:42:49+02:00 (2 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Documentation/UserGuide/DoxygenDocumentation
v1 v2 1 Simple instructions on how to use doxygen to generate offline webpage-form documentation for ORCHIDEE. One of the nice feature is that it will show calling graph, i.e., which subroutines a given subroutine is calling and itself in turn is called by which subroutines. The call graph is also interactive. When you click on a subroutine, you will be directed to the details of this subroutine, because the offline webpages are linked. Note we are just visiting our local files using an internet browser.1 Simple instructions on how to use doxygen to generate offline webpage-form documentation for ORCHIDEE. One of the nice features is that it will show calling graph, i.e., which subroutines a given subroutine is calling and itself in turn is called by which subroutines. The call graph is also interactive. When you click on a subroutine, you will be directed to the details of this subroutine, because the offline webpages are linked. Note we are just visiting our local files using an internet browser. 2 2 3 3 The steps are: … … 5 5 (1) Download the most recent trunk of ORCHIDEE code. 6 6 7 (2) To install doxygen and the another program needed (examples on ubuntu machine): 7 (2) To install doxygen and the another program needed (examples on an Ubuntu or Debian machine): 8 {{{ 8 9 sudo apt install doxygen 9 10 sudo apt-get install graphviz 11 }}} 10 12 11 13 (3) Inside your ORCHIDEE code folder (.../modipsl/modeles/ORCHIDEE/), 12 14 13 download the attached file (with the name of "Doxyfile", which is the doxygen configuration file) and put it into this folder.15 Download the attached file (with the name of "Doxyfile", which is the doxygen configuration file) and put it into this folder. 14 16 15 17 Then run the command 'doxygen Doxyfile' 18 16 19 You will see three new folders being added after all commands are OK: 17 20 18 docbook 19 latex 20 html 21 {{{ 22 docbook/ 23 latex/ 24 html/ 25 }}} 21 26 22 27 Then go into the html folder, there is a file named 'index.html' 23 28 24 open it with firefox or any other browser, you will be able to use the 'offline' documentation and check the call graph of different subroutines.29 Open it with firefox or any other browser, you will be able to use the 'offline' documentation and check the call graph of different subroutines by looking up routines under the "Namespaces" menu. 25 30 26 You can actually also read code there. 31 You can also read code from this index.html file (under the "Files" menu). 32 33 These steps were tried with Doxygen version 1.8.13 on Debian 9.13 (stretch).