NAME

       lsrc — show dotfiles files managed by rcm

SYNOPSIS

       lsrc  [-FhqVv]  [-B  hostname]  [-d dir] [-I excl_pat] [-S excl_pat] [-s excl_pat] [-t tag] [-U excl_pat]
            [-u excl_pat] [-x excl_pat] [files ...]

DESCRIPTION

       This program lists all configuration files,  both  the  sources  in  the  dotfiles  directories  and  the
       destinations  in  your  home  directory.  See rcup(1), the “DIRECTORY LAYOUT” section, for details on the
       directory layout.  It supports these options:

       -B HOSTNAME  treat host-HOSTNAME as the host-specific directory instead of  computing  it  based  on  the
                    computer's hostname

       -d DIR       list dotfiles from the DIR. This can be specified multiple times.

       -F           show  symbols next to each file indicating status information. Supported symbols are @ which
                    indicates that the file is a symlink, $ which indicates it's a symlinked directory, and X to
                    indicate that the file is a copy. More details on copied files and symlinked directories can
                    be found in rcrc(5) under the documentation on COPY_ALWAYS and SYMLINK_DIRS, respectively.

       -h           show usage instructions.

       -I excl_pat  include the files that match the given pattern. This is applied after  any  -x  options.  It
                    uses  the  same  pattern  language as -x; more details are in the “EXCLUDE PATTERN” section.
                    Note that you may have to quote the exclude pattern so the shell does not evaluate the glob.

       -S excl_pat  symlink the directories that match  the  given  pattern.  See  “EXCLUDE  PATTERN”  for  more
                    details. This option can be repeated. You may need to quote the pattern to prevent the shell
                    from swallowing the glob.

       -s excl_pat  if  a  directory  matches  the  given pattern, recur inside of it instead of symlinking. See
                    “EXCLUDE PATTERN” for more details. This is the opposite of the -S option, and can  be  used
                    to  undo  it  or the SYMLINK_DIRS setting in your rcrc(5) configuration. It can be repeated,
                    and the pattern may need to be quoted to protect it from your shell.

       -t TAG       list dotfiles according to TAG

       -U excl_pat  the rc files or directories matching this pattern will not be symlinked or  created  with  a
                    leading  dot.  See  “EXCLUDE PATTERN” for more details. This option can be repeated. You may
                    need to quote the pattern to prevent the shell from swallowing the glob.

       -u excl_pat  if an rc file or directory matches the given  pattern,  it  must  be  dotted.  See  “EXCLUDE
                    PATTERN” for more details. This is the opposite of the -U option, and can be used to undo it
                    or  the UNDOTTED setting in your rcrc(5) configuration. This option can be repeated. You may
                    need to quote the pattern to prevent the shell from swallowing the glob.

       -V           show the version number.

       -v           increase verbosity. This can be repeated for extra verbosity.

       -q           decrease verbosity

       -x excl_pat  exclude the files that match the given pattern. See “EXCLUDE PATTERN” for more details. This
                    option can be repeated. Quote the pattern if it contains a valid shell glob.

       files ...    only list the specified file(s)

EXCLUDE PATTERN

       The exclude pattern specifies a colon-separated pair of dotfiles directory and file  glob.  The  dotfiles
       directory  is optional and, if omitted, defaults to *, which is a special token that matches any dotfiles
       directory. The file glob is relative to the  dotfiles  directory,  ignoring  meta  directories.  A  colon
       combines them.

       For  example,  to  ignore all emacs-related items from the thoughtbot-dotfiles directory, use the exclude
       pattern:

             thoughtbot-dotfiles:*emacs*

       To ignore any bash_profile file, use the pattern:

             *:bash_profile

       Or more simply:

             bash_profile

       Since exclude patterns are often valid shell globs, be sure to quote  them.  See  the  caveats  noted  in
       “BUGS” when using an exclude pattern.

ENVIRONMENT

       RCRC  User configuration file. Defaults to ~/.rcrc.

FILES

       ~/.dotfiles ~/.rcrc

SEE ALSO

       mkrc(1), rcdn(1), rcup(1), rcrc(5), rcm(7)

AUTHORS

       lsrc is maintained by Mike Burns <mburns@thoughtbot.com> and thoughtbot: http://thoughtbot.se

Debian                                          December 23, 2016                                        LSRC(1)