Resource Files - Stow
Description: Stow

Next: Compile-time vs Install-time, Previous: Target Maintenance, Up: Top

## 11 Resource Files

Default command line options may be set in `.stowrc` (current directory) or `~/.stowrc` (home directory). These are parsed in that order, and effectively prepended to you command line. This feature can be used for some interesting effects.

For example, suppose your site uses more than one stow directory, perhaps in order to share around responsibilities with a number of systems administrators. One of the administrators might have the following in their `~/.stowrc` file:

         --dir=/usr/local/stow2
         --target=/usr/local
         --ignore='~'
         --ignore='^CVS'

so that the `stow` command will default to operating on the `/usr/local/stow2` directory, with `/usr/local` as the target, and ignoring vi backup files and CVS directories.

If you had a stow directory `/usr/local/stow/perl-extras` that was only used for Perl modules, then you might place the following in `/usr/local/stow/perl-extras/.stowrc`:

         --dir=/usr/local/stow/perl-extras
         --target=/usr/local
         --override=bin
         --override=man
         --ignore='perllocal\.pod'
         --ignore='\.packlist'
         --ignore='\.bs'

so that when you are in the `/usr/local/stow/perl-extras` directory, `stow` will regard any subdirectories as stow packages, with `/usr/local` as the target (rather than the immediate parent directory `/usr/local/stow`), overriding any pre-existing links to bin files or man pages, and ignoring some cruft that gets installed by default.