From bcf632577b137e8471b3e665e8c66a56e224a8b8 Mon Sep 17 00:00:00 2001 From: Egor Tensin Date: Wed, 5 Oct 2016 05:02:47 +0300 Subject: README update --- README.md | 37 ++++++++++++++++++++----------------- 1 file changed, 20 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 67e46ec..2cc9f22 100644 --- a/README.md +++ b/README.md @@ -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 ------- -- cgit v1.2.3