summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorSteven Shaw <steven@steshaw.org>2017-12-19 07:35:44 +1000
committerBen Gamari <ben@smart-cactus.org>2018-01-02 15:55:11 -0500
commit12f5c00543e1f3dc7109e3575fcc4a973aebdacc (patch)
treef92d9f228d9ea7c0e71f8155ca4d3c1f4afb22f8 /docs
parentb31c7214b7ccf31b6a78faac1a3cc5c39cdff56d (diff)
downloadhaskell-12f5c00543e1f3dc7109e3575fcc4a973aebdacc.tar.gz
Prevent "C--" translating to "C–" in the User's Guide.
i.e. escape "--" so that it doesn't translate to an "en dash".
Diffstat (limited to 'docs')
-rw-r--r--docs/users_guide/debug-info.rst4
-rw-r--r--docs/users_guide/debugging.rst68
-rw-r--r--docs/users_guide/extending_ghc.rst2
3 files changed, 37 insertions, 37 deletions
diff --git a/docs/users_guide/debug-info.rst b/docs/users_guide/debug-info.rst
index 915591a6ec..aca3733535 100644
--- a/docs/users_guide/debug-info.rst
+++ b/docs/users_guide/debug-info.rst
@@ -268,10 +268,10 @@ GHC may produce the following standard DIEs in the ``.debug_info`` section,
Represents a compilation unit (e.g. a Haskell module).
``DW_TAG_subprogram``
- Represents a C-- top-level basic block.
+ Represents a C-\\- top-level basic block.
``DW_TAG_lexical_block``
- Represents a C-- basic block. Note that this is a slight departure from the
+ Represents a C-\\- basic block. Note that this is a slight departure from the
intended meaning of this DIE type as it does not necessarily reflect
lexical scope in the source program.
diff --git a/docs/users_guide/debugging.rst b/docs/users_guide/debugging.rst
index d0f479cbb1..efa6e2808d 100644
--- a/docs/users_guide/debugging.rst
+++ b/docs/users_guide/debugging.rst
@@ -352,90 +352,90 @@ These flags dump various phases of GHC's STG pipeline.
Show the output of the intermediate STG-to-STG pass. (*lots* of output!)
-C-- representation
-~~~~~~~~~~~~~~~~~~
+C-\\- representation
+~~~~~~~~~~~~~~~~~~~~
-These flags dump various phases of GHC's C-- pipeline.
+These flags dump various phases of GHC's C-\\- pipeline.
.. ghc-flag:: -ddump-cmm-verbose
- :shortdesc: Show output from each C-- pipeline pass
+ :shortdesc: Show output from each C-\\- pipeline pass
:type: dynamic
- Dump output from all C-- pipeline stages. In case of
+ Dump output from all C-\\- pipeline stages. In case of
``.cmm`` compilation this also dumps the result of
file parsing.
.. ghc-flag:: -ddump-cmm-from-stg
- :shortdesc: Dump STG-to-C-- output
+ :shortdesc: Dump STG-to-C-\\- output
:type: dynamic
- Dump the result of STG-to-C-- conversion
+ Dump the result of STG-to-C-\\- conversion
.. ghc-flag:: -ddump-cmm-raw
- :shortdesc: Dump raw C--
+ :shortdesc: Dump raw C-\\-
:type: dynamic
- Dump the “raw” C--.
+ Dump the “raw” C-\\-.
.. ghc-flag:: -ddump-cmm-cfg
- :shortdesc: Dump the results of the C-- control flow optimisation pass.
+ :shortdesc: Dump the results of the C-\\- control flow optimisation pass.
:type: dynamic
- Dump the results of the C-- control flow optimisation pass.
+ Dump the results of the C-\\- control flow optimisation pass.
.. ghc-flag:: -ddump-cmm-cbe
:shortdesc: Dump the results of common block elimination
:type: dynamic
- Dump the results of the C-- Common Block Elimination (CBE) pass.
+ Dump the results of the C-\\- Common Block Elimination (CBE) pass.
.. ghc-flag:: -ddump-cmm-switch
:shortdesc: Dump the results of switch lowering passes
:type: dynamic
- Dump the results of the C-- switch lowering pass.
+ Dump the results of the C-\\- switch lowering pass.
.. ghc-flag:: -ddump-cmm-proc
:shortdesc: Dump the results of proc-point analysis
:type: dynamic
- Dump the results of the C-- proc-point analysis pass.
+ Dump the results of the C-\\- proc-point analysis pass.
.. ghc-flag:: -ddump-cmm-sp
- :shortdesc: Dump the results of the C-- stack layout pass.
+ :shortdesc: Dump the results of the C-\\- stack layout pass.
:type: dynamic
- Dump the results of the C-- stack layout pass.
+ Dump the results of the C-\\- stack layout pass.
.. ghc-flag:: -ddump-cmm-sink
- :shortdesc: Dump the results of the C-- sinking pass.
+ :shortdesc: Dump the results of the C-\\- sinking pass.
:type: dynamic
- Dump the results of the C-- sinking pass.
+ Dump the results of the C-\\- sinking pass.
.. ghc-flag:: -ddump-cmm-caf
- :shortdesc: Dump the results of the C-- CAF analysis pass.
+ :shortdesc: Dump the results of the C-\\- CAF analysis pass.
:type: dynamic
- Dump the results of the C-- CAF analysis pass.
+ Dump the results of the C-\\- CAF analysis pass.
.. ghc-flag:: -ddump-cmm-procmap
- :shortdesc: Dump the results of the C-- proc-point map pass.
+ :shortdesc: Dump the results of the C-\\- proc-point map pass.
:type: dynamic
- Dump the results of the C-- proc-point map pass.
+ Dump the results of the C-\\- proc-point map pass.
.. ghc-flag:: -ddump-cmm-split
- :shortdesc: Dump the results of the C-- proc-point splitting pass.
+ :shortdesc: Dump the results of the C-\\- proc-point splitting pass.
:type: dynamic
- Dump the results of the C-- proc-point splitting pass.
+ Dump the results of the C-\\- proc-point splitting pass.
.. ghc-flag:: -ddump-cmm-info
- :shortdesc: Dump the results of the C-- info table augmentation pass.
+ :shortdesc: Dump the results of the C-\\- info table augmentation pass.
:type: dynamic
- Dump the results of the C-- info table augmentation pass.
+ Dump the results of the C-\\- info table augmentation pass.
.. ghc-flag:: -ddump-cmm-cps
:shortdesc: Dump the results of the CPS pass
@@ -444,10 +444,10 @@ These flags dump various phases of GHC's C-- pipeline.
Dump the results of the CPS pass.
.. ghc-flag:: -ddump-cmm
- :shortdesc: Dump the final C-- output
+ :shortdesc: Dump the final C-\\- output
:type: dynamic
- Dump the result of the C-- pipeline processing
+ Dump the result of the C-\\- pipeline processing
@@ -466,20 +466,20 @@ Native code generator
~~~~~~~~~~~~~~~~~~~~~
These flags dump various stages of the :ref:`native code generator's
-<native-code-gen>` pipeline, which starts with C-- and produces native
+<native-code-gen>` pipeline, which starts with C-\\- and produces native
assembler.
.. ghc-flag:: -ddump-opt-cmm
- :shortdesc: Dump the results of C-- to C-- optimising passes
+ :shortdesc: Dump the results of C-\\- to C-\\- optimising passes
:type: dynamic
- Dump the results of C-- to C-- optimising passes performed by the NCG.
+ Dump the results of C-\\- to C-\\- optimising passes performed by the NCG.
.. ghc-flag:: -ddump-asm-native
:shortdesc: Dump initial assembly
:type: dynamic
- Dump the initial assembler output produced from C--.
+ Dump the initial assembler output produced from C-\\-.
.. ghc-flag:: -ddump-asm-liveness
:shortdesc: Dump assembly augmented with register liveness
@@ -700,10 +700,10 @@ Checking for consistency
Ditto for STG level. (note: currently doesn't work).
.. ghc-flag:: -dcmm-lint
- :shortdesc: C-- pass sanity checking
+ :shortdesc: C-\\- pass sanity checking
:type: dynamic
- Ditto for C-- level.
+ Ditto for C-\\- level.
.. ghc-flag:: -fllvm-fill-undef-with-garbage
:shortdesc: Intruct LLVM to fill dead STG registers with garbage
diff --git a/docs/users_guide/extending_ghc.rst b/docs/users_guide/extending_ghc.rst
index 8af5989022..e49effbd29 100644
--- a/docs/users_guide/extending_ghc.rst
+++ b/docs/users_guide/extending_ghc.rst
@@ -179,7 +179,7 @@ GHC's intermediate language, Core. Plugins are suitable for experimental
analysis or optimization, and require no changes to GHC's source code to
use.
-Plugins cannot optimize/inspect C--, nor can they implement things like
+Plugins cannot optimize/inspect C-\\-, nor can they implement things like
parser/front-end modifications like GCC, apart from limited changes to
the constraint solver. If you feel strongly that any of these
restrictions are too onerous,