core/builtins/ls.cif
changeset 66 2a78c4ff2eab
parent 26 5d370dafea69
child 67 84fefe1cd57f
equal deleted inserted replaced
63:6a2083f7eeb8 66:2a78c4ff2eab
    17 List the contents of a directory.
    17 List the contents of a directory.
    18 
    18 
    19 ==long-description
    19 ==long-description
    20 
    20 
    21 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.
    21 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.
    22 
       
    23 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.
       
    24 
    22 
    25 ==argument filename dir_name optional
    23 ==argument filename dir_name optional
    26 
    24 
    27 The directory to list (defaults to the current working directory).
    25 The directory to list (defaults to the current working directory).
    28 
    26 
    56 
    54 
    57 archived
    55 archived
    58 
    56 
    59 =back
    57 =back
    60 
    58 
    61 For example, C<d--s-> indicates a drectory with the system bit set.
    59 For example, C<d--s-> indicates a directory with the system bit set.
    62 
    60 
    63 ==option bool H human
    61 ==option bool H human
    64 
    62 
    65 Display file sizes in human readable form.
    63 Display file sizes in human readable form.
       
    64 
       
    65 ==option bool N no-localise
       
    66 
       
    67 Do not display localised time and date formats; instead use microseconds from 0AD nominal Gregorian.
    66 
    68 
    67 ==option bool 1 one
    69 ==option bool 1 one
    68 
    70 
    69 Outputs one entry per line rather than trying to columnise the output. Is implied if C<stdout> is redirected or if C<--long> is specified.
    71 Outputs one entry per line rather than trying to columnise the output. Is implied if C<stdout> is redirected or if C<--long> is specified.
    70 
    72 
    71 ==option bool r recurse
    73 ==option bool r recurse
    72 
    74 
    73 Recursively list any directories that are encountered. Currently only supported for C<--long> listings.
    75 Recursively list any directories that are encountered. Currently only supported for C<--long> listings.
    74 
    76 
       
    77 ==see-also
       
    78 
       
    79 L<cd|cd>
       
    80 
    75 ==copyright
    81 ==copyright
    76 
    82 
    77 Copyright (c) 2006-2010 Accenture. All rights reserved.
    83 Copyright (c) 2006-2010 Accenture. All rights reserved.
    78 
    84