: 4582 | 108668 | 12353

Allow Java(Doc) style comments in LotusScript editor 
Use this IdeaSpace to post ideas about Domino Designer.

: 26
: 26
: 0
: Domino Designer
: LotusScript.doc, lsdoc, comments, JavaDoc
: Harkpabst Meliantrop3248 12 Feb 2008
: / Email
LotusScript.doc is a great achievement and has been of enormous help for me in the past.
The only one thing that bugs me, is the need to add the additional LotusScript comments. This is annoying, even if you use the cool toolbar icons provided with the product. While I don't necessarily propose, that IBM should include LoutsScript.doc in Designer (it works OK as a 3rd party tool), I would like to see the LS editor to accept JavaDoc style comments directly.
This would make adding comments a lot easier and might also make it easier to parse the comments. Since /** and */ don't have any special meaning in LotusScript yet, I don't see any serious problems with backwards compatibility. 
Of course, there is no reason to restrict this to JavaDoc style comments. It would be nice, if the general Java comment syntax could be supported.

1) Axel Janssen5023 (13 Feb 2008)
I don't care much if comments are started with ' %rem, //, /** or whatever sequence of characters. We use LS.doc here and from my opinion the good thing about it, is that people use a suprising consistent style to comment their code. I don't even know how to create the html-files with LotusScript.doc. The consistency it brings to the style to comment is far more important.
Therefor as a community we should adopt LotusScript.doc style commenting as a de facto standard possibly with some IBM backing. And tell people that comments should be a) short b) short c) short d) concise and e) allways updated.
2) Harkpabst Meliantrop3248 (13 Feb 2008)
I don't care about the actual comment character as well. But being forced to nest different comment styles is cumbersome, I don't see, why this burden shouldn't be lowered.
And I have seen those people complaining on Notes.net, that they might start to use LotusScript.doc, but took the clunky syntax as an excuse not to. Don't forget: Except for their latest favorite toy, programmers are lazy.
3) Axel Janssen5023 (13 Feb 2008)
This has cleared my doubts. I will change voting to agree. The syntax is indeed too clunky.


Welcome to IdeaJam™

You can run IdeaJam™ in your company. It's easy to install, setup and customize. Your employees, partners and customers will immediately see results.

Use IdeaJam to:

  • Collect ideas from employees
  • Solicit feedback and suggestions from employees and customers
  • Run innovation contests and competitions
  • Validate concepts
  • Use the power of "crowd-sourcing" to rank ideas and allow the best ideas to rise to the top

IdeaJam™ works with:

  • IBM Connections
  • IBM Lotus Quickr
  • Blogs and Wikis
  • Websphere Portal
  • Microsoft Sharepoint
  • and other applications.

IdeaJam has an extensive set of widgets and API's that allow you to extend and integrate IdeaJam™ with other applications.

Learn more about IdeaJam >>

IdeaJam developed by

Elguji Software Logo