diff --git a/NEWS b/NEWS index db1f32f73c..c7c4548728 100644 --- a/NEWS +++ b/NEWS @@ -31,6 +31,12 @@ CHANGES WITH 260 in spe: rather than the first, to keep these options coherent with other unit settings. + Changes in other components: + + * New options SYSTEMD_COLORS=auto-16 and SYSTEMD_COLORS=auto-256, which + are like SYSTEMD_COLORS=16 and SYSTEMD_COLORS=256 respectively when + output is to a non-dumb TTY, and like SYSTEMD_COLORS=no otherwise. + CHANGES WITH 259: Announcements of Future Feature Removals and Incompatible Changes: diff --git a/man/common-variables.xml b/man/common-variables.xml index 991946f60d..93f18d453e 100644 --- a/man/common-variables.xml +++ b/man/common-variables.xml @@ -224,11 +224,40 @@ $SYSTEMD_COLORS - Takes a boolean argument. When true, systemd and related utilities - will use colors in their output, otherwise the output will be monochrome. Additionally, the variable can - take one of the following special values: 16, 256 to restrict the use - of colors to the base 16 or 256 ANSI colors, respectively. This can be specified to override the automatic - decision based on $TERM and what the console is connected to. + + Takes a boolean argument, or a special value. + + + + + The default. systemd and related utilities will use colors in + their output if possible. Same as auto-24bit if $COLORTERM + is set to truecolor or 24bit; same as + auto-256 otherwise. + + + + + The output will be monochrome. + + + + 16 + 256 + 24bit + Always use the base 16 ANSI colors, 256 colors, or 24 bit color, + respectively. + + + + auto-16 + auto-256 + auto-24bit + Use the given quantity of colours, subject to $TERM, and what + the console is connected to. + + +