Example -ls output

The following is the output auto generated by the code in the [Example -ls manpage].

DESCRIPTION

     List information about the FILEs (the current directory by default). Sort 
     entries alphabetically if none of -cftuvSUX nor --sort is specified.

     Mandatory arguments to long options are mandatory for short options too.

     -a, --all
            do not ignore entries starting with .                                    

     -A, --almost-all
            do not list implied . and ..                                             

     --author
            with -l, print the author of each file                                   

     -b, --escape
            print C-style escapes for nongraphic characters                          

     --bock-size=ARG
            scale sizes by SIZE before printing them; `e.g.`, '--block-size=M' prints  
            sizes in units of 1,048,576 bytes; see SIZE format below                 

     -B, --ignore-backups
            do not list implied entries ending with ~                                

     -c     with -lt: sort by, and show, ctime (time of last modification of file    
            status information); with -l: show ctime and sort by name; otherwise:    
            sort by ctime, newest first                                              

     -C     list entries by columns                                                  

     --color=WHEN
            colorize the output; WHEN can be 'always' (default if omitted), 'auto',  
            or 'never'; more info below                                              

     -d, --directory


     -D, --dired
            list directories themselves, not their contents                          

     -f     generate output designed for Emacs dired mode                           

     -F, --classify
            do not sort, enable -aU, disable -ls --color                             

     --file-type
            append indicator (one of \*/=>\@|) to entries                              

     --format=WORD
            across -x, commas -m, horizontal -x, long -l, single-column -1, verbose  
            -l, vertical -C                                                          

     --full-time
            like -l --time-style=full-iso                                            

     -g     like -l, but do not list owner                                           

     --group-directories-first
            group directories before files;                                          

            can be augmented with a --sort option, but any use of --sort=none (-U)   
            disables grouping                                                        

     -G, --no-group
            in a long listing, do not print group names                               

     -h, --human-readable
            with -l and/or -s, print human readable sizes (e.g., 1K 234M 2G)         

     --si   likewise, but use powers of 1000 not 1024                                

     -H, --dereference-command-line
            follow symbolic links listed on the command line                         

     -G, --dereference-command-line-symlink-to-dir
            follow each command line symbolic link that points to a directory        

     --indicator-style=WORD
            do not list implied entries matching shell PATTERN (overridden by -a or  
            -A)                                                                      

     -i, --inode
            print the index number of each file                                      

     --ignore=PATTERN
            do not list implied entries matching shell PATTERN                       

     -k, --kibibytes
            default to 1024-byte blocks for disk usage                               

     -l     use a long listing format                                                

     -L, --dereference
            when showing file information for a symbolic link, show information for  
            the file the link references rather than for the link itself             

     -m     fill width with a comma separated list of entries                        

     -n, --numeric-uid-gid
            like -l, but list numeric user and group IDs                             

     -N, --literal
            print entry names without quoting                                        

     -o     like -l, but do not list group information                               

     --hide-control-chars=ARG
            print ? instead of nongraphic characters                                 

     --show-control-chars
            show nongraphic characters as-is (the default, unless program is 'ls'    
            and output is a terminal)                                                

     -Q, --quote-name
            enclose entry names in double quotes                                     

     --quoting-style
            use quoting style WORD for entry names: literal, locale, shell,          
            shell-always, shell-escape, shell-escape-always, c, escape               

     -r, --reverse
            reverse order while sorting                                              

     -R, --recursive
            list subdirectories recursively                                          

     -s, --size
            print the allocated size of each file, in blocks                         

     -S     sort by file size, largest first                                         

     --sort sort by WORD instead of name: none (-U), size (-S), time (-t), version   
            (-v), extension (-X)                                                     

     --time=WORD
            with -l, show time as WORD instead of default modification time: atime   
            or access or use (-u); ctime or status (-c); also use specified time as  
            sort key if --sort=time (newest first)                                   

     --time-style
            with -l, show times using style STYLE: full-iso, long-iso, iso, locale,  
            or +FORMAT; FORMAT is interpreted like in 'date'; if FORMAT is           
            FORMAT1<newline>FORMAT2, then FORMAT1 applies to non-recent files and    
            FORMAT2 to recent files; if STYLE is prefixed with 'posix-', STYLE takes 
            effect only outside the POSIX locale                                     

     -t     sort by modification time, newest first                                  

     --tabsize=COLS
            assume tab stops at each COLS instead of 8                               

     -u     with -lt: sort by, and show, access time; with -l: show access time and  
            sort by name; otherwise: sort by access time, newest first               

     -U     do not sort; list entries in directory order                             

     -v, --sort-natural
            natural sort of (version) numbers within text                            

     -w, --width
            set output width to COLS.  0 means no limit                              

     -x     list entries by lines instead of by columns                              

     -X, --sort-by-extension
            sort alphabetically by entry extension                                   

     -Z, --context
            print any security context of each file                                  

     -1     list one file per line.  Avoid '\n' with -q or -b                        

     --help display this help and exit                                               

     --version
            output version information and exit                                      

     The SIZE argument is an integer and optional unit (example: 10K is 10*1024).  
     Units are K,M,G,T,P,E,Z,Y (powers of 1024) or KB,MB,...(powers of 1000).

     Using color to distinguish file types is disabled both by default and with 
     --color=never.  With --color=auto, ls emits color codes only when standard 
     output is connected to a terminal.  The LS_COLORS environment variable can 
     change the settings.  Use the dircolors command to set it.