Java How to Program, Early Objects, 11th Edition

... String representation
188      * of the time in standard-time format
189      */
190    public String toString()
191    {
192         return String.format("%d:%02d:%02d %s",
193            ((getHour() == 0 || getHour() == 12) ? 12 : getHour() % 12),
194            getMinute(), getSecond(), (getHour() < 12 ? "AM" : "PM"));
195    }
196 } // end class Time

Documentation comments are placed on the line before a class declaration, an interface declaration, a constructor, a method and a field (i.e., an instance variable or a reference). The first documentation comment (lines 5–9) introduces class Time. Line 6 is a description of class Time provided by the programmer. The description can contain as many lines as necessary to provide a description of the class to any programmer who may use it. Tags @see ...