view release on metacpan or  search on metacpan

bin/gwrap_ls.pl  view on Meta::CPAN

        ),

        check(
            [
                'S', 'sort by size',
            ],
            'sort by file size',
        ),

        radio(
            'sort',
            'sort by WORD instead of name: none -U, extension -X, size -S, time -t, version -v',
            choices => [ 'none', 'extension', 'size', 'time', 'version'],
        ),

        check(
            [
                't', 'sort by time'
            ],
            'sort by modification time, newest first',
        ),

        check(
            ['U', 'no sort'],
            'do not sort; list entries in directory order',
        ),

        check(
            ['1', 'one per line'],
            'list one file per line',
        ),

        check(
            'help',
            'display this help and exit',
        ),

        check(
            'version',
            'output version information and exit',
        ),
    ],

    advanced    => [
        check(
            'almost-all',
            'do not list implied . and ..',
        ),

        check(
            'author',
            'with -l, print the author of each file',
        ),

        check(
            ['b', 'escape'],
            'print C-style escapes for nongraphic characters',
        ),

        check(
            ['B', 'ignore-backups'],
            'do not list implied entries ending with ~',
        ),

        radio(
            'block-size',
            'scale sizes by SIZE before printing them. E.g., \'--block-size=M\' prints sizes in units of 1,048,576 bytes. SIZE is an integer and optional unit (example: 10M is 10*1024*1024). Units are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB...
            choices => ['KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'],
        ),

        check(
            ['c', 'ctime'],
            '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',
        ),

        radio(
            'color',
            qq[colorize the output. Defaults to 'always' or can be 'never' or 'auto'],
            choices => [
                'never',    # the choices
                'always',
                'auto',
            ],
        ),

        check(
            ['D', 'dired'],
            'generate output designed for Emacs dired mode',
        ),

        radio(
            'format',
            'across -x, commas -m, horizontal -x, long -l, single-column -1, verbose -l, vertical -C',
            choices => ['across', 'commas', 'horizontal', 'long', 'single-column', 'verbose', 'vertical'],
        ),

        check(
            'full-time',
            'like -l --time-style=full-iso',
        ),

        check(
            ['g', 'no owner'],
            'like -l, but do not list owner',
        ),

        check(
            ['G', 'no-group'],
            'in a long listing, don\'t print group names',
        ),

        check(
            ['H', 'dereference-command-line'],
            'follow symbolic links listed on the command line',
        ),

        check(
            'dereference-command-line-symlink-to-dir',
            'follow each command line symbolic link that points to a directory',
        ),

bin/gwrap_ls.pl  view on Meta::CPAN

=pod

=head1 NAME

gwrap_ls.pl - ls wrapped in CLI::Gwrap.pm

=head1 VERSION

version 0.030

=head1 AUTHOR

Reid Augustin <reid@hellosix.com>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Reid Augustin.

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.

=cut


__END__



LS(1)                                          User Commands                                          LS(1)



NAME
       ls - list directory contents

SYNOPSIS
       ls [OPTION]... [FILE]...

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

       --block-size=SIZE
              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 defaults to 'always' or can be 'never' or 'auto'.  More info below

       -d, --directory
              list directory entries instead of contents, and do not dereference symbolic links

       -D, --dired
              generate output designed for Emacs' dired mode

       -f     do not sort, enable -aU, disable -ls --color

       -F, --classify
              append indicator (one of */=>@|) to entries

       --file-type
              likewise, except do not append '*'

       --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.

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

       -G, --no-group
              in a long listing, don't print group names

       -h, --human-readable
              with -l, print sizes in human readable format (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

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

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

       --indicator-style=WORD
              append indicator with style WORD to  entry  names:  none  (default),  slash  (-p),  file-type
              (--file-type), classify (-F)

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