Merge pull request #321 from habibasorour/issue_313_comment

Issue 313 fiixed: added comments in 6.5

Author: pearcej

source/ch6_definingclasses.ptx

@@ -587,7 +587,7 @@ public String toString() {
             <listing xml:id="java-class-equal-equal">
             <program>
                 <code>
-object1 == object2
+object1 == object2 // this checks to see if the two objects are the same object in memory
                 </code>
             </program>
             </listing>
@@ -599,7 +599,7 @@ object1 == object2
             <listing xml:id="java-class-dot-equals">
             <program>
                 <code>
-object1.equals(object2)
+object1.equals(object2) // this checks to see if the two objects are equal by looking at their instance variables
                 </code>
             </program>
             </listing>
@@ -611,7 +611,7 @@ object1.equals(object2)
             <listing xml:id="java-fraction-equals">
             <program language="java">
                 <code>
-public boolean equals(Fraction other) {
+public boolean equals(Fraction other) { // check if this fraction is equal to another fraction
     Integer num1 = this.numerator * other.getDenominator();
     Integer num2 = this.denominator * other.getNumerator();
     if (num1 == num2)
@@ -651,7 +651,7 @@ public boolean equals(Fraction other) {
             <listing xml:id="java-class-extends">    
             <program>
                 <code>
-public class Fraction extends Number {
+public class Fraction extends Number { // fraction class is a child of Number
     ...
 }
                 </code>
@@ -806,7 +806,7 @@ iff y.compareTo(x) throws an exception.)
 
         <program  xml:id="java-make-comparable"  language="java">
             <code>
-public class Fraction extends Number implements Comparable&lt;Fraction&gt; {
+public class Fraction extends Number implements Comparable&lt;Fraction&gt; { // fraction class is a child of Number and implements the Comparable interface
     ...
 }
             </code>
@@ -820,7 +820,7 @@ public class Fraction extends Number implements Comparable&lt;Fraction&gt; {
 
         <program  xml:id="java-comparable2"  language="java">
             <code>
-public int compareTo(Fraction other) {
+public int compareTo(Fraction other) { // compare this fraction with another fraction
     Integer num1 = this.numerator * other.getDenominator();
     Integer num2 = this.denominator * other.getNumerator();
     return num1 - num2;