users-guide: Disable syntax highlighting
authorTakenobu Tani <takenobu.hs@gmail.com>
Fri, 7 Sep 2018 14:02:39 +0000 (16:02 +0200)
committerKrzysztof Gogolewski <krz.gogolewski@gmail.com>
Fri, 7 Sep 2018 14:09:38 +0000 (16:09 +0200)
Summary:
I disabled syntax highlighting for NumericUnderscores extension.

Because pygments does not yet correspond to syntax rule for NumericUnderscores.
(Sphinx uses pygments as the syntax highlighting.)

I've sent a pull-request to pygments project[1].
But development of pygments has been suspended since 2017 March.

[1]: https://bitbucket.org/birkenfeld/pygments-main/pull-requests/
       745/fix-haskell-lexer-for-numeric-literals/diff

[ci skip]

Test Plan: build

Reviewers: bgamari, monoidal

Reviewed By: monoidal

Subscribers: rwbarton, carter

Differential Revision: https://phabricator.haskell.org/D5120

docs/users_guide/glasgow_exts.rst

index ead020c..a1a5b1f 100644 (file)
@@ -585,7 +585,9 @@ That is, underscores in numeric literals are ignored when
 :extension:`NumericUnderscores` is enabled.
 See also :ghc-ticket:`14473`.
 
-For example: ::
+For example:
+
+.. code-block:: none
 
     -- decimal
     million    = 1_000_000
@@ -617,7 +619,9 @@ For example: ::
 
     test8bit x = (0b01_0000_0000 .&. x) /= 0
 
-About validity: ::
+About validity:
+
+.. code-block:: none
 
     x0 = 1_000_000   -- valid
     x1 = 1__000000   -- valid