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