improve ch8 with clarifications

Author: pearcej

source/ch8_filehandling.ptx

@@ -1,13 +1,13 @@
 <?xml version="1.0"?>
 
 <!-- Generated by Docutils 0.19 -->
-<chapter xml:id="filemmanipulation">
+<chapter xml:id="file-handling">
     <title>File Handling</title>
 
-    <section xml:id="file-class-import">
+    <section xml:id="class-imports">
         <title>Class Imports</title>
         <p>
-            File handling is an integral part of programming. Most programming languages have the ability to read from, write to, create, delete, move, and copy files. In Python, most built-in libraries are available without needing  to explicitly import additional packages, but some libraries like <c>math</c> do need to be imported. Consider the following.
+            File handling is an integral part of programming. Most programming languages have the ability to create, read from, write to, and delete, files. In Python, most built-in libraries are available without needing  to explicitly import additional packages, but some libraries like <c>math</c> do need to be imported. Consider the following.
         </p>
         <program xml:id = "file-class-import-Python-example" interactive="activecode" language="python">
             <code>
@@ -17,7 +17,7 @@
         </program>
 
         <p>
-            The same program in Java would look like this:
+            Delete the first line that says <c>import math</c> and see what happens. The <c>import math</c> is needed. The same program in Java would look like this:
         </p>
         <program xml:id = "file-class-import-Java-example" interactive="activecode" language="java">
             <code>
@@ -31,11 +31,11 @@
             </code> 
         </program>
         <p>
-            Note the use of <c>import java.lang.Math;</c> in the above to import the Math class. Unlike Python, Java requires explicit imports for most libraries, including the <c>Math</c> class and many different classes for file handling.
+            Note the use of <c>import java.lang.Math;</c> in the above to import the <c>Math</c> class. Unlike Python, Java requires explicit <c>import</c> for most libraries, including the <c>Math</c> class and many  classes related to file handling.
         </p>
 
         <p>
-            Much like the Math class, in order for your program to work with files you need to import classes from libraries. Java includes a class called <c>File</c> in the <c>io</c> library. This class allows you to create File objects, and use its public methods. the following code imports the <c>File</c> class and creates a <c>File</c> object called myFile. for now focus on how the class is imported and used in the program; We will cover the <c>IOException</c> class and <c>createNewFile</c> method later.
+            Much like the <c>Math</c> class, in order for your program to work with files you need use <c>import</c>. Java includes a class called <c>File</c> in the <c>io</c> library. This class allows you to create <c>File</c> objects, and use its public methods. the following code imports the <c>File</c> class and creates a <c>File</c> object called myFile. for now focus on how the class is imported and used in the program; We will cover the <c>IOException</c> class and <c>createNewFile</c> method later.
         </p>
         <program xml:id = "file-class-import-io-example" interactive="activecode" language="java">
             <code>
@@ -82,18 +82,18 @@
 
     </section>
 
-    <section xml:id="create-file">
+    <section xml:id="creating-files">
         <title>Creating Files</title>
 
         <p>
             We will now create a <c>File</c> object. It is important to create a meaningful name for the <c>File</c> object. We will call ours <c>myFile</c>.
         </p>
-        <datafile label="my-file-8-2-1" filename="myfile.txt" xml:id= "my-file-8-2-1" editable="yes">
+        <datafile label="myfile-created" filename="myfile.txt" xml:id= "myfile-created" editable="yes">
                 <pre>
                     empty file
                 </pre>
             </datafile>
-        <program xml:id="create-file-exp-1" interactive="activecode" language="java" add-files="my-file-8-2-1">
+        <program xml:id="create-file-java" interactive="activecode" language="java" add-files="myfile-created">
             <code>
             import java.io.File;
             public class Main {
@@ -119,7 +119,7 @@
             First, lets look at the equivalent Python code:
         </p>
 
-        <program xml:id="creat-file-exp-2" interactive="activecode" language="python">
+        <program xml:id="create-file-python" interactive="activecode" language="python">
             <code>
             filename = "newfile.txt"
             print("Attempting to write to '" + filename + "' using 'w' mode...")
@@ -169,16 +169,16 @@
         </note>
     </section>    
 
-    <section xml:id="file-read">
+    <section xml:id="reading-files">
         <title>Reading Files</title>
 
         <p>
-            Let’s take a look at how we can use Python to understand how read file contents in Java.In order to read files generally you iterate through each line in the file and read its content. In Java you read files in a very similar way, however in java we will use a <c>Scanner</c> object in order to iterate through lines.
+            Let’s take a look at how we can use Python to understand how read file contents in Java. In order to read files generally you iterate through each line in the file and read the line's content. In Java, you read files in a very similar way, however in Java we will use the <c>Scanner</c> class in order to iterate through the lines.
         </p>
         <p>
-            The next lines consists of a Python code example that reads each line of the file and prints it to the console.
+            Consider the following Python code example that reads each line of the file and prints it to the console.
         </p>
-        <datafile label="my-file-8-3" filename="myfile.txt" xml:id= "my-file-8-3" editable="no">
+        <datafile label="myfile-read" filename="myfile.txt" xml:id= "myfile-read" editable="no">
                 <pre>
                     1
                     2
@@ -191,7 +191,7 @@
                 </pre>
             </datafile>
 
-        <program xml:id="file-read-exp1" interactive="activecode" language="python" add-files="my-file-8-3">
+        <program xml:id="file-read-py" interactive="activecode" language="python" add-files="myfile-read">
             <code>
                 filename = "myfile.txt"
                 try:
@@ -210,7 +210,7 @@
             The following Java code functions very similarly to the previous Python. The main difference here is that unlike Python, In Java we use the <c>Scanner</c> object to iterate through and read lines in the file. You will notice that the structure of the Java code is still similar to the Python; Both use a try and catch statement to read the file and catch any errors.
         </p>
 
-        <program xml:id="file-read-exp2" interactive="activecode"  language="java" add-files= "my-file-8-3">
+        <program xml:id="file-read-java" interactive="activecode"  language="java" add-files= "myfile-read">
             <code>
             import java.io.File;
             import java.io.FileNotFoundException;
@@ -231,11 +231,11 @@
             </code> 
         </program>
         <p>
-            You may have noticed that there are some new methods you haven't seen yet. The <c>hasNextLine()</c> method checks if there is a next line in the file, and returns false if there isn't. This method allows us to iterate over every line till there is no next line. The <c>nextLine()</c> method of the Scanner object returns the next line in the file as a string.
+            You may have noticed that there are some new methods you haven't seen yet. The <c>hasNextLine()</c> method checks if there is a next line in the file, and returns <c>false</c> if there isn't. This method allows us to iterate over every line till there is no next line. The <c>nextLine()</c> method of the Scanner object returns the next line in the file as a string.
         </p>
     </section>
 
-    <section xml:id="file-write">
+    <section xml:id="writing-to-files">
         <title>Writing to Files</title>
 
         <p>