Document the line number styling changes.fix/1698-lineos-wrapping

1 files changed, 16 insertions, 0 deletions

diff --git a/CHANGES b/CHANGES
index e62bc411..f695acab 100644
--- a/CHANGES
+++ b/CHANGES
@@ -32,6 +32,22 @@ Version 2.8.0
 - Changed setuptools to use a declarative config through ``setup.cfg``.
   Building Pygments now requires setuptools 39.2+.
 - Added markdown to MarkdownLexer aliases (#1687)
+- Changed line number handling
+
+  * In ``<table>`` based output, the ``td.linenos`` element will have either a
+    ``normal`` or ``special`` class attached. Previously, only ``special`` line
+    numbers got a class. This prevents styles from getting applied twice -
+    once via ``<pre>``, once via ``<span class="special">``. This also means
+    that ``td.linenos pre`` is no longer styled, instead, use
+    ``td.linenos .normal`` and ``td.linenos .special``.
+  * In the "inline" style, the DOM element order was changed. The line number
+    is added first, then the line is wrapped is wrapped by the highlighter.
+    This fixes lines not being fully highlighted.
+  * The visual output for inline and non-inline line numbers & highlighting,
+    as well as class-based and inline styling is now consistent.
+  * Line number styles are set to ``background-color: transparent`` and
+    ``color: inherit`` by default. This works much better with dark styles
+    which don't have colors set for line numbers.
 
 
 Version 2.7.4