prelim: add how to debug chapter

Author: doyougnu

index.rst

@@ -26,6 +26,10 @@ by `Input Output Global <https://iohk.io/>`_.
 Release History
 ---------------
 
+* February, 2024
+
+  * :ref:`How to Debug <How To Debug chapter>` first draft finished.
+
 * March/April, 2023
 
   * :ref:`Klister Case Study <klister case study>` first draft finished.

src/Measurement_Observation/Binary_Profiling/valgrind.rst

@@ -1,4 +1,4 @@
-.. Valgrind
+.. _Valgrind Chapter:
 
 :lightgrey:`Valgrind`
 =====================

src/Measurement_Observation/Haskell_Profiling/eventlog.rst

@@ -55,15 +55,15 @@ define and track their own events using the base functions `traceEvent
 When should I use Eventlog
 --------------------------
 
-Eventlog is most useful when you need to :ref:`Characterize the Problem
-<characterize-the-problem>`. It yields runtime information on the specific
-sub-system the program relies on. Thus, it allows you to drill down into the
-behavior of the garbage collector, the scheduler, the heap and so. For example,
-using the flag ``+RTS -lg`` you can collect the ``CONC_MARK_BEGIN`` and
-``CONC_MARK_END`` events which log the beginning and end of the concurrent
-garbage collectors marking phase. Similarly, you can collect ``MEM_RETURN``
-which provides information about the current allocation of megablocks, attempts
-to return them to the operating system, and heap fragmentation.
+Eventlog is most useful when you need to characterize the problem. It yields
+runtime information on the specific sub-system the program relies on. Thus, it
+allows you to drill down into the behavior of the garbage collector, the
+scheduler, the heap and so. For example, using the flag ``+RTS -lg`` you can
+collect the ``CONC_MARK_BEGIN`` and ``CONC_MARK_END`` events which log the
+beginning and end of the concurrent garbage collectors marking phase. Similarly,
+you can collect ``MEM_RETURN`` which provides information about the current
+allocation of megablocks, attempts to return them to the operating system, and
+heap fragmentation.
 
 
 The Running Example

src/Measurement_Observation/Stg_RTS_Profiling/ghc_debug.rst

@@ -1,4 +1,5 @@
-.. GHC Debug
+.. _GHC Debug Chapter:
+
 
 :lightgrey:`GHC Debug`
 ======================

src/Optimizations/GHC_opt/index.rst

@@ -1,10 +1,12 @@
-Manual GHC Optimizations
-------------------------
+
+.. _GHC Optimizations:
+
+GHC Optimizations
+-----------------
 
 .. toctree::
    :maxdepth: 2
    :glob:
-   :name: Man_GHC_Opts
 
    defunctionalization
    sat_transformation