summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorHasan Ramezani <hasan.r67@gmail.com>2018-07-22 21:41:47 +0430
committerTim Graham <timograham@gmail.com>2018-09-11 11:15:42 -0400
commit5195b99e2c3804ec5f9c98d29e0cf76bf44b0cec (patch)
tree308f211170a1180c40ce33adac835fe040825fcc /docs
parentde8eb07c7ae619e42781c9c0adecb521cdc3a353 (diff)
Fixed #29560 -- Added --force-color management command option.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/django-admin.txt10
-rw-r--r--docs/releases/2.2.txt3
2 files changed, 11 insertions, 2 deletions
diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
index 408c39055e..f1ebc24ee6 100644
--- a/docs/ref/django-admin.txt
+++ b/docs/ref/django-admin.txt
@@ -1657,6 +1657,14 @@ Example usage::
django-admin runserver --no-color
+.. django-admin-option:: --force-color
+
+.. versionadded:: 2.2
+
+Forces colorization of the command output if it would otherwise be disabled
+as discussed in :ref:`syntax-coloring`. For example, you may want to pipe
+colored output to another command.
+
Extra niceties
==============
@@ -1668,7 +1676,7 @@ Syntax coloring
The ``django-admin`` / ``manage.py`` commands will use pretty
color-coded output if your terminal supports ANSI-colored output. It
won't use the color codes if you're piping the command's output to
-another program.
+another program unless the :option:`--force-color` option is used.
Under Windows, the native console doesn't support ANSI escape sequences so by
default there is no color output. But you can install the `ANSICON`_
diff --git a/docs/releases/2.2.txt b/docs/releases/2.2.txt
index 2709344de0..af2910a514 100644
--- a/docs/releases/2.2.txt
+++ b/docs/releases/2.2.txt
@@ -170,7 +170,8 @@ Internationalization
Management Commands
~~~~~~~~~~~~~~~~~~~
-* ...
+* The new :option:`--force-color` option forces colorization of the command
+ output.
Migrations
~~~~~~~~~~