It seems that there should be some, at least minimal, ability to wrap long lines in block comments to the page width.
I believe that the AutoFormat plugin is supposed to do this, however it is broken with the EAP builds and this seems like something that is really fundamental and perhaps should be part of the core.
thanks,
Pat Niemeyer
Author of Learning Java, O'Reilly & Associates and the BeanShell Java Scripting Language
Description
It seems that there should be some, at least minimal, ability to wrap long lines in block comments to the page width.
I believe that the AutoFormat plugin is supposed to do this, however it is broken with the EAP builds and this seems like something that is really fundamental and perhaps should be part of the core.
thanks,
Pat Niemeyer
Author of Learning Java, O'Reilly & Associates and the BeanShell Java Scripting Language
I really want this added. Formatting a block comment by hand is really painful, and javadoc comments are formatted. They aren't the same, but they're similar enough that it feels frustrating. I've been known to change a block comment into a javadoc comment, reformat, then undo that. Of course to do that I have to have an identifier declared at the same indentation level as the block comment because javadoc comments do not reformat unless they are actually above an identifier. So I only do this rarely.
Obviously these are not identical to javadoc comment text, mostly noting the absence of HTML directives. But otherwise the same formatting would apply – just take blank lines to mean blank lines, not new "<p>" directives. Just preserve my comment leader and that's fine.
I would think that if this is done, also formatting blocks (or selected sets of) standalone block comments would be easy to include. It's just a different comment leader at some level. Lots of folks use successive lines of "//" comments instead of "/.../" comments.
Ken Arnold - 01 Mar 06 19:36 I really want this added. Formatting a block comment by hand is really painful, and javadoc comments are formatted. They aren't the same, but they're similar enough that it feels frustrating. I've been known to change a block comment into a javadoc comment, reformat, then undo that. Of course to do that I have to have an identifier declared at the same indentation level as the block comment because javadoc comments do not reformat unless they are actually above an identifier. So I only do this rarely.
Obviously these are not identical to javadoc comment text, mostly noting the absence of HTML directives. But otherwise the same formatting would apply – just take blank lines to mean blank lines, not new "<p>" directives. Just preserve my comment leader and that's fine.
I would think that if this is done, also formatting blocks (or selected sets of) standalone block comments would be easy to include. It's just a different comment leader at some level. Lots of folks use successive lines of "//" comments instead of "/.../" comments.
New Feature
Open
Normal
Basic line wrapping or formatting in block comments...
Obviously these are not identical to javadoc comment text, mostly noting the absence of HTML directives. But otherwise the same formatting would apply – just take blank lines to mean blank lines, not new "<p>" directives. Just preserve my comment leader and that's fine.
I would think that if this is done, also formatting blocks (or selected sets of) standalone block comments would be easy to include. It's just a different comment leader at some level. Lots of folks use successive lines of "//" comments instead of "/.../" comments.