diff options
| author | Ian Lynagh <igloo@earth.li> | 2008-11-28 19:36:33 +0000 |
|---|---|---|
| committer | Ian Lynagh <igloo@earth.li> | 2008-11-28 19:36:33 +0000 |
| commit | 4ca6790feb128b03e0783de7f44399fef5c5ad22 (patch) | |
| tree | ad051ab208d2026fc67e0b3c8a856c51143e6194 /docs/users_guide/separate_compilation.xml | |
| parent | dab87cc9e1269aa7e2e0589e156e024c16b85b1f (diff) | |
| download | haskell-4ca6790feb128b03e0783de7f44399fef5c5ad22.tar.gz | |
Update docs not to talk about deprecated -optdep-* flags; fixes trac #2773
Diffstat (limited to 'docs/users_guide/separate_compilation.xml')
| -rw-r--r-- | docs/users_guide/separate_compilation.xml | 79 |
1 files changed, 11 insertions, 68 deletions
diff --git a/docs/users_guide/separate_compilation.xml b/docs/users_guide/separate_compilation.xml index 727a133655..32dc850e3c 100644 --- a/docs/users_guide/separate_compilation.xml +++ b/docs/users_guide/separate_compilation.xml @@ -1025,15 +1025,7 @@ M.o : X.hi-boot <option>––include-pkg-deps</option> option below).</para> <para>The dependency generation phase of GHC can take some - additional options, which you may find useful. For historical - reasons, each option passed to the dependency generator from - the GHC command line must be preceded by - <literal>-optdep</literal>. For example, to pass <literal>-f - .depend</literal> to the dependency generator, you say - -<screen> -ghc -M -optdep-f -optdep.depend ... -</screen> + additional options, which you may find useful. The options which affect dependency generation are:</para> @@ -1042,15 +1034,7 @@ ghc -M -optdep-f -optdep.depend ... <term><option>-ddump-mod-cycles</option></term> <listitem> <para>Display a list of the cycles in the module graph. This is - useful when trying to eliminate such cycles. You do not need the <literal>-optdep</literal> prefix - for this flag.</para> - </listitem> - </varlistentry> - - <varlistentry> - <term><option>-w</option></term> - <listitem> - <para>Turn off warnings about interface file shadowing.</para> + useful when trying to eliminate such cycles.</para> </listitem> </varlistentry> @@ -1066,14 +1050,14 @@ ghc -M -optdep-f -optdep.depend ... </varlistentry> <varlistentry> - <term><option>-f</option> <replaceable>file</replaceable></term> + <term><option>-dep-makefile</option> <replaceable>file</replaceable></term> <listitem> <para>Use <replaceable>file</replaceable> as the makefile, rather than <filename>makefile</filename> or <filename>Makefile</filename>. If <replaceable>file</replaceable> doesn't exist, <command>mkdependHS</command> creates it. We often use - <option>-f .depend</option> to put the dependencies in + <option>-dep-makefile .depend</option> to put the dependencies in <filename>.depend</filename> and then <command>include</command> the file <filename>.depend</filename> into @@ -1081,21 +1065,8 @@ ghc -M -optdep-f -optdep.depend ... </listitem> </varlistentry> -<!-- Retired with the move away from 'mkdependHS'. <varlistentry> - <term><option>-o <osuf></option></term> - <listitem> - <para>Use <filename>.<osuf></filename> as the - "target file" suffix ( default: <literal>o</literal>). - Multiple <option>-o</option> flags are permitted - (GHC2.05 onwards). Thus "<option>-o hc -o o</option>" - will generate dependencies for <filename>.hc</filename> - and <filename>.o</filename> files.</para> - </listitem> - </varlistentry> ---> - <varlistentry> - <term><option>-s <suf></option></term> + <term><option>-dep-suffix <suf></option></term> <listitem> <para>Make extra dependencies that declare that files with suffix @@ -1104,13 +1075,14 @@ ghc -M -optdep-f -optdep.depend ... <filename>.<suf>_hi</filename>, or (for <literal>{-# SOURCE #-}</literal> imports) on <filename>.hi-boot</filename>. Multiple - <option>-s</option> flags are permitted. For example, - <option>-o hc -s a -s b</option> will make dependencies - for <filename>.hc</filename> on + <option>-dep-suffix</option> flags are permitted. For example, + <option>-dep-suffix a -dep-suffix b</option> + will make dependencies + for <filename>.hs</filename> on <filename>.hi</filename>, - <filename>.a_hc</filename> on + <filename>.a_hs</filename> on <filename>.a_hi</filename>, and - <filename>.b_hc</filename> on + <filename>.b_hs</filename> on <filename>.b_hi</filename>. (Useful in conjunction with NoFib "ways".)</para> </listitem> @@ -1126,35 +1098,6 @@ ghc -M -optdep-f -optdep.depend ... </varlistentry> <varlistentry> - <term><option>-x</option></term> - <listitem> - <para>same as <option>––exclude-module</option></para> - </listitem> - </varlistentry> - -<!-- Not currently implemented: - <varlistentry> - <term><option>––exclude-directory=<dirs></option></term> - <listitem> - <para>Regard the colon-separated list of directories - <filename><dirs></filename> as containing stable, - don't generate any dependencies on modules - therein.</para> - </listitem> - </varlistentry> - - <varlistentry> - <term><option>––include-module=<file></option></term> - <listitem> - <para>Regard <filename><file></filename> as not - "stable"; i.e., generate dependencies on it (if - any). This option is normally used in conjunction with - the <option>––exclude-directory</option> option.</para> - </listitem> - </varlistentry> ---> - - <varlistentry> <term><option>––include-pkg-deps</option></term> <listitem> <para>Regard modules imported from packages as unstable, |