fixed path resolvement in ls and added javadoc

Author: gabrielchl

FileSystemException.java

@@ -1,3 +1,6 @@
+/**
+ * Errors that occurs in the filesystem.
+ */
 public class FileSystemException extends Exception {
     private static final String[] err_msgs = {
         "Operation not permitted",
@@ -133,16 +136,32 @@ public class FileSystemException extends Exception {
     public int errno;
     public String name;
 
+    /**
+     * Creates the exception.
+     *
+     * @param   errno   Error number
+     * @param   name    Prefix of the error message
+     */
     public FileSystemException(int errno, String name) {
         super(Integer.toString(errno));
         this.errno = errno;
         this.name = name;
     }
 
+    /**
+     * Creates the exception, for no prefix errors.
+     *
+     * @param   errno   Error number
+     */
     public FileSystemException(int errno) {
         this(errno, null);
     }
 
+    /**
+     * Prints the error message.
+     *
+     * @param   prefix  Prefix to add before the error message
+     */
     public void print_err_msg(String prefix) {
         if (name != null) {
             System.err.println(prefix + ": " + name + ": " + err_msgs[errno - 1]);

Helper.java

@@ -1,8 +1,12 @@
 import java.util.*;
 
+/**
+ * A helper class.
+ */
 public class Helper {
     public static final String GREY_COL = "\u001b[38;5;245m";
     public static final String RESET_COL = "\u001b[0m";
+
     /**
      * Outputs an array of bytes as returned by read( ) in a readable
      * hexadecimal format, perhaps with printable ASCII codes by the side. Need

Inode.java

@@ -84,20 +84,6 @@ public Inode lookup(String filename) throws FileSystemException { // TODO not ju
         throw new FileSystemException(2);
     }
 
-    // TODO check if needed
-    public int datablock_pointer() {
-        return vol.bb.getInt(offset + 40) * 1024;
-    }
-
-    // TODO check if needed
-    public String filename_color() {
-        String color_string = new String();
-        if (is_directory()) {
-            color_string += Main.BOLD_FONT + Main.BLUE_COL;
-        }
-        return color_string;
-    }
-
     /**
      * Gets the owner user id.
      *
@@ -206,29 +192,51 @@ public int[] stat() {
         return stat;
     }
 
+    /**
+     * Creates and returns a DirEntryIterable.
+     */
     public Iterable<Integer> iter_direntries() {
         return new DirEntryIterable();
     }
 
+    /**
+     * Iterable for directory entries.
+     */
     public class DirEntryIterable implements Iterable<Integer> {
         public Iterator<Integer> iterator() {
             return new DirEntryIterator();
         }
     }
 
+    /**
+     * Iterator for directory entries.
+     */
     public class DirEntryIterator implements Iterator<Integer> {
         private int direntry_offset;
 
+        /**
+         * Creates the directory entry iterator with the pointer at the first valid directory entry.
+         */
         public DirEntryIterator() {
             direntry_offset = 0;
 
             valid_direntry();
         }
 
+        /**
+         * Checks if there's a next directory entry.
+         *
+         * @return  If there's a next directory entry
+         */
         public boolean hasNext() {
             return direntry_offset < file_size();
         }
 
+        /**
+         * Gets the next directory entry position.
+         *
+         * @return  Position of the next directory
+         */
         public Integer next() {
             if (!hasNext()) {
                 throw new NoSuchElementException("There are no more directory elements.");
@@ -242,6 +250,9 @@ public Integer next() {
             }
         }
 
+        /**
+         * Moves to the next valid directory entry.
+         */
         private void valid_direntry() {
             while (hasNext()) {
                 int datablock_pt = get_datablock_pt(direntry_offset / Volume.BLOCK_LEN);
@@ -252,6 +263,9 @@ private void valid_direntry() {
             }
         }
 
+        /**
+         * Gets the next directory entry.
+         */
         private void next_direntry() {
             int datablock_pt = get_datablock_pt(direntry_offset / Volume.BLOCK_LEN);
             direntry_offset += vol.bb.getShort(datablock_pt + direntry_offset % Volume.BLOCK_LEN + 4);