diff -r df16950e242e -r a581f3c08c9a core/builtins/ls.cif
--- a/core/builtins/ls.cif	Sat Jul 31 21:32:20 2010 +0100
+++ b/core/builtins/ls.cif	Wed Aug 25 21:19:19 2010 +0100
@@ -18,6 +18,8 @@
 
 ==long-description
 
+By default ls will columnize the output list. On very large directory listings this may cause the ls command to run out of memory. If this happens, try using the C<-1>/C<--one> option, which will not attempt to format the output.
+
 Note, C<cd> can be used to navigate between drives, but the DOS approach of switching between drives with commands like C<c:> and C<e:> is also supported.
 
 ==argument filename dir_name optional