aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
diff options
context:
space:
mode:
authorEgor Tensin <Egor.Tensin@gmail.com>2016-10-04 23:18:30 +0300
committerEgor Tensin <Egor.Tensin@gmail.com>2016-10-04 23:18:30 +0300
commit97387d8e76d4874724b4eb0d621b0ef103486a01 (patch)
tree73fb8ce2878a084f924825338b88ec6d47fbefe1 /README.md
parentrefactoring (diff)
downloadconfig-links-97387d8e76d4874724b4eb0d621b0ef103486a01.tar.gz
config-links-97387d8e76d4874724b4eb0d621b0ef103486a01.zip
add README
Diffstat (limited to 'README.md')
-rw-r--r--README.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..67e46ec
--- /dev/null
+++ b/README.md
@@ -0,0 +1,46 @@
+Windows configuration files
+===========================
+
+An easy way to store & sync various configuration files across Windows
+installations.
+Requires Cygwin.
+Actual configuration files are stored in this repository in directories which
+names must match the `^%[_[:alpha:]][_[:alnum:]]+%$` 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.
+
+Usage
+-----
+
+```
+usage: ./update.sh
+```
+
+For example, here's a possible representation of the "%PROGRAMDATA%" directory:
+
+```
+%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".
+
+Limitations
+-----------
+
+Only alphanumeric variable names are supported.
+For example, the environment variable `ProgramFiles(x86)` is not supported.
+
+License
+-------
+
+Distributed under the MIT License.
+See [LICENSE.txt] for details.
+
+[LICENSE.txt]: LICENSE.txt