Fix javadoc to compile with java 8 doclint

src/main/java/org/kamranzafar/jtar/Octal.java

@@ -62,9 +62,10 @@ public class Octal {
     }
 
     /**
-     * Parse an octal integer from a header buffer.
+     * Write an octal integer to a header buffer.
      * 
      * @param value
+     *            The value to write.
      * @param buf
      *            The header buffer from which to parse.
      * @param offset
@@ -100,9 +101,10 @@ public class Octal {
     }
 
     /**
-     * Parse the checksum octal integer from a header buffer.
-     * 
+     * Write the checksum octal integer to a header buffer.
+     *
      * @param value
+     *            The value to write.
      * @param buf
      *            The header buffer from which to parse.
      * @param offset
@@ -119,9 +121,10 @@ public class Octal {
     }
 
     /**
-     * Parse an octal long integer from a header buffer.
+     * Write an octal long integer to a header buffer.
      * 
      * @param value
+     *            The value to write.
      * @param buf
      *            The header buffer from which to parse.
      * @param offset

src/main/java/org/kamranzafar/jtar/TarEntry.java

@@ -49,9 +49,6 @@ public class TarEntry {
 	 * 
 	 * This method is useful to add new entries programmatically (e.g. for
 	 * adding files or directories that do not exist in the file system).
-	 * 
-	 * @param header
-	 * 
 	 */
 	public TarEntry(TarHeader header) {
 		this.file = null;
@@ -146,8 +143,6 @@ public class TarEntry {
 
 	/**
 	 * Checks if the org.kamrazafar.jtar entry is a directory
-	 * 
-	 * @return
 	 */
 	public boolean isDirectory() {
 		if (this.file != null)
@@ -166,8 +161,6 @@ public class TarEntry {
 
 	/**
 	 * Extract header from File
-	 * 
-	 * @param entryName
 	 */
 	public void extractTarHeader(String entryName) {
 		header = TarHeader.createHeader(entryName, file.length(), file.lastModified() / 1000, file.isDirectory());
@@ -175,9 +168,6 @@ public class TarEntry {
 
 	/**
 	 * Calculate checksum
-	 * 
-	 * @param buf
-	 * @return
 	 */
 	public long computeCheckSum(byte[] buf) {
 		long sum = 0;
@@ -191,8 +181,6 @@ public class TarEntry {
 
 	/**
 	 * Writes the header to the byte buffer
-	 * 
-	 * @param outbuf
 	 */
 	public void writeEntryHeader(byte[] outbuf) {
 		int offset = 0;
@@ -231,9 +219,6 @@ public class TarEntry {
 
 	/**
 	 * Parses the tar header to the byte buffer
-	 * 
-	 * @param header
-	 * @param bh
 	 */
 	public void parseTarHeader(byte[] bh) {
 		int offset = 0;

src/main/java/org/kamranzafar/jtar/TarHeader.java

@@ -143,7 +143,6 @@ public class TarHeader {
 	/**
 	 * Parse an entry name from a header buffer.
 	 * 
-	 * @param name
 	 * @param header
 	 *            The header buffer from which to parse.
 	 * @param offset
@@ -169,7 +168,6 @@ public class TarHeader {
 	 * Determine the number of bytes in an entry name.
 	 * 
 	 * @param name
-	 * @param header
 	 *            The header buffer from which to parse.
 	 * @param offset
 	 *            The offset into the buffer from which to parse.
@@ -195,7 +193,7 @@ public class TarHeader {
 	 * Creates a new header for a file/directory entry.
 	 * 
 	 * 
-	 * @param name
+	 * @param entryName
 	 *            File name
 	 * @param size
 	 *            File size in bytes
@@ -203,8 +201,6 @@ public class TarHeader {
 	 *            Last modification time in numeric Unix time format
 	 * @param dir
 	 *            Is directory
-	 * 
-	 * @return
 	 */
 	public static TarHeader createHeader(String entryName, long size, long modTime, boolean dir) {
 		String name = entryName;

src/main/java/org/kamranzafar/jtar/TarOutputStream.java

@@ -112,8 +112,7 @@ public class TarOutputStream extends OutputStream {
 
     /**
      * Writes the next tar entry header on the stream
-     * 
-     * @param entry
+     *
      * @throws IOException
      */
     public void putNextEntry(TarEntry entry) throws IOException {

src/main/java/org/kamranzafar/jtar/TarUtils.java

@@ -26,9 +26,6 @@ import java.io.File;
 public class TarUtils {
 	/**
 	 * Determines the tar file size of the given folder/file path
-	 * 
-	 * @param path
-	 * @return
 	 */
 	public static long calculateTarSize(File path) {
 		return tarSize(path) + TarConstants.EOF_BLOCK;