diff options
author | Egor Tensin <Egor.Tensin@gmail.com> | 2016-10-05 05:02:47 +0300 |
---|---|---|
committer | Egor Tensin <Egor.Tensin@gmail.com> | 2016-10-05 05:02:47 +0300 |
commit | bcf632577b137e8471b3e665e8c66a56e224a8b8 (patch) | |
tree | f543eb57d32418c123728817fe247dffc0c3153f /README.md | |
parent | add README (diff) | |
download | config-links-bcf632577b137e8471b3e665e8c66a56e224a8b8.tar.gz config-links-bcf632577b137e8471b3e665e8c66a56e224a8b8.zip |
README update
Diffstat (limited to '')
-rw-r--r-- | README.md | 37 |
1 files changed, 20 insertions, 17 deletions
@@ -1,41 +1,44 @@ Windows configuration files =========================== -An easy way to store & sync various configuration files across Windows -installations. -Requires Cygwin. +An easy and ad-hoc way to store & sync various configuration files across +Windows installations. Actual configuration files are stored in this repository in directories which -names must match the `^%[_[:alpha:]][_[:alnum:]]+%$` regular expression. +names must roughly match the `%.+%` regular expression. The part between the percent signs is the name of an environment variable. Its value replaces the path of this directory, making for the path of a symlink which would point to a file in this repository. +A database of symlinks is maintained in case a file is removed from this +repository (the corresponding symlink is then deleted). +Default database file name is "db.bin". + Usage ----- -``` -usage: ./update.sh -``` +To update the symlinks, run `./update.sh`. +Requires Cygwin. For example, here's a possible representation of the "%PROGRAMDATA%" directory: -``` -%PROGRAMDATA%/ -└── a - └── b - └── c - └── test.txt -``` + %PROGRAMDATA%/ + └── a + └── b + └── c + └── test.txt Running the script above would create a symlink at -"C:\ProgramData\a\b\c\test.txt" pointing to this repository's -"%PROGRAMDATA%\a\b\c\test.txt". +"C:\ProgramData\a\b\c\test.txt" pointing "%PROGRAMDATA%\a\b\c\test.txt" in this +repository. Limitations ----------- Only alphanumeric variable names are supported. -For example, the environment variable `ProgramFiles(x86)` is not supported. +Speaking more precisely, directory names must match the +`^%[_[:alpha:]][_[:alnum:]]+%$` regular expression. +This means that, for example, the environment variable `ProgramFiles(x86)` is +not supported. License ------- |