Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 119318

Summary:	[formatter] Poor format for user comments in generated code
Product:	[Eclipse Project] JDT	Reporter:	Kevin Williams <kjwillia>
Component:	Core	Assignee:	JDT-Core-Inbox <jdt-core-inbox>
Status:	CLOSED WONTFIX	QA Contact:	Mateusz Matela <mateusz.matela>
Severity:	normal
Priority:	P5	CC:	jarthana
Version:	3.1.1
Target Milestone:	---
Hardware:	PC
OS:	Windows XP
Whiteboard:	stalebug

Description Kevin Williams

2005-12-05 16:32:40 EST

I have generated code that looks like the following after being formatted with the Eclipse 3.1.1 "built-in" formatter:

  /**
   * <!-- begin-user-doc -->User comment<!-- end-user-doc -->
   *
   * @generated
   */

and I'd like it to look like this:

  /**
   * <!-- begin-user-doc -->
   * User comment
   * <!-- end-user-doc -->
   *
   * @generated
   */

The latter is a better default.  If it cannot be te default then I should be able to produce a formatter profile to do this.

Comment 1 Olivier Thomann

2007-06-21 13:13:54 EDT

What component generates such a default comment ?

Comment 2 Frederic Fusier

2008-08-18 08:07:11 EDT

Ownership has changed for the formatter, but I surely will not have enough time to fix your bug during the 3.5 development process, hence set its priority to P5.
Please provide a patch if you definitely need the bug to be fixed in this version and I'll have a look at it...
TIA

Comment 3 Eclipse Genie

2019-09-16 14:55:06 EDT

This bug hasn't had any activity in quite some time. Maybe the problem got resolved, was a duplicate of something else, or became less pressing for some reason - or maybe it's still relevant but just hasn't been looked at yet.

If you have further information on the current state of the bug, please add it. The information can be, for example, that the problem still occurs, that you still want the feature, that more information is needed, or that the bug is (for whatever reason) no longer relevant.

--
The automated Eclipse Genie.

Comment 4 Jay Arthanareeswaran

2019-09-17 05:33:30 EDT

Mateusz, I can't figure whether this is really a bug. Can you please comment on this and close if appropriate?

Comment 5 Mateusz Matela

2019-09-17 16:56:21 EDT

I think the intention is that the formatter for javadoc should not join lines that consist of html comments.
It's not a bad idea, but it's hard to decide if it should be just a behavior change (at least it would not affect previously formatted code) or a new setting.