3.7.3

LICENSE.mintty

@@ -1,4 +1,4 @@
-mintty is copyright 2008-22 Andy Koppe, 2015-22 Thomas Wolff.
+mintty is copyright 2008-23 Andy Koppe, 2015-23 Thomas Wolff.
 
 Licensed under the terms of the GNU General Public License version 3 or later,
 amended with the bundling clause to clarify ambiguous interpretation.

README.md

@@ -11,13 +11,21 @@ WSLtty components
   (“home”-located configuration files from a previously installed version 
   will be migrated to the new default location)
 * Start Menu shortcuts to start WSL terminals
+* Desktop shorcut to start a terminal for the default WSL distribution
 * `*.bat` scripts to invoke WSL terminals from the command line
 * optional context menu entries for Windows Explorer to start WSL terminals in the respective folder
 * install/uninstall context menu items from Start Menu subfolder `WSLtty`
 
 ---
 
-### Requirement ###
+### Requirements ###
+
+Wsltty does not seem to work with WSL V2 mode since release 2.0.0 (#343).
+As a workaround until a solution in the wslbridge gateway, it is suggested 
+to install [release 1.3.17](https://github.com/microsoft/WSL/releases/tag/1.3.17); 
+maybe uninstall WSL first, see [issue 343 comment](https://github.com/mintty/wsltty/issues/343#issuecomment-1818367512).
+Another remedy could be to configure your WSL distributions to run in WSL V1 mode, for example:
+`wsl --set-version Ubuntu 1`.
 
 Since release 3.0.5, WSLtty requires Windows version 1809 (the November 2018 release).
 
@@ -27,8 +35,10 @@ Since release 3.0.5, WSLtty requires Windows version 1809 (the November 2018 rel
 
 #### WSLtty installer ([Download](https://github.com/mintty/wsltty/releases) standalone installation) ####
 
-Run the [installer](https://github.com/mintty/wsltty/releases) to install 
-the components listed above.
+From the [release downloads](https://github.com/mintty/wsltty/releases), 
+run the wsltty-VERSION-x86_64-install.exe installer to install 
+the components listed above. Make sure to select a 64-bit installer 
+on a 64-bit system.
 If Windows complains with a “Windows protected your PC” popup, 
 you may need to click “Run anyway” to proceed with the installation.
 You may need to open the Properties of the installer first, tab “General” 
@@ -53,6 +63,11 @@ release also contains a `.cab` file. Download it, open it, extract its files
 to some temporary deployment directory, and invoke `install.bat` from there, 
 or `install-portable.bat` for a portable installation.
 
+#### Quiet installer ####
+
+The wsltty-VERSION-x86_64-install-quiet.exe installer is intended for 
+integration in another installation framework.
+
 #### Installation from source repository ####
 
 Checkout the wsltty repository, or download the source archive, unpack and rename the directory to `wsltty`.
@@ -65,6 +80,12 @@ environment for this purpose would be installed with the
 from [cygwin.com](https://cygwin.com/), 
 with additional packages `make`, `gcc-g++`, `unzip`, `zoo`, `patch`, (`lcab`).
 
+#### Build installers ####
+
+Install a minimal Cygwin environment plus the additional packages as 
+listed for «Installation from source repository».
+Invoke `make pkg` or just `make`.
+
 #### Installation to non-default locations ####
 
 (For experts)
@@ -78,6 +99,7 @@ Note: These are 3rd-party packages, not managed by this repository.
 
 #### Windows Package Manager ####
 
+([Check package](https://github.com/microsoft/winget-pkgs/tree/master/manifests/m/Mintty/WSLtty))
 To install wsltty from the 
 [Windows Package Manager Community Repository](https://github.com/microsoft/winget-pkgs), 
 invoke one of
@@ -86,6 +108,7 @@ invoke one of
 
 #### Chocolatey ####
 
+([Check package](https://community.chocolatey.org/packages/wsltty))
 If you use the [Chocolatey package manager](https://chocolatey.org/), 
 invoke one of
 * `choco install wsltty`
@@ -93,6 +116,7 @@ invoke one of
 
 #### Scoop ####
 
+([Check package](https://scoop.sh/#/apps?q=wsltty))
 If you use the [Scoop package manager](https://scoop.sh/), 
 * `scoop bucket add extras`
 
@@ -113,7 +137,7 @@ To uninstall wsltty software completely, remove the installation folder manually
 
 WSLtty can be invoked with
 * installed Start Menu shortcuts (or Desktop shortcuts if copied there)
-* *.bat scripts (optionally with WSL command as parameters)
+* *.bat scripts (optionally with WSL command as parameters) (see [Command line scripts](#command-line-scripts-wslbat) below)
 * Explorer context menu (if installed from the Start Menu `WSLtty` subfolder)
 
 Starting the mintty terminal directly from the WSLtty installation location 
@@ -174,7 +198,7 @@ from the Start Menu if desired.
 The Start menu folder WSLtty contains the link 
 <img align=absmiddle height=25 src=https://user-images.githubusercontent.com/12740416/57078483-a7846a00-6cee-11e9-9c5e-8c2e9e56cae4.png>`configure WSL shortcuts`.
 This function is initially run when wsltty is installed.
-If should be rerun after adding or removing WSL distributions, 
+It should be rerun after adding or removing WSL distributions, 
 in order to create the respective set of shortcuts in the Start menu.
 
 #### Command line scripts `wsl*.bat` ####
@@ -210,7 +234,7 @@ Start Menu subfolder `WSLtty`:
 
 Wsltty installation and the mintty terminal try to use the icon of the 
 respective WSL distribution. If it cannot be determined, a penguin icon 
-is used as a default. You can replace it with your preferred fallback icon 
+is used as a fallback. You can replace it with your preferred default icon 
 by replacing the icon file `%LOCALAPPDATA%\wsltty\wsl.ico`.
 
 #### Mintty settings ####
@@ -250,7 +274,8 @@ and have emojis deployed already in the common config folder
 `%APPDATA%\mintty\emojis`, they will be reused by wsltty.
 
 To deploy emojis standalone for wsltty, use the scripts installed in 
-`%APPDATA%\wsltty\emojis`:
+`%APPDATA%\wsltty\emojis` within WSL:
+* `cd $(wslpath "$APPDATA/wsltty/emojis")`
 * `getemojis` to provide emoji graphics as listed by Unicode.org
 * `getflags` to provide emoji flag graphics (extending Unicode dynamically) from various sources
 

VERSION

@@ -1 +1 @@
-3.6.4
+3.7.3

makefile

@@ -10,16 +10,16 @@
 
 
 # wsltty release
-ver=3.6.4
+ver=3.7.3
 
 # wsltty appx release - must have 4 parts!
-verx=3.6.4.1
+verx=3.7.3.1
 
 
 ##############################
 # mintty release version
 
-minttyver=3.6.4
+minttyver=3.7.3
 
 ##############################
 
@@ -27,7 +27,7 @@ minttyver=3.6.4
 repo=Biswa96/wslbridge2
 
 # wslbridge2 master release version
-wslbridgever=0.11
+wslbridgever=0.12
 
 # wslbridge2 latest version
 #archive=master