conf

conf - my dotfiles manager
git clone git://git.alex.balgavy.eu/conf.git
Log | Files | Refs | README | LICENSE

commit 9b368969d263f411f5152b47fd12382ff55d714a
parent 18727c655a3563d01cec3d698d19a157d16e4d93
Author: Alex Balgavy <a.balgavy@gmail.com>
Date:   Sat, 29 Feb 2020 02:36:48 +0100

README

Diffstat:
MREADME.md | 15++++++++-------
1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md @@ -1,17 +1,18 @@ # conf - a personal configuration manager ## Installation -1. Download the `conf` script, make it executable, and put it in your `$PATH`. Perl is required, but should be installed by default on most UNIX systems. On Mac, you can `brew install thezeroalpha/formulae/conf`. -2. Set the value of the `DOTFILES` variable to the location of your dotfiles, either in the environment (recommended), or in the `conf` script itself. -3. Set up your dotfiles hierarchy in any way you want, see the FAQ below for an example. -4. Create a map file; this file defines how your dotfiles/folders map to other locations in your filesystem. +1. Perl is required, but should be installed by default on most UNIX systems. +2. Depending on the OS: + * Mac: you can `brew install thezeroalpha/formulae/conf` + * Linux: `make install`. Alternatively, download the `conf` script, make it executable, and put it in your `$PATH`. On Mac, you can `brew install thezeroalpha/formulae/conf`. +3. Set the value of the `DOTFILES` variable to the location of your dotfiles, either in the environment (recommended), or in the `conf` script itself. +4. Set up your dotfiles hierarchy in any way you want, see the FAQ below for an example. +5. Create a map file; this file defines how your dotfiles/folders map to other locations in your filesystem. You have three options, in ascending order of customization: * Run `conf edit` to open the default file at the default location (named `dot.map` at the root of the directory in the `DOTFILES` variable). * Or manually put a map file in the root of the directory defined in the `DOTFILES` variable. By default, the file is named "dot.map", but this can be changed by manually editing the definition of `$MAPFILE` in the `conf` script. * Or put the file wherever you want on your filesystem, and change the definition of `$MAPFILE` in the `conf` script accordingly. - - -5. Use `conf`, and profit, maybe. Run `conf -h` or `conf -man` to get help. +6. Use `conf`, and profit, maybe. Run `conf -h` or `conf -man` to get help. ## FAQ ### How do you write a map file?