background preloader

Programming

Facebook Twitter

Solved Programming Problems. Back to basic: Series on dynamic memory management - I know the answer (it's 42)

Books

Style. Book. Practical Common Lisp. Doxygen. This chapter covers two topics: How to put comments in your code such that doxygen incorporates them in the documentation it generates. This is further detailed in the next section.Ways to structure the contents of a comment block such that the output looks good, as explained in section Anatomy of a comment block. A special comment block is a C or C++ style comment block with some additional markings, so doxygen knows it is a piece of structured text that needs to end up in the generated documentation. The next section presents the various styles supported by doxygen. For Python, VHDL, Fortran, and Tcl code there are different commenting conventions, which can be found in sections Comment blocks in Python, Comment blocks in VHDL, Comment blocks in Fortran, and Comment blocks in Tcl respectively.

Comment blocks for C-like languages (C/C++/C#/Objective-C/PHP/Java) There are several ways to mark a comment block as a detailed description: As you can see doxygen is quite flexible. //! Or public: ! Main Page - Algorithmist. Principles Of Object Oriented Design.