Home | Contact Us | FAQ | Search & Site Map | Link to Us
Sign In | Join | Other 45 Sites in Network
HomeAnnouncementsWhite Papers
Discussion GroupsFirst AidDatabasesJavaBeansGUIJava 3DVirtual MachineCORBASecurityToolsGeneral
Java DirectoryOpen Source ProjectsSample Book ChaptersUser GroupsWeb Resources
Related Topics
Databases.NETMore Topics ...

Java Forum / Tools / March 2006

Tip: Looking for answers? Try searching our database.

taming IntelliJ on JavaDoc

Thread view: 
Roedy Green - 04 Mar 2006 23:51 GMT
IntelliJ trashes my JavaDoc by reflowing comments that contains HTML
tags.

e.g.

Are the following quirks of the calendar considered in this code?<br>
<dl
* compact> <dt>yes</dt> <dd>1900 is not a leap year (mod 100).</dd>
* <dt>yes</dt> <dd>2000 is a leap year (mod 400).</dd> <dt>yes</dt>
<dd>The 10
* missing days in 1582 October. (Pope Gregory's correction) 1582 Oct
5 to 1582
* Oct 14 never happened.</dd> <dt>partly</dt> <dd>Britain and its
territories
* (including the USA and Canada) adopted the Gregorian correction in
1752. By
* then, 11 days had to be dropped. 1752 September 3 to 1752 September
13 never
* happened. However, you can modify constants in BigDate to use the
British
*

That used to read:

Are the following quirks of the calendar considered in this code?<br>
<dl compact>
<dt>yes</dt>
<dd>1900 is not a leap year (mod 100).</dd>
<dt>yes</dt>
<dd>2000 is a leap year (mod 400).</dd>
<dt>yes</dt>
<dd>The 10  missing days in 1582 October. (Pope Gregory's correction)
1582 Oct 5 to 1582  Oct 14 never happened.</dd>
<dt>partly</dt>
<dd>Britain and its territories (including the USA and Canada)
adopted the Gregorian correction in 1752. By  then, 11 days had to be
dropped. 1752 September 3 to 1752 September 13 never  * happened.
However, you can modify constants in BigDate to use the British...

It is even more scrambled if there are blank lines.

Is there a way to get it to stop doing that or to reformat the HTML
much like an HTML editor would?
Signature

Canadian Mind Products, Roedy Green.
http://mindprod.com Java custom programming, consulting and coaching.

Daniel Dyer - 05 Mar 2006 18:49 GMT
> IntelliJ trashes my JavaDoc by reflowing comments that contains HTML
> tags.

...

> Is there a way to get it to stop doing that or to reformat the HTML
> much like an HTML editor would?

You can turn of the "Enable Javadoc formatting" under Javadoc in the  
project or global code settings.  I haven't tried it, but does changing  
the IDE's HTML settings help (I guess not)?

Dan.

Signature

Daniel Dyer
http://www.dandyer.co.uk

Roedy Green - 05 Mar 2006 22:27 GMT
On Sun, 05 Mar 2006 18:49:50 -0000, "Daniel Dyer"
<dan@dannospamformepleasedyer.co.uk> wrote, quoted or indirectly
quoted someone who said :

>You can turn of the "Enable Javadoc formatting" under Javadoc in the  
>project or global code settings.  I haven't tried it, but does changing  
>the IDE's HTML settings help (I guess not)?

I can stop it entirely. But then there is no way to reflow stuff that
should be reflowed. There in not even a reflow paragraph you get in a
text editor.  That is what I am doing now, and formatting and
reflowing my Javadoc manually.

IntelliJ needs to:

1. learn to format Javadoc with embedded HTML.

2. display the Javadoc for a single method instantly for proofreading
or for reading the docs on some complex method.  It does not have to
exactly match the final Javadoc, just let you see the line breaks.
Signature

Canadian Mind Products, Roedy Green.
http://mindprod.com Java custom programming, consulting and coaching.

Jean-Marie Gaillourdet - 09 Mar 2006 09:10 GMT
Roedy Green schrieb:
> IntelliJ needs to:

....

> 2. display the Javadoc for a single method instantly for proofreading
> or for reading the docs on some complex method.  It does not have to
> exactly match the final Javadoc, just let you see the line breaks.
Strg-Q on a method

Regards,
 Jean-Marie
Roedy Green - 09 Mar 2006 20:01 GMT
On Thu, 09 Mar 2006 10:10:15 +0100, Jean-Marie Gaillourdet
<jmg@informatik.uni-kl.de> wrote, quoted or indirectly quoted someone
who said :

>> 2. display the Javadoc for a single method instantly for proofreading
>> or for reading the docs on some complex method.  It does not have to
>> exactly match the final Javadoc, just let you see the line breaks.
>Strg-Q on a method

I take it Strg-Q is French for Ctrl-Q.

Just like Eclipse, IntelliJ shows the up to the second changes, not
just what was generated on the last Javadoc utility run. Just what I
wanted. Thanks.

Signature

Canadian Mind Products, Roedy Green.
http://mindprod.com Java custom programming, consulting and coaching.

Jean-Marie Gaillourdet - 10 Mar 2006 10:34 GMT
Roedy Green schrieb:
>>Strg-Q on a method
>
> I take it Strg-Q is French for Ctrl-Q.
ups. Btw it's German :-)


Free Magazines

Get these publications absolutely FREE for up to 12 months. There are no hidden fees and no obligation. Simply choose a title, complete the application form and submit it. Read more ...

Oracle MagazineNetwork ComputingComputer WorldBio-IT WorldeWeekInformation WeekInfosecurity
 
Sign In
Join
My Latest Posts
My Monitored Threads
My Blog
My Photo Gallery
My Profile
My Homepage

Start New Thread
Enable EMail Alerts
Rate this Thread



©2008 Advenet LLC   Privacy Policy - Terms of Use
This website includes both content owned or controlled by Advenet as well as content owned or controlled by third parties.