From 59624f66aa5aaecd0a2bed06070ce6d083aa4d9e Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Fri, 20 Feb 2015 12:23:29 +0100 Subject: [PATCH 1/3] Reworded the note about Windows console and output coloring --- components/console/introduction.rst | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/components/console/introduction.rst b/components/console/introduction.rst index a57068990fa..1557854e7ca 100644 --- a/components/console/introduction.rst +++ b/components/console/introduction.rst @@ -20,15 +20,6 @@ You can install the component in 2 different ways: * :doc:`Install it via Composer ` (``symfony/console`` on `Packagist`_); * Use the official Git repository (https://github.com/symfony/Console). -.. note:: - - Windows does not support ANSI colors by default so the Console component detects and - disables colors where Windows does not have support. However, if Windows is not - configured with an ANSI driver and your console commands invoke other scripts which - emit ANSI color sequences, they will be shown as raw escape characters. - - To enable ANSI color support for Windows, please install `ANSICON`_. - Creating a basic Command ------------------------ @@ -124,6 +115,14 @@ This prints:: Coloring the Output ~~~~~~~~~~~~~~~~~~~ +.. note:: + + By default, Windows command console doesn't support output coloring. The + Console component disables output coloring for Windows systems, but if your + commands invoke other scripts which emit color sequences, they will be + wrongly displayed as raw escape characters. Install the free `ANSICON`_ + application to add coloring support to your Windows command console. + Whenever you output text, you can surround the text with tags to color its output. For example:: From 71f30a27d1ba1b42a082ced08fded04fbf2c9ef3 Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Fri, 20 Feb 2015 14:19:43 +0100 Subject: [PATCH 2/3] Minor rewording --- components/console/introduction.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/console/introduction.rst b/components/console/introduction.rst index 1557854e7ca..50eb7534d2e 100644 --- a/components/console/introduction.rst +++ b/components/console/introduction.rst @@ -117,7 +117,7 @@ Coloring the Output .. note:: - By default, Windows command console doesn't support output coloring. The + By default, the Windows command console doesn't support output coloring. The Console component disables output coloring for Windows systems, but if your commands invoke other scripts which emit color sequences, they will be wrongly displayed as raw escape characters. Install the free `ANSICON`_ From ec85112e51fecb7881a5e13c125ac33a29fc9d3e Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Fri, 20 Feb 2015 15:37:22 +0100 Subject: [PATCH 3/3] Suggested ConEmu in addition to ANSICON to solve the Windows coloring limitation --- components/console/introduction.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/components/console/introduction.rst b/components/console/introduction.rst index 50eb7534d2e..6dd5dba52eb 100644 --- a/components/console/introduction.rst +++ b/components/console/introduction.rst @@ -120,8 +120,8 @@ Coloring the Output By default, the Windows command console doesn't support output coloring. The Console component disables output coloring for Windows systems, but if your commands invoke other scripts which emit color sequences, they will be - wrongly displayed as raw escape characters. Install the free `ANSICON`_ - application to add coloring support to your Windows command console. + wrongly displayed as raw escape characters. Install the `ConEmu`_ or `ANSICON`_ + free applications to add coloring support to your Windows command console. Whenever you output text, you can surround the text with tags to color its output. For example:: @@ -503,4 +503,5 @@ Learn More! * :doc:`/components/console/console_arguments` .. _Packagist: https://packagist.org/packages/symfony/console +.. _ConEmu: https://code.google.com/p/conemu-maximus5/ .. _ANSICON: https://github.com/adoxa/ansicon/releases