From 852c2ae4d31ccab56dce74b431fcd1df02be309c Mon Sep 17 00:00:00 2001
From: Kenneth Russel <kbrussel@alum.mit.edu>
Date: Tue, 27 Feb 2007 22:31:39 +0000
Subject: Fixed Issue 281: FileUtil doc enhancement

Improved documentation as suggested.


git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@1159 232f8b59-042b-4e1e-8c03-345bb8c30851
---
 src/classes/com/sun/opengl/util/FileUtil.java | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

(limited to 'src/classes/com/sun/opengl/util')

diff --git a/src/classes/com/sun/opengl/util/FileUtil.java b/src/classes/com/sun/opengl/util/FileUtil.java
index 6ff3e2bbd..2971de636 100755
--- a/src/classes/com/sun/opengl/util/FileUtil.java
+++ b/src/classes/com/sun/opengl/util/FileUtil.java
@@ -47,10 +47,14 @@ public class FileUtil {
   private FileUtil() {}
 
   /**
-   * Returns the suffix of the given file name for identifying the
-   * file to the configured TextureProviders.
+   * Returns the lowercase suffix of the given file name (the text
+   * after the last '.' in the file name). Returns null if the file
+   * name has no suffix. Only operates on the given file name;
+   * performs no I/O operations.
    *
    * @param file name of the file
+   * @return lowercase suffix of the file name
+   * @throws NullPointerException if file is null
    */
 
   public static String getFileSuffix(File file) {
@@ -58,10 +62,14 @@ public class FileUtil {
   }
 
   /**
-   * Returns the suffix of the given file name for identifying the
-   * file to the configured TextureProviders.
+   * Returns the lowercase suffix of the given file name (the text
+   * after the last '.' in the file name). Returns null if the file
+   * name has no suffix. Only operates on the given file name;
+   * performs no I/O operations.
    *
    * @param filename name of the file
+   * @return lowercase suffix of the file name
+   * @throws NullPointerException if filename is null
    */
   public static String getFileSuffix(String filename) {
     int lastDot = filename.lastIndexOf('.');
-- 
cgit v1.2.3