Skip to content

Reworded the note about Windows console and output coloring #5031

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Mar 14, 2015
Merged

Reworded the note about Windows console and output coloring #5031

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
59624f6
Reworded the note about Windows console and output coloring
javiereguiluz Feb 20, 2015
71f30a2
Minor rewording
javiereguiluz Feb 20, 2015
ec85112
Suggested ConEmu in addition to ANSICON to solve the Windows coloring…
javiereguiluz Feb 20, 2015
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions components/console/introduction.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,15 +20,6 @@ You can install the component in 2 different ways:
* :doc:`Install it via Composer </components/using_components>` (``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
------------------------

Expand Down Expand Up @@ -124,6 +115,14 @@ This prints::
Coloring the Output
~~~~~~~~~~~~~~~~~~~

.. note::

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 `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::

Expand Down Expand Up @@ -504,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