java - Difference between comments /* */ and /** */? -


this question has answer here:

what difference between below comments in eclipse:

  1. / followed 1 *

    /* comments... */

  2. / followed 2 **

    /** comments... */

the color of both comments different. , when use 2nd type comment automatically displays @author name. why this?

the /** */ comments javadoc comments, more details here:

documentation comments (doc comments)

the special comments in java source code delimited /** ... */ delimiters. these comments processed javadoc tool generate api docs.

their specific formatting lets tools build api documentation the 1 see of standard package also, if run it, of own code. lets describe in formal way arguments, returned, etc.

not documentation presented when generate (as html or in format), it's presented in ide eclipse in multiple ways, example when mouse hovers names. it's important practice write in javadoc important information needed users of methods , class (and no more what's useful).

it's mention /* */ useful not commenting-out multiple lines. consider situation when want comment-out inside if condition:

if(a==b && c == d)

then if want remove a==b , put later on, can't use // because it'll comment-out whole line after it, do:

if(/*a==b &&*/ c == d)

by way, has nothing eclipse, that's java feature.


Comments

Post a Comment

Popular posts from this blog

image - ClassNotFoundException when add a prebuilt apk into system.img in android -

i'm in trouble add prebuilt apk system.img based taiwan mtk android phone platform, when push apk onto device,after reboot phone,the apk can installed succecessfully,but if add apk alps/out/target/product/$prj/system/app or vendor/mediatek/$prj/artifacts/out/target/product/$prj/system/app ,and produce system.img,the apk can't installed normally,the logcat say: a.lang.runtimeexception: unable instantiate activity componentinfo{com.sec.android.widgetapp.ap.hero.accuweather.widget/com.sec.android.widgetapp.ap.hero.accuweather.widget.weatherclock}: java.lang.classnotfoundexception: com.sec.android.widgetapp.ap.hero.accuweather.widget.weatherclock. can tell me what's problem ? when package manager installs apps part of system partition different installing apps on data partition. looks app using libraries somewhere else. when install on data lib directory created in apps data directory , symlinked /data/app-lib/. when apps installed on system it's expecte...
Read more

I need to import mysql 5.1 to 5.5? -

i have mysql 5.1 database , need import localhost running 5.5. how import 5.5 or downgrade mysql? install phpmyadmin 5.1 os: http://www.wikihow.com/install-phpmyadmin-on-your-windows-pc or https://www.digitalocean.com/community/articles/how-to-install-and-secure-phpmyadmin-on-ubuntu-12-04 then login, click on database, hit export, , export in sql format (quick fine). import .sql file 5.5 server (after installing phpmyadmin) logging in clicking database , hit import. hope helps!
Read more

Java, Hibernate, MySQL - store UTC date-time -

i saw here on few related questions (like this one , of course, this one )... essentially, want store date-time utc, , let application user choose time zone wants display date-time in. since seems date-time fields affected underlying jdbc driver, wonder if acceptable way go storing utc date-time: set both mysql , application server machine utc time zone (no need separate) both mysql , jvm should pick underlying system time settings (if not instructed otherwise) use datetime table columns on mysql side use java.util.date corresponding mapping on hibernate side (i guess java.sql.timestamp used too) let application worry interpreting date-time fields - i.e. let user choose preferred time zone is ok? edit clarify - here meant refer timestamps created strictly on server (e.g.date-time of record creation). application server instantiates date objects (new date() equals current date-time on server, , time zone agnostic). if client user wants supply date searching/filte...
Read more