c - Doxygen document possible parameter values -


currently c-code function declaration documented follows

/** fubar function  *@param[in]    val1    first input variable  *@param[in]    val2    second input variable  */ void foo (int val1, int val2);

but parameters can except numbers within range, e.g., 0-500

is possible document other part of parameter description? maybe shows separately in produced documentation?

e.g. in latex-produced pdf table produced cell parameter type (int) direction (in) , name (var1/var2). there way of having table cell 0-500?

your best bet may table in detail section. doxygen supports html commands inside documentation, , table generated in pdf looks decent.

/**  * @brief fubar function  * @param[in]    val1    first input variable  * @param[in]    val2    second input variable  *  * <table>  * <tr><td>type</td><td>direction</td><td>name</td><td>value range</td></tr>  * <tr><td>int</td><td>in</td><td>val1</td><td>0-500</td></tr>  * <tr><td>int</td><td>in</td><td>val2</td><td>1-1000</td></tr>  * </table>  */  void foo(int val1, int val2) {}

the issue looks redundant me. perhaps limiting table parameter name , expected value better.

see doxygen manual: html commands set of html supported doxygen.


Comments

Post a Comment

Popular posts from this blog

linux - Does gcc have any options to add version info in ELF binary file? -

i mean whether gcc can insert source code version infor elf binary section or similar. not want change source file, add info gcc option in makefile. you can emit version info text file, turn text file object file statically link executable. the first step simple have write code: script or write version info in format plain text file. write makefile rule produce version.o version.txt, using objcopy . you'll have object file 2 useful symbols defined in it: beginning , end of textual version info. add generated object executable, , you'll able access version 2 ways: running strings on binary, or writing code in application print version string (you'll need declare start , end symbols variables in header file).
Read more

javascript - Clean way to programmatically use CSS transitions from JS? -

as title implies, there proper way set initial css properties (or class) , tell browser transition these value? for example ( fiddle ): var el = document.queryselector('div'), st = el.style; st.opacity = 0; st.transition = 'opacity 2s'; st.opacity = 1; this not animate opacity of element in chrome 29/firefox 23. because ( source ): [...] you’ll find if apply both sets of properties, 1 after other, browser tries optimize property changes, ignoring initial properties , preventing transition. behind scenes, browsers batch property changes before painting which, while speeding rendering, can have adverse affects. the solution force redraw between applying 2 sets of properties. simple method of doing accessing dom element’s offsetheight property [...] in fact, hack work in current chrome/firefox versions. updated code ( fiddle - click run after opening fiddle run animation again): var el = document.queryselector('div'...
Read more

android - send complex objects as post php java -

is possible send contact numbers via post php class inside eclipse ? or post limited primitive types , have find work arounds send them string ? i propose: send them json in post request, befor start, have @ gson project , keep in mind set content application -> json. luck
Read more