AppletTalk.com Forum Index AppletTalk.com
Java discussions newsgroups
 
Archives   FAQFAQ   SearchSearch   MemberlistMemberlist   UsergroupsUsergroups   RegisterRegister 
 ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 

taming IntelliJ on JavaDoc

 
Post new topic   Reply to topic    AppletTalk.com Forum Index -> Java Software Tools
View previous topic :: View next topic  
Author Message
Roedy Green
Guest





PostPosted: Sun Mar 05, 2006 12:12 am    Post subject: taming IntelliJ on JavaDoc Reply with quote



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?
--
Canadian Mind Products, Roedy Green.
http://mindprod.com Java custom programming, consulting and coaching.
Back to top
Daniel Dyer
Guest





PostPosted: Sun Mar 05, 2006 7:12 pm    Post subject: Re: taming IntelliJ on JavaDoc Reply with quote



On Sat, 04 Mar 2006 23:51:12 -0000, Roedy Green
<my_email_is_posted_on_my_website (AT) munged (DOT) invalid> wrote:

Quote:
IntelliJ trashes my JavaDoc by reflowing comments that contains HTML
tags.

....

Quote:
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.

--
Daniel Dyer
http://www.dandyer.co.uk
Back to top
Roedy Green
Guest





PostPosted: Sun Mar 05, 2006 11:12 pm    Post subject: Re: taming IntelliJ on JavaDoc Reply with quote



On Sun, 05 Mar 2006 18:49:50 -0000, "Daniel Dyer"
<dan (AT) dannospamformepleasedyer (DOT) co.uk> wrote, quoted or indirectly
quoted someone who said :

Quote:
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.
--
Canadian Mind Products, Roedy Green.
http://mindprod.com Java custom programming, consulting and coaching.
Back to top
Jean-Marie Gaillourdet
Guest





PostPosted: Thu Mar 09, 2006 10:12 am    Post subject: Re: taming IntelliJ on JavaDoc Reply with quote

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Roedy Green schrieb:
Quote:
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
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iD8DBQFED/D3NIUNP/I5YOgRAkPUAJ9b7NG7jNTKXL5jqXXnRvpysfAmpACePuYc
5vuXb0rclSTUiTPBDgXGt/k=
=TzKd
-----END PGP SIGNATURE-----
Back to top
Roedy Green
Guest





PostPosted: Thu Mar 09, 2006 8:12 pm    Post subject: Re: taming IntelliJ on JavaDoc Reply with quote

On Thu, 09 Mar 2006 10:10:15 +0100, Jean-Marie Gaillourdet
<jmg (AT) informatik (DOT) uni-kl.de> wrote, quoted or indirectly quoted someone
who said :

Quote:
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.

--
Canadian Mind Products, Roedy Green.
http://mindprod.com Java custom programming, consulting and coaching.
Back to top
Jean-Marie Gaillourdet
Guest





PostPosted: Fri Mar 10, 2006 11:12 am    Post subject: Re: taming IntelliJ on JavaDoc Reply with quote

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Roedy Green schrieb:
Quote:
Strg-Q on a method


I take it Strg-Q is French for Ctrl-Q.
ups. Btw it's German Smile

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iD8DBQFEEVY3NIUNP/I5YOgRAhm8AJsEOyMYHSVkf6jVCV1AFvAYnMKNnQCeNI8q
qcW9MS+m5xtl8Fssrideat0=
=mLcw
-----END PGP SIGNATURE-----
Back to top
Display posts from previous:   
Post new topic   Reply to topic    AppletTalk.com Forum Index -> Java Software Tools All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum


Powered by phpBB © 2001, 2006 phpBB Group
SEO toolkit © 2004-2006 webmedic.