support/ruby/collins-shell/lib/collins_shell/console/commands/iterators.rb
def options opt
        opt.banner <<-BANNER
          Usage: ls [-d|--delimiter] [-g|--grep] [-F--format] [-f|--flood] [path]

          ls provides you information based on your current context (either a path or an asset)

          When in an asset, ls will show you available commands
          When in a path, ls will show you either assets that match the path or values appropriate for the path
          When in no context, will show you available tags (to use in a path)

          Examples:
            ls /HOSTNAME/.*dev.*
            ls /HOSTNAME/.*dev.* --format='{{hostname}} {{status}} {{tag}}' --grep=blake

          You can customize the default format used by ls (when applied to assets) by creating a ~/.pryrc file with contents like:

              Pry.config.default_asset_format = '{{tag}} {{hostname}} {{status}}'

          Where the rhs of the default_asset_format is the format you want to use
        BANNER
        pager_options opt
        opt.on :d, "delimiter", "Delimiter for use with --format, defaults to \\n", :argument => true
        opt.on :r, "return", "Return values as well as outputting them"
        opt.on :g, "grep", "A regular expression to provide to results", :argument => true, :optional => false
        opt.on :F, "format", "Provide a format for output", :argument => true, :optional => false
      end
# --return (after printing also return value) and --flood (disable paging)
return (after printing also return value) and --flood (disable paging)
return ( after printing also return value ) and -- flood ( disable paging )
def options opt
        opt.banner <<-BANNER
          Usage: ls [-d|--delimiter] [-g|--grep] [-F--format] [-f|--flood] [path]
          ls provides you information based on your current context (either a path or an asset)
          When in an asset, ls will show you available commands
          When in a path, ls will show you either assets that match the path or values appropriate for the path
          When in no context, will show you available tags (to use in a path)
          Examples:
            ls /HOSTNAME/.*dev.*
            ls /HOSTNAME/.*dev.* --format='{{hostname}} {{status}} {{tag}}' --grep=blake
          You can customize the default format used by ls (when applied to assets) by creating a ~/.pryrc file with contents like:
              Pry.config.default_asset_format = '{{tag}} {{hostname}} {{status}}'
          Where the rhs of the default_asset_format is the format you want to use
        BANNER
        pager_options opt
        opt.on :d, "delimiter", "Delimiter for use with --format, defaults to \\n", :argument => true
        opt.on :r, "return", "Return values as well as outputting them"
        opt.on :g, "grep", "A regular expression to provide to results", :argument => true, :optional => false
        opt.on :F, "format", "Provide a format for output", :argument => true, :optional => false
      end
def options opt opt . banner <<-BANNER 
          Usage: ls [-d|--delimiter] [-g|--grep] [-F--format] [-f|--flood] [path]

          ls provides you information based on your current context (either a path or an asset)

          When in an asset, ls will show you available commands
          When in a path, ls will show you either assets that match the path or values appropriate for the path
          When in no context, will show you available tags (to use in a path)

          Examples:
            ls /HOSTNAME/.*dev.*
            ls /HOSTNAME/.*dev.* --format='{{hostname}} {{status}} {{tag}}' --grep=blake

          You can customize the default format used by ls (when applied to assets) by creating a ~/.pryrc file with contents like:

              Pry.config.default_asset_format = '{{tag}} {{hostname}} {{status}}'

          Where the rhs of the default_asset_format is the format you want to use
         BANNER pager_options opt opt . on :d , "delimiter" , "Delimiter for use with --format, defaults to \\n" , :argument => true opt . on :r , "return" , "Return values as well as outputting them" opt . on :g , "grep" , "A regular expression to provide to results" , :argument => true , :optional => false opt . on :F , "format" , "Provide a format for output" , :argument => true , :optional => false end
return (after printing also return value) and --flood (disable paging)
return ( after printing also return value ) and -- flood ( disable paging )
opt