Featured post

c# - Usage of Server Side Controls in MVC Frame work -

-
i using asp.net 4.0 , mvc 2.0 web application. project requiremrnt have use server side control in application not possibl in noraml case. ideally want use adrotator control , datalist control. i saw few samples , references in codepleax mvc controllib howwver found less useful. can tell how utilize theese controls in asp.net application along mvc. note: please provide functionalities related adrotator , datalist controls not equivalent functionalities thanks in advace. mvc pages not use normal .net solution makes use of normal .net components impossible. a normal .net page use event driven solution call different methods service side mvc use actions , view completly different way handle things. also, mvc not use viewstate normal .net controlls require. found article discussing mixing of normal .net , mvc.
3 comments

c - Customizing Doxygen html output -

-

we have function header format have follow. looks this

/** * name: blah * * parameters: *       int foo *       bool bar * * .....

we attempting generate documents doxygen, 1 issue when change code to:

/** * name: blah * * parameters: *  \param  int foo *  \param  bool bar * * .....

when doxygen generates html comments, adds parameters title. required have line 4, creates documents 2 lines parameters, first line 4 , second doxygen auto inserts.

what i'm hoping can either have doxygen ignore line 4 or add have not insert it's own "parameters:" title. know if possible?

the simple solution remove "parameters:" text altogether; entirely redundant since doxygen mark-up makes clear parameters!

for matter "name:" label entirely redundant too, , forces place name in both comment , code. why need that? it's name right there in code. unnecessary comment maintenance headache, , doxygen use teh name in code not name in comment in generated documentation.

if must attempt mix existing format doxygen compatible format easier use c++/c99 line comments rather block comments; c compilers support them:

// name: blah // // parameters: /// \param  foo description of foo /// \param  bar description of bar

note \param <type> <name> not correct doxygen syntax; \param <name> <description>. doxygen gets type code; again specifying type in comment entirely redundant, , maintenance headache.

i suggest employ more doxygen , maintenance friendly function boiler-plate altogether. use following basic form (for worth):

//! @brief  brief description //! //! full description if necessary. //! @param p1    p1 description //! @param p2    p2 description //! @return return value description int foobar( int p1, int p2 ) ;

obviously whether use /// or //! , \ or @ matter of preference.


Comments

Post a Comment

Popular posts from this blog

ios - Very simple iPhone App crashes on UILabel settext -

-
i have simple application. have button , label in ib. have ibaction onclick calls settext on label. there's outlet label. connected in ib. crashes app first time in simulator. when launch again, sets text. crashes again next time. crashes on actual device. should simple, i'm not sure i'm doing wrong. thanks. in .h file : #import <uikit/uikit.h> @interface untitledviewcontroller : uiviewcontroller { iboutlet uilabel *label; iboutlet uibutton *button; } @property (nonatomic, retain) uilabel *label; -(ibaction) onclick1: (id) sender; @end and in .m: - (ibaction) onclick1: (id) sender { //[label settext:@"hello world!"]; label.text = @"hello world!"; //[button settitle:@"clicked" forstate:uicontrolstatenormal]; } sorry, i'm new site. how crash log , stack? thanks. edit : while answer technically correct, doesn't answer question @ :( sorry < warning - guess > if you're...
Read more

mysql - Why there can be only one TIMESTAMP column with CURRENT_TIMESTAMP in DEFAULT clause? -

-
why there can 1 timestamp column current_timestamp in default or on update clause? create table `foo` ( `productid` int(10) unsigned not null, `addeddate` timestamp not null default current_timestamp, `updateddate` timestamp not null default current_timestamp on update current_timestamp ) engine=innodb; the error results: error code : 1293 incorrect table definition; there can 1 timestamp column current_timestamp in default or on update clause this limitation, due historical, code legacy reasons, has been lifted in recent versions of mysql: changes in mysql 5.6.5 (2012-04-10, milestone 8) previously, @ 1 timestamp column per table automatically initialized or updated current date , time. restriction has been lifted. timestamp column definition can have combination of default current_timestamp , on update current_timestamp clauses. in addition, these clauses can used datetime column definitions. more information, see automati...
Read more

c# - Usage of Server Side Controls in MVC Frame work -

-
i using asp.net 4.0 , mvc 2.0 web application. project requiremrnt have use server side control in application not possibl in noraml case. ideally want use adrotator control , datalist control. i saw few samples , references in codepleax mvc controllib howwver found less useful. can tell how utilize theese controls in asp.net application along mvc. note: please provide functionalities related adrotator , datalist controls not equivalent functionalities thanks in advace. mvc pages not use normal .net solution makes use of normal .net components impossible. a normal .net page use event driven solution call different methods service side mvc use actions , view completly different way handle things. also, mvc not use viewstate normal .net controlls require. found article discussing mixing of normal .net , mvc.
Read more