X-Git-Url: https://arthur.barton.de/gitweb/?p=ax-zsh.git;a=blobdiff_plain;f=README.md;h=3ddbd0cb9287f4bae4d42f278a3b7e5943c8a11c;hp=9f992eb5f2bfe38c621fabda609af6f85b4b0ee2;hb=2ddebb388326d38d99b04303397ecadc185ccc58;hpb=ab4280c3ec2f2e99c01bc52775a9a3135bca8ee1

diff --git a/README.md b/README.md
index 9f992eb..3ddbd0c 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,8 @@
 AX-ZSH: Alex' Modular ZSH Configuration
 =======================================
 
-AX-ZSH is a modular configuration system for the Z shell. If provides sane
-defaults and is extendable by plugins.
-
+AX-ZSH is a modular configuration system for the Z shell (ZSH).
+It provides sane defaults and is extendable by plugins.
 
 Installation
 ------------
@@ -13,32 +12,42 @@ Afterwards use the `install.sh` script inside of the source directory to set
 up the `~/.axzsh` directory.
 
 When using Git it is best to directly clone the AX-ZSH repository into the
-`~/.axzsh` directory and call `install.sh` from this location:
+`~/.axzsh` directory and call `install.sh` from this location.
+
+Clone repository from _GitHub_ (<https://github.com/alexbarton/ax-zsh>):
 
-  $ git clone git://arthur.barton.de/ax-zsh.git ~/.axzsh
-  $ ~/.axzsh/install.sh
+    git clone https://github.com/alexbarton/ax-zsh.git ~/.axzsh
 
-You can use `cd ~/.axzsh && git pull --ff-only` to upgrade this installation.
+Then run the installer script:
+
+    ~/.axzsh/install.sh
 
 The `install.sh` script creates symbolic links for `~/.zprofile`, `~/.zshrc`,
 `~/.zlogin`, and `~/.zlogout` (don't worry, already existing files are backed
 up).
 
-Then you have to restart your ZSH session.
+Now close and restart all your running ZSH session to activate AX-ZSH.
 
+To update AX-ZSH run `axzshctl upgrade`.
 
-Configuration
--------------
+AX-ZSH & Local ZSH Configuration
+--------------------------------
 
 Plugins are loaded when they are linked into the `$AXZSH/active_plugins/`
-directory.
+directory; see the _Customization_ section below for how to activate them.
 
-AX-ZSH doesn't use `~/.zshenv` in any way. So you can use this file for your
-own purposes (for example, to set up some environment variables that AX-ZSH
-relays on). In addition, AX-ZSH reads the optional files `~/.zprofile.local`,
-`~/.zshrc.local`, `~/.zlogin.local`, and `~/.zlogout.local` after its own
-core initialization files when present.
+Don't modify `~/.zprofile`, `~/.zshrc`, `~/.zlogin`, or `~/.zlogout`! These
+are links to "AX-ZSH"-private files that can become overwritten when updating.
 
+You can use the following files for local ZSH configuration:
+
+1. AX-ZSH doesn't use `~/.zshenv` in any way. So you can use this file for your
+   own purposes (for example, to set up some environment variables that AX-ZSH
+   relies on).
+
+2. AX-ZSH reads the optional files `~/.zprofile.local`, `~/.zshrc.local`,
+   `~/.zlogin.local`, and `~/.zlogout.local` after its own core initialization
+   files when present.
 
 Customization
 -------------
@@ -56,7 +65,6 @@ by default.
 In addition you can set the `AXZSH_PLUGIN_D` variable (and `ZSH_CUSTOM` like
 "OhMyZsh") to specify additional plugin search directories.
 
-
 Environment Variables
 ---------------------
 
@@ -74,5 +82,6 @@ Validated and/or set up by core plugins:
 * `PS1`
 * `SHORT_HOST`
 * `TERM`
+* `XDG_RUNTIME_DIR`
 * `XDG_CACHE_HOME`
 * `ZSH_CACHE_DIR`