[[project @ 1998-04-30 20:52:26 by sof]
sof**19980430205232
 Misc additions and fixes
] {
hunk ./ghc/docs/users_guide/debugging.vsgml 87
-<em>Do</em> generate an interface file.  This would normally be used in
-conjunction with @-noC@, which turns off interface generation;
-thus: @-noC -hi@.
+<em>Do</em> generate an interface file (on @stdout@.) This would
+normally be used in conjunction with @-noC@, which turns off interface
+generation; thus: @-noC -hi@.
+
+<tag>@-hi-with-&lt;section&gt;@:</tag>
+<nidx>-hi-with option</nidx>
+Generate just the specified section of an interface file. In case you're
+only interested in a subset of what @-hi@ outputs, @-hi-with-&lt;section&gt;@
+is just the ticket. For instance 
+
+<tscreen> <verb>
+-noC -hi-with-declarations -hi-with-exports
+</verb> </tscreen>
+
+will output the sections containing the exports and the
+declarations. Legal sections are: @declarations@, @exports@,
+@instances@, @instance_modules@, @usages@, @fixities@, and
+@interface@.
hunk ./ghc/docs/users_guide/intro.vsgml 135
-the default output file named @a.out@.
+the default output file named either @a.out@ (*NIX platforms) or @main.exe@
+(Windows port.)
hunk ./ghc/docs/users_guide/intro.vsgml 175
-sending mail to <htmlurl name="majordomo@@dcs.gla.ac.uk"
-url="mailto:majordomo@@dcs.gla.ac.uk">, with a message body (not
+sending mail to <htmlurl name="majordomo@dcs.gla.ac.uk"
+url="mailto:majordomo@dcs.gla.ac.uk">, with a message body (not
hunk ./ghc/docs/users_guide/intro.vsgml 180
-subscribe glasgow-haskell-users MyName <m.y.self@@bigbucks.com> 
+subscribe glasgow-haskell-users MyName <m.y.self@bigbucks.com> 
hunk ./ghc/docs/users_guide/intro.vsgml 186
-name="glasgow-haskell-users@@dcs.gla.ac.uk"
-url="mailto:glasgow-haskell-users@@dcs.gla.ac.uk">.
+name="glasgow-haskell-users@dcs.gla.ac.uk"
+url="mailto:glasgow-haskell-users@dcs.gla.ac.uk">.
hunk ./ghc/docs/users_guide/intro.vsgml 190
-name="glasgow-haskell-users-request@@dcs.gla.ac.uk"
-url="mailto:glasgow-haskell-users-request@@dcs.gla.ac.uk">.  An archive
+name="glasgow-haskell-users-request@dcs.gla.ac.uk"
+url="mailto:glasgow-haskell-users-request@dcs.gla.ac.uk">.  An archive
hunk ./ghc/docs/users_guide/intro.vsgml 201
-Subscribe via <htmlurl name="majordomo@@dcs.gla.ac.uk"
-url="mailto:majordomo@@dcs.gla.ac.uk"> with:
+Subscribe via <htmlurl name="majordomo@dcs.gla.ac.uk"
+url="mailto:majordomo@dcs.gla.ac.uk"> with:
hunk ./ghc/docs/users_guide/intro.vsgml 205
-subscribe glasgow-haskell-bugs My Name <m.y.self@@hackers.r.us>
+subscribe glasgow-haskell-bugs My Name <m.y.self@hackers.r.us>
hunk ./ghc/docs/users_guide/intro.vsgml 209
-name="glasgow-haskell-bugs-request@@dcs.gla.ac.uk"
-url="mailto:glasgow-haskell-bugs-request@@dcs.gla.ac.uk">.
+name="glasgow-haskell-bugs-request@dcs.gla.ac.uk"
+url="mailto:glasgow-haskell-bugs-request@dcs.gla.ac.uk">.
hunk ./ghc/docs/users_guide/intro.vsgml 218
-email to <htmlurl name="majordomo@@dcs.gla.ac.uk"
-url="mailto:majordomo@@dcs.gla.ac.uk">, with the usual message body:
+email to <htmlurl name="majordomo@dcs.gla.ac.uk"
+url="mailto:majordomo@dcs.gla.ac.uk">, with the usual message body:
hunk ./ghc/docs/users_guide/intro.vsgml 222
-subscribe haskell My Name <m.y.self@@fp.rules.ok.org>
+subscribe haskell My Name <m.y.self@fp.rules.ok.org>
hunk ./ghc/docs/users_guide/profiling.vsgml 443
+
+<tag>@-c@</tag> Fill in the bands with colours rather than shades of grey.
+Some people find colour plots easier to read (especially when viewed on a
+non-monochrome medium ;-)
hunk ./ghc/docs/users_guide/user.vsgml 4
-<title>The Glasgow Haskell Compiler User's Guide, Version~3.00
+<title>The Glasgow Haskell Compiler User's Guide, Version~3.02
hunk ./ghc/docs/users_guide/using.vsgml 231
-with @-fshow-import-specs@, for example.  You can instruct GHC to
+with @-dshow-rn-trace@, for example.  You can instruct GHC to
hunk ./ghc/docs/users_guide/using.vsgml 268
-@-fwarn-overlpapping-patterns@, @-fwarn-duplicate-exports@, and
+@-fwarn-overlapping-patterns@, @-fwarn-duplicate-exports@, and
hunk ./ghc/docs/users_guide/using.vsgml 316
+<tag>@-fwarn-hi-shadowing@:</tag> 
+<nidx>-fwarn-hi-shadowing option</nidx>
+<nidx>interface files, shadowing</nidx>
+
+Warns you about shadowing of interface files along the supplied import path.
+For instance, assuming you invoke @ghc@ with the import path
+@-iutils:src@ and @Utils.hi@ exist in both the @utils@ and @src@
+directories, @-fwarn-hi-shadowing@ will warn you that @utils/Utils.hi@
+shadows @src/Utils.hi@.
+
hunk ./ghc/docs/users_guide/using.vsgml 685
-@Makefile@ by hand is rather error-prone.  Don't worry---never fear,
-@mkdependHS@ is here! (and is distributed as part of GHC) Add the
-following to your @Makefile@:
+@Makefile@ by hand is rather error-prone.  @ghc@ offers you a helping
+hand with it's @-M@ option. To automatically generate
+inter-dependencies, add the following to your @Makefile@:
hunk ./ghc/docs/users_guide/using.vsgml 691
-        mkdependHS -- $(HC_OPTS) -- $(SRCS)
+        $(HC) -M $(HC_OPTS) $(SRCS)
hunk ./ghc/docs/users_guide/using.vsgml 696
-@mkdependHS@ will append the needed dependencies to your @Makefile@.
-@mkdependHS@ is fully describe in Section <ref name="Makefile
+@ghc -M@ will then append the needed dependencies to your @Makefile@.
+
+The dependencies are actually generated by another utility,
+@mkdependHS@, which @ghc -M@ just calls upon. @mkdependHS@ is
+distributed with GHC and is documented in Section <ref name="Makefile
}