doc disabling mlockall by default

kimchy · kimchy · commit bd55c3d52c8c · 2010-12-27T16:54:52.000+02:00
diff --git a/docs/elasticsearch/setup/installation/index.textile b/docs/elasticsearch/setup/installation/index.textile
@@ -55,11 +55,11 @@ p. In order to test how many open files the process can open, start it with @-De
 
 h3. Memory Settings
 
-p.  By default, when starting, an "mlockall":http://opengroup.org/onlinepubs/007908799/xsh/mlockall.html will be called to try and lock the process address space so it won't be swapped. For this to work, it is recommended to set both the min and max memory allocation to be the same.
+p.  There is an option to use "mlockall":http://opengroup.org/onlinepubs/007908799/xsh/mlockall.html to try and lock the process address space so it won't be swapped. For this to work, the @bootstrap.mlockall@ should be set to @true@ and it is recommended to set both the min and max memory allocation to be the same. 
 
-p. In order to see if this works or not, set the @common.jna@ logging to DEBUG level. In order to disable even trying to @mlockall@, set @bootstrap.mlockall@ to @false@.
+p. In order to see if this works or not, set the @common.jna@ logging to DEBUG level. A solution to "Unknown mloclall error 0" can be to set @ulimit -l unlimited@.
 
-p. A solution to "Unknown mloclall error 0" can be to set @ulimit -l unlimited@.
+p. Note, this is experimental feature, and might cause the JVM or shell session to exit if failing to allocate the memory (because not enough memory is available on the machine).
 
 h2. Running As a Service
 
