I go with the first route as Sean Corfield has made what I consider to be a very excellent point, which is that comments should never have effect on the executing code. Comments are for documentation only.
Judah On Mon, Nov 15, 2010 at 10:15 AM, John Allen <[email protected]> wrote: > > Hey CFers > > > This might be a silly question: how are you all formatting your cfcsript > based cfcs? Using annotations or defining the attributes in the method > itself? EG: > > > // methodOne > > *public* boolean *function* foo() > > displayname="I am Foo" > > description="I return a boolean value. I am for testing." > > hint="I return a boolean value."{ > > *return* 1; > > } > > > > > > /** > > *...@hint "I return an empty structure." > > *...@displayname "Bar" > > *...@description "I return an empty structure." > > */ > > *public* struct *function* bar() { > > *return* *structNew*(); > > } > > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~| Order the Adobe Coldfusion Anthology now! http://www.amazon.com/Adobe-Coldfusion-Anthology/dp/1430272155/?tag=houseoffusion Archive: http://www.houseoffusion.com/groups/cf-talk/message.cfm/messageid:339243 Subscription: http://www.houseoffusion.com/groups/cf-talk/subscribe.cfm Unsubscribe: http://www.houseoffusion.com/groups/cf-talk/unsubscribe.cfm
