--- a/core/builtins/ls.cif	Thu Aug 05 12:06:56 2010 +0100
+++ b/core/builtins/ls.cif	Fri Aug 06 17:00: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