.Dd July 28, 2013
.Dt LSRC 1
.Os
.Sh NAME
.Nm lsrc
.Nd show configuration files
.Sh SYNOPSIS
.Nm lsrc
.Op Fl Fvq
.Op Fl d Ar dir
.Op Fl I Ar excl_pat
.Op Fl t Ar tag
.Op Fl x Ar excl_pat
.Op files ...
.Sh DESCRIPTION
This program lists all configuration files, both the sources in the
dotfiles directories and the destinations in your home directory.
.
See
.Xr rcup 1 ,
the
.Sx DIRECTORY LAYOUT
section, for details on the directory layout.
.
It supports these options:
.
.Bl -tag
.It Fl d Ar DIR
list dotfiles from the DIR. This can be specified multiple times.
.
.It Fl F
show symbols next to each file indicating status information. Supported
symbols are
.Li @
which indicates that the file is a symlink, and
.Li X
to indicate that the file is a copy. More details on copied files can be
found in
.Xr rcrc 5 ,
under the documentation about
.Va COPY_ALWAYS .
.
.It Fl I Ar excl_pat
include the files that match the given pattern. This is applied after
any
.Fl x
options. It uses the same pattern language as
.Fl x ;
more details are in the
.Sx EXCLUDE PATTERN
section.
.
.It Fl t Ar TAG
list dotfiles according to TAG
.
.It Fl v
increase verbosity. This can be repeated for extra verbosity.
.
.It Fl q
decrease verbosity
.
.It Fl x Ar excl_pat
exclude the files that match the given pattern. See
.Sx EXCLUDE PATTERN
for more details. This option can be repeated.
.
.It Ar files ...
only list the specified file(s)
.El
.Sh 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
.Li * ,
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.
.
.Pp
For example, to ignore all emacs-related items from the
.Pa thoughtbot-dotfiles
directory, use the exclude pattern:
.Pp
.Dl thoughtbot-dotfiles:*emacs*
.Pp
To ignore any
.Pa bash_profile
file, use the pattern:
.Pp
.Dl *:bash_profile
.Pp
Or more simply:
.Pp
.Dl bash_profile
.Pp
.Sh ENVIRONMENT
.Bl -tag -width ".Ev RCRC"
.It Ev RCRC
User configuration file. Defaults to
.Pa ~/.rcrc .
.El
.Sh FILES
.Pa ~/.dotfiles
.Pa ~/.rcrc
.Sh SEE ALSO
.Xr mkrc 1 ,
.Xr rcdn 1 ,
.Xr rcup 1 ,
.Xr rcrc 5 ,
.Xr rcm 7
.Sh AUTHORS
.An "Mike Burns" Aq mike@mike-burns.com