c++ - Doxygen command paragraph (hanging) indentation limitations? -

-

are there limits how indentation can used on multi-line (paragraph) commands?

consider typical use-case of @details in context of function:

/**  * @brief foo.  * @details lorem ipsum dolor sit amet, mentitum rationibus nec an.  *          usu magna eirmod et, aperiri discere volumus pri ex.  *  *          te pro alii vidit, cu nonumes mediocritatem duo.  *          paulo detracto tincidunt id vim, ad has oblique percipit.  *  * @tparam t argument type.  * @param param1 first parameter.  * @param param2 second parameter.  * @return return value.  */  template< typename t >  inline  t foo( t const& param1, t const& param2 );

the long @details paragraphs have wrapped, leads question of there restrictions on indentation?

i know doxygen uses markdown, has specific indentation restrictions / uses, such "4 space indentation" codeblocks. indentation above confuse or conflict in cases wanted insert code?

more generally, there other indentation uses , possible conflicts i'm unaware of?

@thomas-matthews, question technical limitations, not aesthetic style.


Comments

Post a Comment

Popular posts from this blog

javascript - how to protect a flash video from refresh？ -

-
<!doctype html> <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <title>flash video refresh</title> </head> <body> <div id="playerzone"><embed height="496" width="580" flashvars="flvid=19742822&amp;createtime=2012-4-19 13:46:33" wmode="opaque" allowscriptaccess="always" allowfullscreen="true" quality="high" bgcolor="#000000" name="player" id="player" src="swf/mine.swf" type="application/x-shockwave-flash"></div> <a onclick="return test();" id="test">click me popup div,and hide scrollbar</a> </body> the code upon： for example,when click a#test button,popup div,it's no problem,but want hide scrollbar while div popup. i used $('html').css('overflow','hidden') in...
Read more

visual studio 2010 - Connect to informix database windows form application -

-
i trying figure out how connect ibm informix database. have been doing research , have found threads 5 years ago examples not working. i have installed latest sdk ibm informix. i have included ibm.data.informix.dll references in project. i have included using ibm.data.informix; i adding button , on click testing conenction. debug error "sql0035n file "c:\users\adam\documents\visual studio 2010\projects\test\test\msg\en_us\db2nmp.xml" cannot opened." this file not exist , dont see anywhere in program files (x86)\ibm informix client sdk directory. my on click code is private void button1_click(object sender, eventargs e) { const string host = "192.168.obfuscated"; const string servicenum = "1525"; //port? const string server = "serverobfuscated"; const string database = "dbobfuscatedy"; const string user = "myusername"; const string password = ...
Read more

android - Associate same looper with different threads -

-
Image
in application, want create multiple threads working on single queue. create queue know need call looper.prepare() . i want other threads create should associated looper created first thread, how can achieve this? use 1 of java thread safe queue class java.util.concurrent package instead of looper achieve goal. it's more common practice. share queue between threads , post task queue entry 1 thread can entry thread. blockingqueue can - in 1 thread call take() , block thread until thread put() entry queue. that's all. producer consumer pattern example blockingqueue or concurrentlinkedqueue about blockingqueue
Read more