From eef97b91d7e3c182f83a9a4e5d026cd37df0c81f Mon Sep 17 00:00:00 2001
From: mintty <mintty@users.noreply.github.com>
Date: Thu, 29 Sep 2016 14:53:19 +0200
Subject: [PATCH] Added Configuration instructions

---
 README.md | 23 +++++++++++++++++++++--
 wsl.bat   |  8 ++++++++
 2 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 47f3476..14c8a8b 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 Mintty as a terminal for Bash on Ubuntu on Windows / WSL.
 
-#### Overview ####
+### Overview ###
 
 Run the [installer](https://github.com/mintty/wsltty/releases) to install
 * wsltty package components (see below) in the user’s application directory (where WSL is also installed)
@@ -10,7 +10,26 @@ Run the [installer](https://github.com/mintty/wsltty/releases) to install
 * a script `wsl.bat` to invoke wsltty manually; copy the script from `%LOCALAPPDATA%\wsltty` to `%SYSTEMROOT%\System32` if desired
 * an uninstall script that can be invoked manually to remove shortcuts and context menu entries
 
-#### Components ####
+### Configuration ###
+
+#### Command line script wsl.bat ####
+
+* To enable invocation of this script from WIN+R or from cmd.exe, 
+  copy it from `%LOCALAPPDATA%\wsltty` into `%SYSTEMROOT%\System32`.
+  (The package does not do this to avoid trouble with missing admin privileges.)
+* To start the terminal in the current directory when calling the script from the command line,
+  modify it (or a copy for this purpose) and remove the final `-l` parameter.
+* To enforce starting in your Linux home directory, do *either* of:
+  * On Linux side, add a `cd` command to your `$HOME/.profile`.
+  * In the script (or a copy for this purpose), add `-C~` as first parameter of `wslbridge`: `... /bin/wslbridge -C~ -t /bin/bash -l`.
+
+#### Desktop shortcut and Start menu shortcut ####
+
+To enforce starting in your Linux home directory, do *either* of:
+* On Linux side, add a `cd` command to your `$HOME/.profile`.
+* Open Shortcut Properties; in the Target, add `-C~` as first parameter of `wslbridge`: `... /bin/wslbridge -C~ -t /bin/bash -l`.
+
+### Components ###
 
 For mintty, see the [Mintty homepage](http://mintty.github.io/).
 
diff --git a/wsl.bat b/wsl.bat
index 4808468..cfaed58 100755
--- a/wsl.bat
+++ b/wsl.bat
@@ -1,4 +1,12 @@
 @echo off
 
+rem Start mintty terminal for WSL in home directory
+
+rem To enable invocation of this script from WIN+R or from cmd.exe,
+rem you may want to copy this script into "%SYSTEMROOT%\System32"
+
+rem You may want a variant of this script without trailing "-l" 
+rem to start in the current directory from cmd.exe
+
 "%LOCALAPPDATA%\wsltty\bin\mintty.exe" -o Locale=C -o Charset=UTF-8 -i "%LOCALAPPDATA%\lxss\bash.ico" /bin/wslbridge -t /bin/bash -l