From 2ca99b83de79b4811ac1b0cfd3210c6dee14d6ae Mon Sep 17 00:00:00 2001
From: shadowislord <shadowislord@gmail.com>
Date: Thu, 5 Jun 2014 23:59:24 -0400
Subject: [PATCH] * More javadoc in NativeLibraryLoader

---
 .../com/jme3/system/NativeLibraryLoader.java  | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/jme3-desktop/src/main/java/com/jme3/system/NativeLibraryLoader.java b/jme3-desktop/src/main/java/com/jme3/system/NativeLibraryLoader.java
index e85f6e86a..ed7994313 100644
--- a/jme3-desktop/src/main/java/com/jme3/system/NativeLibraryLoader.java
+++ b/jme3-desktop/src/main/java/com/jme3/system/NativeLibraryLoader.java
@@ -171,6 +171,8 @@ public final class NativeLibraryLoader {
      * Specify a custom location where native libraries should
      * be extracted to. Ensure this is a unique path not used
      * by other applications to extract their libraries.
+     * Set to <code>null</code> to restore default
+     * functionality.
      * 
      * @param path Path where to extract native libraries.
      */
@@ -178,6 +180,23 @@ public final class NativeLibraryLoader {
         extractionFolderOverride = new File(path).getAbsoluteFile();
     }
 
+    /**
+     * Returns the folder where native libraries will be extracted.
+     * This is automatically determined at run-time based on the 
+     * following criteria:<br>
+     * <ul>
+     * <li>If a {@link #setCustomExtractionFolder(java.lang.String) custom
+     * extraction folder} has been specified, it is returned.
+     * <li>If the user can write to the working folder, then it 
+     * is returned.</li>
+     * <li>Otherwise, the {@link JmeSystem#getStorageFolder() storage folder}
+     * is used, to prevent collisions, a special subfolder is used
+     * called <code>natives_&lt;hash&gt;</code> where &lt;hash&gt;
+     * is computed automatically as the XOR of the classpath hash code
+     * and the last modified date of this class.
+     * 
+     * @return Path where natives will be extracted to.
+     */
     public static File getExtractionFolder() {
         if (extractionFolderOverride != null) {
             return extractionFolderOverride;