From: Johannes Sixt <j6t@kdbg.org>
Date: Fri, 27 Nov 2009 07:42:25 +0000 (+0100)
Subject: Add a notice that only certain functions can print color escape codes
X-Git-Tag: v1.6.6-rc1~26
X-Git-Url: https://git.lorimer.id.au/gitweb.git/diff_plain/e7821d73bd0256bfc15c48945beded063e17c1b6

Add a notice that only certain functions can print color escape codes

We emulate color escape codes on Windows by overriding printf, fprintf,
and fputs. Warn developers that these are the only functions that can be
used to print them.

Signed-off-by: Johannes Sixt <j6t@kdbg.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
---

diff --git a/color.h b/color.h
index 7d8da6fe22..3cb4b7fc89 100644
--- a/color.h
+++ b/color.h
@@ -4,6 +4,11 @@
 /* "\033[1;38;5;2xx;48;5;2xxm\0" is 23 bytes */
 #define COLOR_MAXLEN 24
 
+/*
+ * IMPORTANT: Due to the way these color codes are emulated on Windows,
+ * write them only using printf(), fprintf(), and fputs(). In particular,
+ * do not use puts() or write().
+ */
 #define GIT_COLOR_NORMAL	""
 #define GIT_COLOR_RESET		"\033[m"
 #define GIT_COLOR_BOLD		"\033[1m"