From 11da9e563d2f56bf677cef1f058e44c29ffab750 Mon Sep 17 00:00:00 2001
From: Ng Yik Phang <ngyikp@gmail.com>
Date: Sun, 28 May 2017 16:51:02 +0800
Subject: [PATCH] Document Windows Subsystem for Linux support

Fixes https://github.com/erkin/ponysay/issues/255
---
 README.md               | 18 ++++++++++--------
 manuals/ponysay.texinfo |  5 +++--
 2 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index d7b6fd85..50f20398 100755
--- a/README.md
+++ b/README.md
@@ -47,6 +47,16 @@ The package is available in OpenSuSe 13.2 and Factory since 6th april 2014, if y
 #### Mac OS X (OSX)
 A `ponysay` [Homebrew](https://github.com/mxcl/homebrew) formula is available.
 
+#### Microsoft™ Windows®
+[¯\\\_(ツ)\_/¯](http://fc05.deviantart.net/fs71/i/2011/266/d/e/shrugpony_firefly_by_imaplode-d4aqtvx.png)
+
+You could either run ponysay on:
+
+* Cygwin
+* [Windows Subsystem for Linux](https://msdn.microsoft.com/en-us/commandline/wsl/about) (more compatible)
+
+  Make sure you install the latest Windows updates to [enable true colour console support](https://blogs.msdn.microsoft.com/commandline/2016/09/22/24-bit-color-in-the-windows-console/), then follow the install instructions for Ubuntu in a bash console.
+
 ### Print a pony fortune upon terminal startup
 
 This requires the `fortune` utility to be installed. It can install be from the distribution's repositories (might be named `fortune-mod`).
@@ -85,14 +95,6 @@ fi
 Read the PDF or info manual for more information.
 
 
-Installation on Microsoft™ Windows®
------------------------------------
-[¯\\\_(ツ)\_/¯](http://fc05.deviantart.net/fs71/i/2011/266/d/e/shrugpony_firefly_by_imaplode-d4aqtvx.png)
-Ponysay runs on Cygwin and GNU/NT (a.k.a. Ubuntu on Windows), 
-however the Windows's Bash on Ubuntu on Windows terminal does
-support xterm-256color colours.
-
-
 Dependencies
 ------------
 
diff --git a/manuals/ponysay.texinfo b/manuals/ponysay.texinfo
index 1deff3f2..2cb5bf67 100755
--- a/manuals/ponysay.texinfo
+++ b/manuals/ponysay.texinfo
@@ -2616,8 +2616,9 @@ fonts in Windows 8; Consolas 10pt, and larger, can be used for almost perfect
 ponies (they may be just a little distorted on the height), however Consolas
 is only able print the ASCII based balloons.
 
-Ponysay also runs on Ubuntu on Windows, but the terminal's colour support
-leaves something to be desired.
+Ponysay also runs on Windows Subsystem for Linux, be sure to install the 
+latest Windows updates to enable true colour console support, then follow the
+install instructions for Ubuntu in a bash console.