Today I noticed that when we put our license on Java files, we use javadoc comments instead of plain comments, e.g. /** instead of /*.
This seems strange to me (although looking back at our older code, we were doing the same thing before our license update), so I checked a few other open-source Java projects, and I see they are all doing it the other way, with /*:
- Spring: https://github.com/spring-projects/spring-framework/blob/master/spring-context/src/main/java/org/springframework/context/ApplicationContext.java
- Tomcat: https://github.com/apache/tomcat/blob/trunk/java/org/apache/catalina/startup/Tomcat.java
- Mockito: https://github.com/mockito/mockito/blob/master/src/main/java/org/mockito/Mockito.java
I guess it’s too late for us to do anything about this, but it’s kind of annoying, because IntelliJ defaults to putting the copyright within /* comments, and I don’t see a setting to change that behavior.
Does anyone have any thoughts about this +/- how I can get IntelliJ to behave in a way that I won’t have to manually modify every file I ever create in OpenMRS?