Changes between Version 20 and Version 21 of Commentary/Pipeline

Timestamp:

10/17/06 08:34:47 (7 years ago)

Author:

simonmar

Comment:

--

Commentary/Pipeline

@@ -10 +10 @@
 We start with {{{Foo.hs}}} or {{{Foo.lhs}}}, the "l" specifing whether literate style is being used.
 
- * Run the '''unlit pre-processor''', {{{unlit}}}, to remove the literate markup, generating {{{Foo.lpp}}}.  The {{{unlit}}} processor is a C program kept in {{{utils/unlit}}}.
+ * Run the '''unlit pre-processor''', {{{unlit}}}, to remove the literate markup, generating {{{Foo.lpp}}}.  The {{{unlit}}} processor is a C program kept in [[GhcFile(utils/unlit)]].
 
- * Run the '''C preprocessor''', `cpp`, (if {{{-cpp}}} is specified), generating {{{Foo.cpp}}} or {{{Foo.hspp}}} respectively.
+ * Run the '''C preprocessor''', `cpp`, (if {{{-cpp}}} is specified), generating {{{Foo.hspp}}}.
 
  * Run '''the compiler itself'''. This does not start a separate process; it's just a call to a Haskell function.  This step always generates an [wiki:Commentary/Compiler/IfaceFiles '''interface file'''] {{{Foo.hi}}}, and depending on what flags you give, it also generates a compiled file:
    * Assembly code: flag {{{-S}}}, file {{{Foo.s}}}
-   * C code: flag {{{-fviaC}}}, file {{{Foo.hc}}}
+   * C code: flag {{{-fvia-C}}}, file {{{Foo.hc}}}
    * C-- mode: flag {{{-fcmm}}}, file {{{Foo.cmm}}}, believed not to work
 
-  * In the {{{-fviaC}}} case, run the '''C compiler''', followed by the [wiki:Commentary/EvilMangler Evil Mangler], generating {{{Foo.s}}}
+  * In the {{{-fvia-C}}} case:
+    * Run the '''C compiler''' to generate `Foo.raw_s`.
+    * Run the [wiki:Commentary/EvilMangler Evil Mangler], generating {{{Foo.s}}}
 
-  * If `-fsplit-objs` is in force, run the '''splitter''' on `Foo.s`.  This splits `Foo.s` into lots of small files, `Foo/Foo1.s`, `Foo/Foo2.s`, etc.  The idea is that the static linker will thereby avoid linking dead code.
+  * If `-split-objs` is in force, run the '''splitter''' on `Foo.s`.  This splits `Foo.s` into lots of small files.  The idea is that the static linker will thereby avoid linking dead code.
 
-  * Run the assembler on `Foo.s` or, if `-fsplit-objs` in in force, on each individual assembly file.
-
+  * Run the assembler on `Foo.s` or, if `-split-objs` in in force, on each individual assembly file.