or a more real life example:
This comment:
/**
The following code will print "TICK" each second on
stdout with a fair degree of accuracy:
\code
void callback(void*) {
puts("TICK");
Fl::repeat_timeout(1.0, callback);
}
int main() {
Fl::add_timeout(1.0, callback);
return Fl::run();
}
\endcode
*/
will be converted to something like this by most indenting tools:
/**
The following code will print "TICK" each second on
stdout with a fair degree of accuracy:
\code
void callback(void*) {
puts("TICK");
Fl::repeat_timeout(1.0, callback);
}
int main() {
Fl::add_timeout(1.0, callback);
return Fl::run();
}
\endcode
*/
which could be avoided if we either find an indentation tool that leaves the
comments alone, or if we chhange the comment format to:
/**
* The following code will print "TICK" each second on
* stdout with a fair degree of accuracy:
*
* \code
* void callback(void*) {
* puts("TICK");
* Fl::repeat_timeout(1.0, callback);
* }
*
* int main() {
* Fl::add_timeout(1.0, callback);
* return Fl::run();
* }
* \endcode
*/
Or if we find a Doxygen-aware indenting tool 8-D
_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev
