Also provide any information other programmers may find useful for using the tag allows you to insert code snippets which are then collected on the examples page. This block should explain the purpose of the class, the design considerations, and relation to other classes. You can specify the nature of the param as input output or both in the following tag informs doxygen that the comment block should be associated with the class. These are placed with the definition of the tag can be used to document the purpose and meaning of params for functions. By convention in Rosetta3 all functions must have details tags.
what must be true for the function to work), how the function carries out it function, and what will be true when the function returns. This message should give a user an idea of when it is valid to call this function( i.e. These included in the header file along with the declaration of the tag supplies a more detailed description. By convention in Rosetta3 all functions must have brief tags. This message should tell what happens in the function. Common Doxygen Tags Common Source Document tag supplies a brief description of a function for doxygen pages. To end the comment block type asterik and then forward slash.īy taking a few minutes as you are writing your code to write comment blocks you can tell future developers what you intended and make their life more productive and easier. To start a new paragraph add an empty line These next few lines will form a comment block ///This line will be included in the Doxygen comments for this function/class/fileĬommenting multiple lines is just as easy.
For line comment just insert a triple forward slash.
Template page for Subdirectories of Libraries.Template Doxygen Page for New Category of Source Files.Each of the below template pages are found in doc/template_doxygen_pages. On the simplest level you can copy them to an appropriate location and fill in the fields with the appropriate information. These pages are intended as starting points. Writing Descriptive Comments in DoxygenĪ few general template doxygen pages have been created to help you document higher level concepts in Rosetta.I expect to see functions like UA_Server_newWithConfig() or UA_Server_delete().ĭOCSET_FEEDNAME = "Doxygen generated docs"ĭOCSET_PUBLISHER_ID = org.doxygen. Now this is a C project (not C++), and I've set OPTIMIZE_OUTPUT_FOR_C=YES. The section "Member Function Documentation" only lists the two functions UA_Server::LIST_HEAD and UA_Server::TAILQ_HEAD. Only the struct members are listed there. To see the function including its call signature I either click on server.h next to it or via Files -> File List -> server.h.įunctions starting with UA_Server_ are also not listed on the page for the struct UA_Server (also typedef'd to UA_Server). Also the function itself is not a link, only the files next to it are links. For example UA_StatusCode UA_EXPORT UA_Server_run (UA_Server *server, const volatile UA_Boolean *running) is on globals_func_u.html (albeit without call signatures). The global function index (globals_func.html) only lists a handful of functions starting with "_" under the section title "_", but none of the functions starting with a letter are listed. I'm trying to generate documentation for the Open62541 project.
0 kommentar(er)
