glossary: add TSOs

- required to land #95

Author: doyougnu

conf.py

@@ -61,6 +61,7 @@
 extlinks = {'userGuide': ('https://downloads.haskell.org/~ghc/9.2.4/docs/html/users_guide/%s', '%s'),
             'ghcWiki': ('https://gitlab.haskell.org/ghc/ghc/wikis/%s', '#%s'),
             'haskellPerf': ('https://github.com/haskell-perf/%s', '%s'),
+            'ghcSource': ('https://gitlab.haskell.org/ghc/ghc/-/blob/master/%s', '#%s')
             }
 
 # prolog for colored text and global variables

src/glossary.rst

@@ -377,6 +377,15 @@ Glossary
       provides Haskell's laziness. See :cite:t:`SpinelessTaglessGMachine`
       Section 3.1.2 for more details.
 
+   Thread State Object (TSO)
+
+      A thread state object is a heap object that represents a Haskell thread in
+      GHC's runtime system. For the precise contents please see its definition
+      in :ghcSource:`GHC's source code
+      <rts/include/rts/storage/TSO.h?ref_type=heads>` and `this description
+      <https://youtu.be/5vKBFnTsCcE?si=4THBS_KMYRI6U1Sm&t=4620>`__ by Ben
+      Gamari.
+
    Top-Level
 
       The most outer-most or global scope of the program.