;help/manuals

hledger/Hledger/Cli/Commands/Balance.txt

@@ -129,10 +129,8 @@ Some example formats:
 
 Colour support
 
-The balance command shows negative amounts in red, if:
-
--   the TERM environment variable is not set to dumb
--   the output is not being redirected or piped anywhere
+In terminal output, when colour is enabled, the balance command shows
+negative amounts in red.
 
 Flat mode
 
@@ -303,7 +301,7 @@ multicommodity reports.
 
 When the report is still too wide, a good workaround is to pipe it into
 less -RS (-R for colour, -S to chop long lines). Eg:
-hledger bal -D | less -RS.
+hledger bal -D --color=yes | less -RS.
 
 Budget report
 

hledger/hledger.1

@@ -2750,11 +2750,8 @@ rendered on one line
 for the single-column balance report
 .SS Colour support
 .PP
-The balance command shows negative amounts in red, if:
-.IP \[bu] 2
-the \f[C]TERM\f[R] environment variable is not set to \f[C]dumb\f[R]
-.IP \[bu] 2
-the output is not being redirected or piped anywhere
+In terminal output, when colour is enabled, the balance command shows
+negative amounts in red.
 .SS Flat mode
 .PP
 To see a flat list instead of the default hierarchical display, use
@@ -2966,7 +2963,7 @@ the width of multicommodity reports.
 .PP
 When the report is still too wide, a good workaround is to pipe it into
 \f[C]less -RS\f[R] (-R for colour, -S to chop long lines).
-Eg: \f[C]hledger bal -D | less -RS\f[R].
+Eg: \f[C]hledger bal -D --color=yes | less -RS\f[R].
 .SS Budget report
 .PP
 With \f[C]--budget\f[R], extra columns are displayed showing budget
@@ -4507,9 +4504,6 @@ bin/ directory.
 These are typically prototypes and not guaranteed to work.
 .SH ENVIRONMENT
 .PP
-\f[B]COLUMNS\f[R] The screen width used by the register command.
-Default: the full terminal width.
-.PP
 \f[B]LEDGER_FILE\f[R] The journal file path when not specified with
 \f[C]-f\f[R].
 Default: \f[C]\[ti]/.hledger.journal\f[R] (on windows, perhaps
@@ -4535,6 +4529,13 @@ file containing
 .fi
 .PP
 To see the effect you may need to \f[C]killall Dock\f[R], or reboot.
+.PP
+\f[B]COLUMNS\f[R] The screen width used by the register command.
+Default: the full terminal width.
+.PP
+\f[B]NO_COLOR\f[R] If this variable exists with any value, hledger will
+not use ANSI color codes in terminal output.
+This overrides the --color/--colour option.
 .SH FILES
 .PP
 Reads data from one or more files in hledger journal, timeclock,

hledger/hledger.info

@@ -2283,10 +2283,8 @@ File: hledger.info,  Node: Colour support,  Next: Flat mode,  Prev: Customising
 3.5.3 Colour support
 --------------------
 
-The balance command shows negative amounts in red, if:
-
-   * the 'TERM' environment variable is not set to 'dumb'
-   * the output is not being redirected or piped anywhere
+In terminal output, when colour is enabled, the balance command shows
+negative amounts in red.
 
 
 File: hledger.info,  Node: Flat mode,  Next: Depth limited balance reports,  Prev: Colour support,  Up: balance
@@ -2474,7 +2472,7 @@ width of multicommodity reports.
 
    When the report is still too wide, a good workaround is to pipe it
 into 'less -RS' (-R for colour, -S to chop long lines).  Eg: 'hledger
-bal -D | less -RS'.
+bal -D --color=yes | less -RS'.
 
 
 File: hledger.info,  Node: Budget report,  Next: ,  Prev: Multicolumn balance report,  Up: balance
@@ -3885,10 +3883,7 @@ File: hledger.info,  Node: ENVIRONMENT,  Next: FILES,  Prev: COMMANDS,  Up: Top
 4 ENVIRONMENT
 *************
 
-*COLUMNS* The screen width used by the register command.  Default: the
-full terminal width.
-
-   *LEDGER_FILE* The journal file path when not specified with '-f'.
+*LEDGER_FILE* The journal file path when not specified with '-f'.
 Default: '~/.hledger.journal' (on windows, perhaps
 'C:/Users/USER/.hledger.journal').
 
@@ -3908,6 +3903,13 @@ a more thorough way that also affects applications started from the GUI
 
    To see the effect you may need to 'killall Dock', or reboot.
 
+   *COLUMNS* The screen width used by the register command.  Default:
+the full terminal width.
+
+   *NO_COLOR* If this variable exists with any value, hledger will not
+use ANSI color codes in terminal output.  This overrides the
+-color/-colour option.
+
 
 File: hledger.info,  Node: FILES,  Next: LIMITATIONS,  Prev: ENVIRONMENT,  Up: Top
 
@@ -4126,101 +4128,101 @@ Node: Customising the classic balance report75687
 Ref: #customising-the-classic-balance-report75915
 Node: Colour support77991
 Ref: #colour-support78158
-Node: Flat mode78331
-Ref: #flat-mode78479
-Node: Depth limited balance reports78892
-Ref: #depth-limited-balance-reports79077
-Node: Percentages79533
-Ref: #percentages79699
-Node: Multicolumn balance report80836
-Ref: #multicolumn-balance-report81016
-Node: Budget report86601
-Ref: #budget-report86744
-Node: Nested budgets92010
-Ref: #nested-budgets92122
-Ref: #output-format-295603
-Node: balancesheet95800
-Ref: #balancesheet95936
-Node: balancesheetequity97402
-Ref: #balancesheetequity97551
-Node: cashflow98274
-Ref: #cashflow98402
-Node: check-dates99581
-Ref: #check-dates99708
-Node: check-dupes99987
-Ref: #check-dupes100113
-Node: close100406
-Ref: #close100514
-Node: close usage102036
-Ref: #close-usage102129
-Node: codes104942
-Ref: #codes105050
-Node: commodities105762
-Ref: #commodities105889
-Node: descriptions105971
-Ref: #descriptions106099
-Node: diff106403
-Ref: #diff106509
-Node: files107556
-Ref: #files107656
-Node: help107803
-Ref: #help107903
-Node: import108984
-Ref: #import109098
-Node: Importing balance assignments109991
-Ref: #importing-balance-assignments110139
-Node: incomestatement110788
-Ref: #incomestatement110921
-Node: notes112408
-Ref: #notes112521
-Node: payees112889
-Ref: #payees112995
-Node: prices113415
-Ref: #prices113521
-Node: print113862
-Ref: #print113972
-Node: print-unique118768
-Ref: #print-unique118894
-Node: register119179
-Ref: #register119306
-Node: Custom register output123478
-Ref: #custom-register-output123607
-Node: register-match124944
-Ref: #register-match125078
-Node: rewrite125429
-Ref: #rewrite125544
-Node: Re-write rules in a file127399
-Ref: #re-write-rules-in-a-file127533
-Node: Diff output format128743
-Ref: #diff-output-format128912
-Node: rewrite vs print --auto130004
-Ref: #rewrite-vs.-print---auto130183
-Node: roi130739
-Ref: #roi130837
-Node: stats131849
-Ref: #stats131948
-Node: tags132736
-Ref: #tags132834
-Node: test133353
-Ref: #test133461
-Node: Add-on commands134208
-Ref: #add-on-commands134325
-Node: ui135668
-Ref: #ui135756
-Node: web135810
-Ref: #web135913
-Node: iadd136029
-Ref: #iadd136140
-Node: interest136222
-Ref: #interest136329
-Node: ENVIRONMENT136569
-Ref: #environment136681
-Node: FILES137510
-Ref: #files-1137613
-Node: LIMITATIONS137826
-Ref: #limitations137945
-Node: TROUBLESHOOTING138687
-Ref: #troubleshooting138800
+Node: Flat mode78254
+Ref: #flat-mode78402
+Node: Depth limited balance reports78815
+Ref: #depth-limited-balance-reports79000
+Node: Percentages79456
+Ref: #percentages79622
+Node: Multicolumn balance report80759
+Ref: #multicolumn-balance-report80939
+Node: Budget report86536
+Ref: #budget-report86679
+Node: Nested budgets91945
+Ref: #nested-budgets92057
+Ref: #output-format-295538
+Node: balancesheet95735
+Ref: #balancesheet95871
+Node: balancesheetequity97337
+Ref: #balancesheetequity97486
+Node: cashflow98209
+Ref: #cashflow98337
+Node: check-dates99516
+Ref: #check-dates99643
+Node: check-dupes99922
+Ref: #check-dupes100048
+Node: close100341
+Ref: #close100449
+Node: close usage101971
+Ref: #close-usage102064
+Node: codes104877
+Ref: #codes104985
+Node: commodities105697
+Ref: #commodities105824
+Node: descriptions105906
+Ref: #descriptions106034
+Node: diff106338
+Ref: #diff106444
+Node: files107491
+Ref: #files107591
+Node: help107738
+Ref: #help107838
+Node: import108919
+Ref: #import109033
+Node: Importing balance assignments109926
+Ref: #importing-balance-assignments110074
+Node: incomestatement110723
+Ref: #incomestatement110856
+Node: notes112343
+Ref: #notes112456
+Node: payees112824
+Ref: #payees112930
+Node: prices113350
+Ref: #prices113456
+Node: print113797
+Ref: #print113907
+Node: print-unique118703
+Ref: #print-unique118829
+Node: register119114
+Ref: #register119241
+Node: Custom register output123413
+Ref: #custom-register-output123542
+Node: register-match124879
+Ref: #register-match125013
+Node: rewrite125364
+Ref: #rewrite125479
+Node: Re-write rules in a file127334
+Ref: #re-write-rules-in-a-file127468
+Node: Diff output format128678
+Ref: #diff-output-format128847
+Node: rewrite vs print --auto129939
+Ref: #rewrite-vs.-print---auto130118
+Node: roi130674
+Ref: #roi130772
+Node: stats131784
+Ref: #stats131883
+Node: tags132671
+Ref: #tags132769
+Node: test133288
+Ref: #test133396
+Node: Add-on commands134143
+Ref: #add-on-commands134260
+Node: ui135603
+Ref: #ui135691
+Node: web135745
+Ref: #web135848
+Node: iadd135964
+Ref: #iadd136075
+Node: interest136157
+Ref: #interest136264
+Node: ENVIRONMENT136504
+Ref: #environment136616
+Node: FILES137601
+Ref: #files-1137704
+Node: LIMITATIONS137917
+Ref: #limitations138036
+Node: TROUBLESHOOTING138778
+Ref: #troubleshooting138891
 
 End Tag Table