<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>quixotic project blog &#187; javadoc</title>
	<atom:link href="http://michi.ist.inspirationslos.de/lang/en/tag/javadoc/feed/" rel="self" type="application/rss+xml" />
	<link>http://michi.ist.inspirationslos.de</link>
	<description></description>
	<lastBuildDate>Sat, 06 Feb 2010 10:11:27 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9.2</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>Adding Javadoc Links in IntelliJ Idea with Live Templates</title>
		<link>http://michi.ist.inspirationslos.de/lang/en/2010/01/26/adding-javadoc-links-in-intellij-idea-with-live-templates</link>
		<comments>http://michi.ist.inspirationslos.de/lang/en/2010/01/26/adding-javadoc-links-in-intellij-idea-with-live-templates#comments</comments>
		<pubDate>Tue, 26 Jan 2010 21:55:48 +0000</pubDate>
		<dc:creator>michi</dc:creator>
				<category><![CDATA[Development]]></category>
		<category><![CDATA[Java]]></category>
		<category><![CDATA[eclipse]]></category>
		<category><![CDATA[helper]]></category>
		<category><![CDATA[intellij idea]]></category>
		<category><![CDATA[javadoc]]></category>
		<category><![CDATA[live template]]></category>

		<guid isPermaLink="false">http://michi.ist.inspirationslos.de/?p=187</guid>
		<description><![CDATA[In Eclipse there is this wonderful little helper for adding Javadoc links while you&#8217;re typing a class name. It looks like this: 

It suggests not just to put the classes name there but also use a @link tag so one can navigate the Javadoc sources later on. The finished comment:

Unfortunately this functionality is not available [...]]]></description>
			<content:encoded><![CDATA[<p>In Eclipse there is this wonderful little helper for adding Javadoc links while you&#8217;re typing a class name. It looks like this: </p>
<p><img src="http://michi.ist.inspirationslos.de/files/2010/01/eclipse-javadoc-links-1-300x76.png" alt="auto completion for Javadoc links in Eclipse" title="auto completion for Javadoc links in Eclipse" width="300" height="76" class="alignnone size-medium wp-image-182" /></p>
<p>It suggests not just to put the classes name there but also use a @link tag so one can navigate the Javadoc sources later on. The finished comment:</p>
<p><img src="http://michi.ist.inspirationslos.de/files/2010/01/eclipse-javadoc-links-2-300x76.png" alt="auto completion for Javadoc links in Eclipse" title="auto completion for Javadoc links in Eclipse" width="300" height="76" class="alignnone size-medium wp-image-183" /></p>
<p>Unfortunately this functionality is not available in JetBrains&#8217; IntelliJ Idea. There is (of course) auto completion for classnames in Idea but it simply doesn&#8217;t put them in a @link tag. A simple trick saves the day: simply create a <a href="http://www.jetbrains.com/idea/features/code_assistance.html">live template</a> with context &#8216;Java comment&#8217; like here:</p>
<p><a href="http://michi.ist.inspirationslos.de/files/2010/01/idea-javadoc-links-1.png"><img src="http://michi.ist.inspirationslos.de/files/2010/01/idea-javadoc-links-1-300x262.png" alt="creating a live template for the javadoc link" title="link live template" width="300" height="262" class="alignnone size-medium wp-image-184" /></a></p>
<p>EDIT: The screenshot is missing the word &#8216;link&#8217;. The complete template should be: &#8216;{@link $LINK$} &#8216;.</p>
<p>Don&#8217;t forget to click on &#8216;Edit variables&#8217; and fill in &#8216;complete()&#8217; as Expression. This activates the auto completion for classnames. </p>
<p>Now everytime a @link in the Javadocs is needed we invoke the Live Templates with Alt + J and enter a classname. The @link tag will be build around that name. It&#8217;s not as simple as with Eclipse, but works pretty well.</p>
<p><img src="http://michi.ist.inspirationslos.de/files/2010/01/idea-javadoc-links-2.png" alt="live template for the javadoc @link" title="live template for the javadoc @link" width="300" height="100" class="alignnone size-full wp-image-185" /></p>
<p><img src="http://michi.ist.inspirationslos.de/files/2010/01/idea-javadoc-links-3.png" alt="live template for the javadoc @link tag" title="live template for the javadoc @link tag" width="300" height="100" class="alignnone size-full wp-image-186" /></p>
]]></content:encoded>
			<wfw:commentRss>http://michi.ist.inspirationslos.de/lang/en/2010/01/26/adding-javadoc-links-in-intellij-idea-with-live-templates/feed</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>
