Commit ec655d31 authored by simonmar's avatar simonmar
Browse files

[project @ 2002-01-04 10:18:58 by simonmar]

Replace all instances of '--' with '––' since '--' gets
interpreted by JadeTeX to mean a single dash.
parent b716195d
......@@ -9,7 +9,7 @@
been added (<xref linkend="ghci">).</para>
</listitem>
<listitem>
<para>New <option>--make</option> flag added (<xref
<para>New <option>&ndash;&ndash;make</option> flag added (<xref
linkend="make-mode">).</para>
</listitem>
<listitem>
......@@ -160,7 +160,7 @@
<listitem>
<para>The <literal>WithGhcHc</literal> setting in
<literal>build.mk</literal> has been replaced by the
<literal>--with-ghc=<replaceable>ghc</replaceable></literal>
<literal>&ndash;&ndash;with-ghc=<replaceable>ghc</replaceable></literal>
option to <literal>configure</literal>. The new option
<emphasis>must</emphasis> be used if you intend to use
anything except &ldquo;<literal>ghc</literal>&rdquo; to
......
......@@ -119,7 +119,7 @@
multiple modules for the <literal>:add</literal> and
<literal>:load</literal> commands. From the command line, you
may specify multiple modules when starting GHCi and when
compiling in <option>--make</option> mode. See
compiling in <option>&ndash;&ndash;make</option> mode. See
<xref linkend="ghci-commands">.</para>
</listitem>
......
......@@ -178,7 +178,7 @@ int main(int argc, char *argv[])
remember to include <filename>M_stub.o</filename> in the final
link command line, or you'll get link errors for the missing
function(s) (this isn't necessary when building your program
with <literal>ghc --make</literal>, as GHC will automatically
with <literal>ghc &ndash;&ndash;make</literal>, as GHC will automatically
link in the correct bits).</para>
</sect3>
</sect2>
......
......@@ -45,19 +45,19 @@
<entry>-</entry>
</row>
<row>
<entry><option>--version</option></entry>
<entry><option>&ndash;&ndash;version</option></entry>
<entry>display GHC version</entry>
<entry>static</entry>
<entry>-</entry>
</row>
<row>
<entry><option>--numeric-version</option></entry>
<entry><option>&ndash;&ndash;numeric-version</option></entry>
<entry>display GHC version (numeric only)</entry>
<entry>static</entry>
<entry>-</entry>
</row>
<row>
<entry><option>--print-libdir</option></entry>
<entry><option>&ndash;&ndash;print-libdir</option></entry>
<entry>display GHC library directory</entry>
<entry>static</entry>
<entry>-</entry>
......
......@@ -158,7 +158,7 @@ Main> fac 17
<para>or it can be set using the <literal>:set</literal> command
from within GHCi (see <xref
linkend="ghci-cmd-line-options">)<footnote><para>Note that in
GHCi, and <option>--make</option> mode, the <option>-i</option>
GHCi, and <option>&ndash;&ndash;make</option> mode, the <option>-i</option>
option is used to specify the search path for
<emphasis>source</emphasis> files, whereas in standard
batch-compilation mode the <option>-i</option> option is used to
......@@ -305,7 +305,7 @@ Ok, modules loaded: A, B, C, D.
<para>HINT: since GHCi will only use a compiled object file if it
can sure that the compiled version is up-to-date, a good technique
when working on a large program is to occasionally run
<literal>ghc --make</literal> to compile the whole project (say
<literal>ghc &ndash;&ndash;make</literal> to compile the whole project (say
before you go for lunch :-), then continue working in the
interpreter. As you modify code, the new modules will be
interpreted, but the rest of the project will remain
......@@ -543,10 +543,10 @@ Wed Mar 14 12:23:13 GMT 2001
<sect1 id="ghci-invokation">
<title>Invoking GHCi</title>
<indexterm><primary>invoking</primary><secondary>GHCi</secondary></indexterm>
<indexterm><primary><option>--interactive</option></primary></indexterm>
<indexterm><primary><option>&ndash;&ndash;interactive</option></primary></indexterm>
<para>GHCi is invoked with the command <literal>ghci</literal> or
<literal>ghc --interactive</literal>. One or more modules or
<literal>ghc &ndash;&ndash;interactive</literal>. One or more modules or
filenames can also be specified on the command line; this
instructs GHCi to load the specified modules or filenames (and all
the modules they depend on), just as if you had said
......@@ -728,11 +728,11 @@ Prelude> :mycd ..
</screen>
<para>Or I could define a simple way to invoke
&ldquo;<literal>ghc --make Main</literal>&rdquo; in the
&ldquo;<literal>ghc &ndash;&ndash;make Main</literal>&rdquo; in the
current directory:</para>
<screen>
Prelude> :def make (\_ -> return ":! ghc --make Main")
Prelude> :def make (\_ -> return ":! ghc &ndash;&ndash;make Main")
</screen>
</listitem>
......
......@@ -705,7 +705,7 @@ Windows and Unix, as follows: layout:</para>
<programlisting>
$(libdir)/
package.conf GHC package configuration
ghc-usage.txt Message displayed by ghc --help
ghc-usage.txt Message displayed by ghc &ndash;&ndash;help
bin/ [Win32 only] User-visible binaries
ghc.exe
......
......@@ -358,7 +358,7 @@
<para>The version number of your copy of GHC can be found by
invoking <literal>ghc</literal> with the
<literal>--version</literal> flag (see <xref
<literal>&ndash;&ndash;version</literal> flag (see <xref
linkend="options-help">).</para>
</sect1>
......
......@@ -127,7 +127,7 @@
hand from the <literal>.a</literal> archive, it is possible
to use GNU <command>ld</command> as follows:</para>
<screen>ld -r --whole-archive -o HSfoo.o libHSfoo.a</screen>
<screen>ld -r &ndash;&ndash;whole-archive -o HSfoo.o libHSfoo.a</screen>
</listitem>
<listitem>
......@@ -178,7 +178,7 @@
added or removed from a package configuration file. By default,
the system-wide configuration file is used, but alternatively
packages can be added or removed from a user-specified
configuration file using the <option>--config-file</option>
configuration file using the <option>&ndash;&ndash;config-file</option>
option. An empty package configuration file consists of the
string <quote><literal>[]</literal></quote>.</para>
......@@ -187,9 +187,9 @@
<variablelist>
<varlistentry>
<term><option>--add-package</option></term>
<term><option>&ndash;&ndash;add-package</option></term>
<term><option>-a</option></term>
<indexterm><primary><option>--add-package</option></primary></indexterm>
<indexterm><primary><option>&ndash;&ndash;add-package</option></primary></indexterm>
<listitem>
<para>Reads package specification from the input (see below),
and adds it to the database of installed packages. The
......@@ -199,9 +199,9 @@
</varlistentry>
<varlistentry>
<term><option>--input-file=<replaceable>file</replaceable></option></term>
<term><option>&ndash;&ndash;input-file=<replaceable>file</replaceable></option></term>
<term><option>-i <replaceable>file</replaceable></option></term>
<indexterm><primary><option>--input-file</option></primary></indexterm>
<indexterm><primary><option>&ndash;&ndash;input-file</option></primary></indexterm>
<listitem>
<para>Read new package specifications from file
<replaceable>file</replaceable>. If a value of
......@@ -213,9 +213,9 @@
</varlistentry>
<varlistentry>
<term><option>--auto-ghci-libs</option></term>
<term><option>&ndash;&ndash;auto-ghci-libs</option></term>
<term><option>-g</option></term>
<indexterm><primary><option>--auto-ghci-libs</option></primary>
<indexterm><primary><option>&ndash;&ndash;auto-ghci-libs</option></primary>
</indexterm>
<listitem>
<para>Automatically generate the GHCi
......@@ -235,9 +235,9 @@
</varlistentry>
<varlistentry>
<term><option>--config-file <replaceable>file</replaceable></option></term>
<term><option>&ndash;&ndash;config-file <replaceable>file</replaceable></option></term>
<term><option>-f <replaceable>file</replaceable></option></term>
<indexterm><primary><option>--config-file</option></primary>
<indexterm><primary><option>&ndash;&ndash;config-file</option></primary>
</indexterm>
<listitem>
<para>Use <replaceable>file</replaceable> instead of the
......@@ -249,15 +249,15 @@
</varlistentry>
<varlistentry>
<term><option>--list-packages</option></term>
<term><option>&ndash;&ndash;list-packages</option></term>
<term><option>-l</option></term>
<indexterm><primary><option>--list-packages</option></primary></indexterm>
<indexterm><primary><option>&ndash;&ndash;list-packages</option></primary></indexterm>
<listitem>
<para>This option displays the list of currently installed
packages.</para>
<screen>
$ ghc-pkg --list-packages
$ ghc-pkg &ndash;&ndash;list-packages
gmp, rts, std, lang, concurrent, data, net, posix, text, util
</screen>
......@@ -275,9 +275,9 @@
</varlistentry>
<varlistentry>
<term><option>--remove-package <replaceable>foo</replaceable></option></term>
<term><option>&ndash;&ndash;remove-package <replaceable>foo</replaceable></option></term>
<term><option>-r <replaceable>foo</replaceable></option></term>
<indexterm><primary><option>--delete-package</option></primary>
<indexterm><primary><option>&ndash;&ndash;delete-package</option></primary>
</indexterm>
<listitem>
<para>Removes the specified package from the installed
......@@ -285,9 +285,9 @@
</listitem>
</varlistentry>
<varlistentry>
<term><option>--update-package</option></term>
<term><option>&ndash;&ndash;update-package</option></term>
<term><option>-u</option></term>
<indexterm><primary><option>--update-package</option></primary></indexterm>
<indexterm><primary><option>&ndash;&ndash;update-package</option></primary></indexterm>
<listitem>
<para>Reads package specification from the input, and
adds it to the database of installed packages. If a package
......@@ -335,7 +335,7 @@
<listitem>
<para>The package's name, for use with
the <literal>-package</literal> flag and as listed in the
<literal>--list-packages</literal> list.
<literal>&ndash;&ndash;list-packages</literal> list.
</para>
</listitem>
</varlistentry>
......
......@@ -885,7 +885,7 @@ $ ghcprof &lt;prog&gt;.prof
</sect1>
<sect1 id="hp2ps">
<title><command>hp2ps</command>--heap profile to PostScript</title>
<title><command>hp2ps</command>&ndash;&ndash;heap profile to PostScript</title>
<indexterm><primary><command>hp2ps</command></primary></indexterm>
<indexterm><primary>heap profiles</primary></indexterm>
......
......@@ -38,7 +38,7 @@
<para>If you absolutely positively want all the rest of the options
in a command line to go to the program (and not the RTS), use a
<option>--RTS</option><indexterm><primary><option>--RTS</option></primary></indexterm>.</para>
<option>&ndash;&ndash;RTS</option><indexterm><primary><option>--RTS</option></primary></indexterm>.</para>
<para>As always, for RTS options that take
<replaceable>size</replaceable>s: If the last character of
......
......@@ -370,7 +370,7 @@ A.o : B.hi-boot
locate any imported modules that come from packages. The
package modules won't be included in the dependencies
generated, though (but see the
<option>--include-prelude</option> option below).</para>
<option>&ndash;&ndash;include-prelude</option> option below).</para>
<para>The dependency generation phase of GHC can take some
additional options, which you may find useful. For historical
......@@ -444,7 +444,7 @@ ghc -M -optdep-f -optdep.depend ...
</varlistentry>
<varlistentry>
<term><option>--exclude-module=&lt;file&gt;</option></term>
<term><option>&ndash;&ndash;exclude-module=&lt;file&gt;</option></term>
<listitem>
<para>Regard <filename>&lt;file&gt;</filename> as
"stable"; i.e., exclude it from having dependencies on
......@@ -455,12 +455,12 @@ ghc -M -optdep-f -optdep.depend ...
<varlistentry>
<term><option>-x</option></term>
<listitem>
<para>same as <option>--exclude-module</option></para>
<para>same as <option>&ndash;&ndash;exclude-module</option></para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--exclude-directory=&lt;dirs&gt;</option></term>
<term><option>&ndash;&ndash;exclude-directory=&lt;dirs&gt;</option></term>
<listitem>
<para>Regard the colon-separated list of directories
<filename>&lt;dirs&gt;</filename> as containing stable,
......@@ -470,17 +470,17 @@ ghc -M -optdep-f -optdep.depend ...
</varlistentry>
<varlistentry>
<term><option>--include-module=&lt;file&gt;</option></term>
<term><option>&ndash;&ndash;include-module=&lt;file&gt;</option></term>
<listitem>
<para>Regard <filename>&lt;file&gt;</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>
the <option>&ndash;&ndash;exclude-directory</option> option.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--include-prelude</option></term>
<term><option>&ndash;&ndash;include-prelude</option></term>
<listitem>
<para>Regard modules imported from packages as unstable,
i.e., generate dependencies on the package modules used
......
......@@ -9,7 +9,7 @@
<variablelist>
<varlistentry>
<term><cmdsynopsis><command>ghc</command>
<arg choice=plain>--interactive</arg>
<arg choice=plain>&ndash;&ndash;interactive</arg>
</cmdsynopsis></term>
<indexterm><primary>interactive mode</primary>
</indexterm>
......@@ -24,11 +24,11 @@
<varlistentry>
<term><cmdsynopsis><command>ghc</command>
<arg choice=plain>--make</arg>
<arg choice=plain>&ndash;&ndash;make</arg>
</cmdsynopsis></term>
<indexterm><primary>make mode</primary>
</indexterm>
<indexterm><primary><option>--make</option></primary>
<indexterm><primary><option>&ndash;&ndash;make</option></primary>
</indexterm>
<listitem>
<para>In this mode, GHC will build a multi-module Haskell
......@@ -252,10 +252,10 @@ module X where
<variablelist>
<varlistentry>
<term><option>--help</option></term>
<term><option>&ndash;&ndash;help</option></term>
<term><option>-?</option></term>
<indexterm><primary><option>-?</option></primary></indexterm>
<indexterm><primary><option>--help</option></primary></indexterm>
<indexterm><primary><option>&ndash;&ndash;help</option></primary></indexterm>
<listitem>
<para>Cause GHC to spew a long usage message to standard
output and then exit.</para>
......@@ -304,8 +304,8 @@ module X where
<listitem>
<para>Minimal verbosity: print one line per
compilation (this is the default when
<option>--make</option> or
<option>--interactive</option> is on).</para>
<option>&ndash;&ndash;make</option> or
<option>&ndash;&ndash;interactive</option> is on).</para>
</listitem>
</varlistentry>
......@@ -341,24 +341,24 @@ module X where
</varlistentry>
<varlistentry>
<term><option>--version</option></term>
<indexterm><primary><option>--version</option></primary></indexterm>
<term><option>&ndash;&ndash;version</option></term>
<indexterm><primary><option>&ndash;&ndash;version</option></primary></indexterm>
<listitem>
<para>Print a one-line string including GHC's version number.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--numeric-version</option></term>
<indexterm><primary><option>--numeric-version</option></primary></indexterm>
<term><option>&ndash;&ndash;numeric-version</option></term>
<indexterm><primary><option>&ndash;&ndash;numeric-version</option></primary></indexterm>
<listitem>
<para>Print GHC's numeric version number only.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--print-libdir</option></term>
<indexterm><primary><option>--print-libdir</option></primary></indexterm>
<term><option>&ndash;&ndash;print-libdir</option></term>
<indexterm><primary><option>&ndash;&ndash;print-libdir</option></primary></indexterm>
<listitem>
<para>Print the path to GHC's library directory. This is
the top of the directory tree containing GHC's libraries,
......@@ -375,14 +375,14 @@ module X where
</sect1>
<sect1 id="make-mode">
<title>Using <command>ghc</command> <option>--make</option></title>
<title>Using <command>ghc</command> <option>&ndash;&ndash;make</option></title>
<indexterm><primary><option>--make</option></primary>
<indexterm><primary><option>&ndash;&ndash;make</option></primary>
</indexterm>
<indexterm><primary>separate compilation</primary>
</indexterm>
<para>When given the <option>--make</option> option, GHC will
<para>When given the <option>&ndash;&ndash;make</option> option, GHC will
build a multi-module Haskell program by following dependencies
from a single root module (usually <literal>Main</literal>). For
example, if your <literal>Main</literal> module is in a file
......@@ -390,7 +390,7 @@ module X where
the program like this:</para>
<screen>
ghc --make Main.hs
ghc &ndash;&ndash;make Main.hs
</screen>
<para>The command line must contain one source file or module
......@@ -400,7 +400,7 @@ ghc --make Main.hs
if the top module is <literal>Main</literal>, the program
will also be linked into an executable.</para>
<para>The main advantages to using <literal>ghc --make</literal>
<para>The main advantages to using <literal>ghc &ndash;&ndash;make</literal>
over traditional <literal>Makefile</literal>s are:</para>
<itemizedlist>
......@@ -408,7 +408,7 @@ ghc --make Main.hs
<para>GHC doesn't have to be restarted for each compilation,
which means it can cache information between compilations.
Compiling a muli-module program with <literal>ghc
--make</literal> can be up to twice as fast as running
&ndash;&ndash;make</literal> can be up to twice as fast as running
<literal>ghc</literal> individually on each source
file.</para>
</listitem>
......@@ -426,7 +426,7 @@ ghc --make Main.hs
</itemizedlist>
<para>Any of the command-line options described in the rest of
this chapter can be used with <option>--make</option>, but note
this chapter can be used with <option>&ndash;&ndash;make</option>, but note
that any options you give on the command line will apply to all
the source files compiled, so if you want any options to apply to
a single source file only, you'll need to use an
......@@ -446,9 +446,9 @@ ghc --make Main.hs
</sect1>
<Sect1 id="options-order">
<title>GHC without <option>--make</option></title>
<title>GHC without <option>&ndash;&ndash;make</option></title>
<para>Without <option>--make</option>, GHC will compile one or
<para>Without <option>&ndash;&ndash;make</option>, GHC will compile one or
more source files given on the command line.</para>
<para>The first phase to run is determined by each input-file
......
......@@ -185,7 +185,7 @@ tags:
<variablelist>
<varlistentry>
<term><literal>-t FILE</literal> or
<literal>--template=FILE</literal></term>
<literal>&ndash;&ndash;template=FILE</literal></term>
<listitem>
<para>The template file (see below).</para>
</listitem>
......@@ -193,7 +193,7 @@ tags:
<varlistentry>
<term><literal>-c PROG</literal> or
<literal>--cc=PROG</literal></term>
<literal>&ndash;&ndash;cc=PROG</literal></term>
<listitem>
<para>The C compiler to use (default:
<command>ghc</command>)</para>
......@@ -202,7 +202,7 @@ tags:
<varlistentry>
<term><literal>-l PROG</literal> or
<literal>--ld=PROG</literal></term>
<literal>&ndash;&ndash;ld=PROG</literal></term>
<listitem>
<para>The linker to use (default:
<command>gcc</command>).</para>
......@@ -211,7 +211,7 @@ tags:
<varlistentry>
<term><literal>-C FLAG</literal> or
<literal>--cflag=FLAG</literal></term>
<literal>&ndash;&ndash;cflag=FLAG</literal></term>
<listitem>
<para>An extra flag to pass to the C compiler.</para>
</listitem>
......@@ -226,7 +226,7 @@ tags:
<varlistentry>
<term><literal>-L FLAG</literal> or
<literal>--lflag=FLAG</literal></term>
<literal>&ndash;&ndash;lflag=FLAG</literal></term>
<listitem>
<para>An extra flag to pass to the linker.</para>
</listitem>
......@@ -234,7 +234,7 @@ tags:
<varlistentry>
<term><literal>-i FILE</literal> or
<literal>--include=FILE</literal></term>
<literal>&ndash;&ndash;include=FILE</literal></term>
<listitem>
<para>As if the appropriate <literal>#include</literal>
directive was placed in the source.</para>
......@@ -243,7 +243,7 @@ tags:
<varlistentry>
<term><literal>-D NAME[=VALUE]</literal> or
<literal>--define=NAME[=VALUE]</literal></term>
<literal>&ndash;&ndash;define=NAME[=VALUE]</literal></term>
<listitem>
<para>As if the appropriate <literal>#define</literal>
directive was placed in the source.</para>
......@@ -252,28 +252,28 @@ tags:
<varlistentry>
<term><literal>-o FILE</literal> or
<literal>--output=FILE</literal></term>
<literal>&ndash;&ndash;output=FILE</literal></term>
<listitem>
<para>Name of the Haskell file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>--help</literal></term>
<term><literal>&ndash;&ndash;help</literal></term>
<listitem>
<para>Display a summary of the available flags.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>--version</literal></term>
<term><literal>&ndash;&ndash;version</literal></term>
<listitem>
<para>Output version information.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>--no-compile</literal></term>
<term><literal>&ndash;&ndash;no-compile</literal></term>
<listitem>
<para>Stop after writing out the intermediate C program to disk.
The file name for the intermediate C program is the input file name
......
......@@ -86,7 +86,7 @@ still there. If you're interested, contact the GHC team. Note that
building an entire Haskell application as a DLL is still supported
(it's just inter-DLL Haskell calls that don't work).</emphasis>
<IndexTerm><Primary>Creating a Win32 DLL</Primary></IndexTerm>
<IndexTerm><Primary>--mk-dll</Primary></IndexTerm>
<IndexTerm><Primary>&ndash;&ndash;mk-dll</Primary></IndexTerm>
Sealing up your Haskell library inside a DLL is straightforward;
compile up the object files that make up the library, and then build
the DLL by issuing a command of the form:
......@@ -94,12 +94,12 @@ the DLL by issuing a command of the form:
<Para>
<Screen>
ghc --mk-dll -o foo.dll bar.o baz.o wibble.a -lfooble
ghc &ndash;&ndash;mk-dll -o foo.dll bar.o baz.o wibble.a -lfooble
</Screen>
</Para>
<Para>
By feeding the ghc compiler driver the option <Option>--mk-dll</Option>, it
By feeding the ghc compiler driver the option <Option>&ndash;&ndash;mk-dll</Option>, it
will build a DLL rather than produce an executable. The DLL will
consist of all the object files and archives given on the command
line.
......@@ -135,12 +135,12 @@ you compile into a DLL must have a common root.
<ListItem>
<Para>
By default, the entry points of all the object files will be exported from
the DLL when using <Option>--mk-dll</Option>. Should you want to constrain
the DLL when using <Option>&ndash;&ndash;mk-dll</Option>. Should you want to constrain
this, you can specify the <Emphasis>module definition file</Emphasis> to use
on the command line as follows:
<Screen>
ghc --mk-dll -o .... -optdll--def -optdllMyDef.def
ghc &ndash;&ndash;mk-dll -o .... -optdll--def -optdllMyDef.def
</Screen>
See Microsoft documentation for details, but a module definition file
......@@ -159,7 +159,7 @@ EXPORTS
<ListItem>
<Para>
In addition to creating a DLL, the <Option>--mk-dll</Option> option also
In addition to creating a DLL, the <Option>&ndash;&ndash;mk-dll</Option> option also
creates an import library. The import library name is derived from the
name of the DLL, as follows:
......@@ -232,7 +232,7 @@ This will produce two files, adder.o and adder_stub.o
<ListItem>
<Para>
compile up a <Function>DllMain()</Function> that starts up the Haskell
RTS---a possible implementation is:
RTS-&ndash;&ndash;a possible implementation is:
<ProgramListing>
#include &lt;windows.h&gt;
......@@ -276,7 +276,7 @@ gcc -c dllMain.c
Construct the DLL:
<Screen>
ghc --mk-dll -o adder.dll adder.o adder_stub.o dllMain.o
ghc &ndash;&ndash;mk-dll -o adder.dll adder.o adder_stub.o dllMain.o
</Screen>
</Para>
......@@ -284,7 +284,7 @@ ghc --mk-dll -o adder.dll adder.o adder_stub.o dllMain.o
<ListItem>
<Para>
Start using <Function>adder</Function> from VBA---here's how I would
Start using <Function>adder</Function> from VBA-&ndash;&ndash;here's how I would
<Constant>Declare</Constant> it:
<ProgramListing>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment