Quick explanatory comment

serilog · Jun 18, 2017 · 6ecc782 · 6ecc782
1 parent dc5ac47
commit 6ecc782
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/src/Serilog.Sinks.Console/Sinks/SystemConsole/ConsoleSink.cs b/src/Serilog.Sinks.Console/Sinks/SystemConsole/ConsoleSink.cs
@@ -51,6 +51,9 @@ public void Emit(LogEvent logEvent)
         {
             var output = SelectOutputStream(logEvent.Level);
 
+            // ANSI escape codes can be pre-rendered into a buffer; however, if we're on Windows and
+            // using its console coloring APIs, the color switches would happen during the off-screen
+            // buffered write here and have no effect when the line is actually written out.
             if (_theme.CanBuffer)
             {
                 var buffer = new StringWriter(new StringBuilder(DefaultWriteBuffer));