Adding/Writing Comments in Java, Comment types with Examples


How to add comments in java, comment types such as In-line Comments, Block Comments, Documentation Comments with example programs, when to write comments.

Adding/Writing Comments in Java:

In this post, We will learn about how to add comments in Java and its significance.

In Java, Comments are allowed to use in addition to the executable declarations and statements i.e. what ever we write code in the class or methods. These are very helpful for better understanding of what code does and not processed by the java compiler. Because, compiler knows it is just comment which is being used for humans understanding (Compiler ignores it). Comments can be written at any part of the class.

More on Core Java

Variable Types
Identifiers and Keywords
Import, Static Import
Constructor in Java, Types, Examples, Purpose

Adding-Writing Comments in Java

Can write comments before package statement?

Yes. It is legal to use.

// Comment before package

package blog.java.w3schools.comments;

public class CommentsDemo {
 public static void main(String[] args) {
  System.out.println("Comments demo in java");


Comments demo in java

As per the Oracle official website, It is mainly refereed as Java Doc.

Comment Types in Java:

Java supports three types of comments.

1) In-line Comments
2) Block Comments
3) Documentation Comments.

1) In-line Comments:

Any line starts with "//" then it is said to be In-line comment and till end of the line is considered as comment. Anything is written in the next line, compiler treats as next statement.

If we want to write comment only one line then In-Line comments are useful. Mainly written just before/after any statement.

In-line Comments Example:

package blog.java.w3schools.comments;

public class InlineCommentsExample {

 // The value is used for character storage.
 private final char value[] = new char[10];

 // Cache the hash code for the string
 private int hash; // Default to 0

 // use serialVersionUID from JDK 1.0.2 for interoperability
 private static final long serialVersionUID = -6849794470754667710L;

 // Main Method.
 public static void main(String[] args) {
  // Inside main method. This is Inline comment example program.
  System.out.println("In-line Comments Example");


In-line Comments Example

2) Block Comments:

Any line or set of lines in java program starts with "/*" and ends with "*/" then it is called as Block Comments.
Mainly these are useful to comment multiple lines of code or some informative text. If we want, not execute a few lines of code just put them inside block comments.

Block Comments Example Program:

public class BlockCommentsExample {

 public static void main(String[] args) {
  int count = 0;
  /* I do not want to execute these line when my program runs.
     So I use block comment here.
     count = count + 1;
     count = count + 1;
  count = count + 1;
  count = count + 1;
  System.out.println("block Comments Example: count value: "+count);


block Comments Example: count value: 2

If all lines are executed then count value should be 4 but seeing count is 2. Because two statements are inside block comments.

3) Documentation Comments:

Documentation Comments starts with "/**" and ends with "*/" as similar to the block comments. We can include annotation inside documentation comments. These type comments can be applied to the class or method level.

Documentation Comments Example code:

     * Compares this string to the specified object.  The result is {@code
     * true} if and only if the argument is not {@code null} and is a {@code
     * String} object that represents the same sequence of characters as this
     * object.
     * @param  anObject
     *         The object to compare this {@code String} against
     * @return  {@code true} if the given object represents a {@code String}
     *          equivalent to this string, {@code false} otherwise
     * @see  #compareTo(String)
     * @see  #equalsIgnoreCase(String)
    public boolean equals(Object anObject) {
        if (this == anObject) {
            return true;
        if (anObject instanceof String) {
            String anotherString = (String)anObject;
            int n = value.length;
            if (n == anotherString.value.length) {
                char v1[] = value;
                char v2[] = anotherString.value;
                int i = 0;
                while (n-- != 0) {
                    if (v1[i] != v2[i])
                        return false;
                return true;
        return false;


Comments are prominently used in all programming languages not execute a line or few lines of code and giving signal to compiler to ignore these set of statements.

Please leave your questions or comments in the comment section.

Java Doc Tool
Java Comments Examples



About Us

Author: Venkatesh - I love to learn and share the technical stuff.

accumulo,1,ActiveMQ,2,Adsense,1,API,37,ArrayList,18,Arrays,24,Bean Creation,3,Bean Scopes,1,BiConsumer,1,Blogger Tips,1,Books,1,C Programming,1,Collection,8,Collections,37,Collector,1,Command Line,1,Comparator,1,Compile Errors,1,Configurations,7,Constants,1,Control Statements,8,Conversions,6,Core Java,149,Corona India,1,Create,2,CSS,1,Date,3,Date Time API,38,Dictionary,1,Difference,2,Download,1,Eclipse,3,Efficiently,1,Error,1,Errors,1,Exceptions,8,Fast,1,Files,17,Float,1,Font,1,Form,1,Freshers,1,Function,3,Functional Interface,2,Garbage Collector,1,Generics,4,Git,9,Grant,1,Grep,1,HashMap,2,HomeBrew,2,HTML,2,HttpClient,2,Immutable,1,Installation,1,Interview Questions,6,Iterate,2,Jackson API,3,Java,32,Java 10,1,Java 11,6,Java 12,5,Java 13,2,Java 14,2,Java 8,128,Java 8 Difference,2,Java 8 Stream Conversions,4,java 8 Stream Examples,12,Java 9,1,Java Conversions,14,Java Design Patterns,1,Java Files,1,Java Program,3,Java Programs,114,Java Spark,1,java.lang,4,java.util. function,1,JavaScript,1,jQuery,1,Kotlin,11,Kotlin Conversions,6,Kotlin Programs,10,Lambda,2,lang,29,Leap Year,1,live updates,1,LocalDate,1,Logging,1,Mac OS,3,Math,1,Matrix,6,Maven,1,Method References,1,Mockito,1,MongoDB,3,New Features,1,Operations,1,Optional,6,Oracle,5,Oracle 18C,1,Partition,1,Patterns,1,Programs,1,Property,1,Python,2,Quarkus,1,Read,1,Real Time,1,Recursion,2,Remove,2,Rest API,1,Schedules,1,Serialization,1,Servlet,2,Sort,1,Sorting Techniques,8,Spring,2,Spring Boot,23,Spring Email,1,Spring MVC,1,Streams,31,String,61,String Programs,28,String Revese,1,StringBuilder,1,Swing,1,System,1,Tags,1,Threads,11,Tomcat,1,Tomcat 8,1,Troubleshoot,26,Unix,3,Updates,3,util,5,While Loop,1,
JavaProgramTo.com: Adding/Writing Comments in Java, Comment types with Examples
Adding/Writing Comments in Java, Comment types with Examples
How to add comments in java, comment types such as In-line Comments, Block Comments, Documentation Comments with example programs, when to write comments.
Loaded All Posts Not found any posts VIEW ALL Readmore Reply Cancel reply Delete By Home PAGES POSTS View All RECOMMENDED FOR YOU LABEL ARCHIVE SEARCH ALL POSTS Not found any post match with your request Back Home Sunday Monday Tuesday Wednesday Thursday Friday Saturday Sun Mon Tue Wed Thu Fri Sat January February March April May June July August September October November December Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec just now 1 minute ago $$1$$ minutes ago 1 hour ago $$1$$ hours ago Yesterday $$1$$ days ago $$1$$ weeks ago more than 5 weeks ago Followers Follow THIS PREMIUM CONTENT IS LOCKED STEP 1: Share to a social network STEP 2: Click the link on your social network Copy All Code Select All Code All codes were copied to your clipboard Can not copy the codes / texts, please press [CTRL]+[C] (or CMD+C with Mac) to copy Table of Content