Comment folding (especially javadoc comment folding) is almost necessary when you build frameworks. In those package, as it is used by other people, good (and thus long enough) doc is as important as good coding.
The problem with that is that the code is more difficult to maintain, as the embedded doc looks like a noise. Comment folding helps to dramatically reduce that noise and to focus on coding when you are actually programming. Michael Kirby wrote: >It would be. But that would be covered in a brace folding option. > >Folding braces, is not the same as folding methods. > >Most folding implementations that I have seen have "modes". Unfortunately, most >of the modes tend to be exclusive (i.e. I can't stack modes as being combinations of >regular expression searches). For example, kawa had: > >- Regular Expression >- Mult-level (brace or indentation based) >- Preprocessor Directives (never used this...I'm not sure what it does). >- Lines (alas...Only allow me to hide a range of lines, and not create a list of >ranges.) >- Routines (which almost does what I want it too. It folds a method down to a single >line, hiding both javadoc & code...But when you unhide the method, it unhides the >method and the NEXT routine's javadoc...Not exactly useful). > > > >On 16 Jan 2002 at 9:01, Deblauwe, Wim wrote: > >>yeah, but wouldn't it be usefull to fold the methods and not the >>javadoc, to write the javadoc? >> >>-----Original Message----- >>From: Shane Petroff [mailto:[EMAIL PROTECTED]] >>Sent: woensdag 16 januari 2002 2:01 >>To: [EMAIL PROTECTED] >>Subject: Re: Code Folding, yeehaw!!! WasRE: [Eap-list] Ariadna feature >>list >> >> >>Michael Kirby wrote: >> >>>/** First sentence of javadoc */ >>>public void doit(int stuff) >>> >>Sounds good to me. +1 >> >>-- >>Shane >> >> >> >>_______________________________________________ >>Eap-list mailing list >>[EMAIL PROTECTED] >>http://www.intellij.com/mailman/listinfo/eap-list >> >>_______________________________________________ >>Eap-list mailing list >>[EMAIL PROTECTED] >>http://www.intellij.com/mailman/listinfo/eap-list >> > >--- >[EMAIL PROTECTED] >To obtain my PGP public key, mail "SEND PUB KEY" in the >subject to "[EMAIL PROTECTED]" > > >_______________________________________________ >Eap-list mailing list >[EMAIL PROTECTED] >http://www.intellij.com/mailman/listinfo/eap-list > _______________________________________________ Eap-list mailing list [EMAIL PROTECTED] http://www.intellij.com/mailman/listinfo/eap-list
