[Git][ghc/ghc][ghc-9.10] 2 commits: Add release notes entry for GHC proposal 575

[Ben Gamari (@bgamari)]

Ben Gamari pushed to branch ghc-9.10 at Glasgow Haskell Compiler / GHC


Commits:
b9b3b007 by Matthew Craven at 2024-04-15T10:57:59-04:00
Add release notes entry for GHC proposal 575

- - - - -
26b6c7fd by Matthew Craven at 2024-04-15T10:59:17-04:00
Users' guide: Fix base-ref links containing symbols

- - - - -


2 changed files:

- docs/users_guide/9.10.1-notes.rst
- docs/users_guide/conf.py


Changes:

=====================================
docs/users_guide/9.10.1-notes.rst
=====================================
@@ -28,6 +28,12 @@ Language
   compatible, and future releases of GHC may change the default, it is highly
   recommended to specify the language edition explicitly.
 
+- GHC Proposal `#575 <https://github.com/ghc-proposals/ghc-proposals/blob/master/proposals/0575-deprecated-instances.rst>`_
+  has been implemented, allowing ``DEPRECATED`` and ``WARNING``
+  pragmas to be applied to class ``instance`` declarations.
+  Doing so will cause warnings to be emitted whenever such instances are used
+  to solve a constraint.  For details, see :ref:`warning-deprecated-pragma`.
+
 - GHC Proposal `#281 <https://github.com/ghc-proposals/ghc-proposals/blob/master/proposals/0281-visible-forall.rst>`_
   "Visible forall in types of terms" has been partially implemented.
   The following code is now accepted by GHC::


=====================================
docs/users_guide/conf.py
=====================================
@@ -237,6 +237,15 @@ def haddock_role(lib):
             parts = text.split('.')
             module_parts = parts[:-1]
             thing = parts[-1]
+
+            # Escape any symbols in the identifier;
+            # see also Haddock.Utils.makeAnchorId
+            def escapeChar(c):
+                if (c in ':_.') or (c.isascii() and c.isalnum()):
+                    return c
+                return '-%d-' % ord(c)
+            thing = ''.join(escapeChar(c) for c in thing)
+
             if thing != '':
                 # reference to type or identifier
                 tag = 't' if thing[0].isupper() else 'v'



View it on GitLab: https://gitlab.haskell.org/ghc/ghc/-/compare/3b63186da9de818963c40ecb27848d3eb4722513...26b6c7fdaf0ac6c5c68d76922c2339d0cfec6c6e

-- 
View it on GitLab: https://gitlab.haskell.org/ghc/ghc/-/compare/3b63186da9de818963c40ecb27848d3eb4722513...26b6c7fdaf0ac6c5c68d76922c2339d0cfec6c6e
You're receiving this email because of your account on gitlab.haskell.org.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.haskell.org/pipermail/ghc-commits/attachments/20240424/1f2bbbae/attachment-0001.html>