Why does the default IntelliJ default class javadoc comment use non-standard syntax?

intellij-idea javadoc
James A. N. Stauffer picture James A. N. Stauffer · Sep 15, 2008 · Viewed 24.1k times · Source

Why does the default IntelliJ default class javadoc comment use non-standard syntax? Instead of creating a line with "User: jstauffer" it could create a line with "@author jstauffer". The other lines that it creates (Date and Time) probably don't have javadoc syntax to use but why not use the javadoc syntax when available?

For reference here is an example:

/**
 * Created by IntelliJ IDEA.
 * User: jstauffer
 * Date: Nov 13, 2007
 * Time: 11:15:10 AM
 * To change this template use File | Settings | File Templates.
 */

Answer

Rob Dickerson picture Rob Dickerson · Sep 15, 2008

I'm not sure why Idea doesn't use the @author tag by default.

But you can change this behavior by going to File -> Settings -> File Templates and editing the File Header entry in the Includes tab.

As of IDEA 14 it's: File -> Settings -> Editor -> File and Code Templates -> Includes -> File Header

Related questions

How to see JavaDoc in IntelliJ IDEA?

I just switched from Eclipse to IntelliJ. IntelliJ lacks one feature from Eclipse - when you put your mouse over a method, Eclipse shows javadoc info. I think the way to show it is to use a shortcut - command+…

Read More
What is the IntelliJ shortcut key to create a javadoc comment?

In Eclipse, I can press Alt+Shift+J and get a javadoc comment automatically generated with fields, returns, or whatever would be applicable for that specific javadoc comment. I'm assuming that IntelliJ IDEA has this feature. Can anyone tell me …

Read More
Autocompletion of @author in Intellij

I'm migrating from Eclipse to Intellij Idea. One thing I couldn't figure out yet is autocompletion of the @author JavaDoc tag. When typing @a in Eclipse, there are two proposals: @author - author name @author How do I achieve the …

Read More