summaryrefslogtreecommitdiff
path: root/devdocs/gnu_make/terminal-output.html
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
committerCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
commit82ba818ff456bcd6d56a06226e3f27e98fbb55c3 (patch)
tree158cfc17b2f644a10f063cb546752cfaae12c97f /devdocs/gnu_make/terminal-output.html
parent9278ddd4ea1a8b1a4c1edaa8894516e3f48d245b (diff)
downloaddotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.tar.gz
dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.zip
removing all downloaded devdocs files
Diffstat (limited to 'devdocs/gnu_make/terminal-output.html')
-rw-r--r--devdocs/gnu_make/terminal-output.html6
1 files changed, 0 insertions, 6 deletions
diff --git a/devdocs/gnu_make/terminal-output.html b/devdocs/gnu_make/terminal-output.html
deleted file mode 100644
index 60188e81..00000000
--- a/devdocs/gnu_make/terminal-output.html
+++ /dev/null
@@ -1,6 +0,0 @@
- <h1 class="section">Synchronized Terminal Output</h1> <p>Normally GNU <code>make</code> will invoke all commands with access to the same standard and error outputs that <code>make</code> itself was started with. A number of tools will detect whether the output is a terminal or not-a-terminal, and use this information to change the output style. For example if the output goes to a terminal the tool may add control characters that set color, or even change the location of the cursor. If the output is not going to a terminal then these special control characters are not emitted so that they don’t corrupt log files, etc. </p> <p>The <code>--output-sync</code> (see <a href="parallel-output">Output During Parallel Execution</a>) option will defeat the terminal detection. When output synchronization is enabled GNU <code>make</code> arranges for all command output to be written to a file, so that its output can be written as a block without interference from other commands. This means that all tools invoked by <code>make</code> will believe that their output is not going to be displayed on a terminal, even when it will be (because <code>make</code> will display it there after the command is completed). </p> <p>In order to facilitate tools which would like to determine whether or not their output will be displayed on a terminal, GNU <code>make</code> will set the <code>MAKE_TERMOUT</code> and <code>MAKE_TERMERR</code> environment variables before invoking any commands. Tools which would like to determine whether standard or error output (respectively) will be displayed on a terminal can check these environment variables to determine if they exist and contain a non-empty value. If so the tool can assume that the output will (eventually) be displayed on a terminal. If the variables are not set or have an empty value, then the tool should fall back to its normal methods of detecting whether output is going to a terminal or not. </p> <p>The content of the variables can be parsed to determine the type of terminal which will be used to display the output. </p> <p>Similarly, environments which invoke <code>make</code> and would like to capture the output and eventually display it on a terminal (or some display which can interpret terminal control characters) can set these variables before invoking <code>make</code>. GNU <code>make</code> will not modify these environment variables if they already exist when it starts. </p><div class="_attribution">
- <p class="_attribution-p">
- Copyright © 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022 Free Software Foundation, Inc. <br>Licensed under the GNU Free Documentation License.<br>
- <a href="https://www.gnu.org/software/make/manual/html_node/Terminal-Output.html" class="_attribution-link">https://www.gnu.org/software/make/manual/html_node/Terminal-Output.html</a>
- </p>
-</div>