X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=ghc%2Fdocs%2Fusers_guide%2F5-00-notes.sgml;h=b1377c3de529eed1d50574b83d411fc0b0949d6f;hb=2947e534cfb45e3eff9f06e8f60d19117da3ac63;hp=2e205725c6ed16f16f27c7d088f2d50a77154d97;hpb=f4742cfc2308a9816b2340a8ab2508821b587903;p=ghc-hetmet.git

diff --git a/ghc/docs/users_guide/5-00-notes.sgml b/ghc/docs/users_guide/5-00-notes.sgml
index 2e20572..b1377c3 100644
--- a/ghc/docs/users_guide/5-00-notes.sgml
+++ b/ghc/docs/users_guide/5-00-notes.sgml
@@ -5,19 +5,103 @@
     <title>User-visible compiler changes</title>
     <itemizedlist>
       <listitem>
-	<para>GHCi added</para>
+	<para>GHCi, the new interactive environment on top of GHC, has
+	been added (<xref linkend="ghci">).</para>
       </listitem>
       <listitem>
-	<para><option>--make</option> flag added</para>
+	<para>New <option>--make</option> flag added (<xref
+	linkend="make-mode">).</para>
       </listitem>
       <listitem>
-	<para>dynamic vs. static options</para>
+	<para>The native code generator now supports Sparc in addition
+	to x86.</para>
       </listitem>
       <listitem>
-	<para>NCG support for Sparc</para>
+	<para>We now make it clear which options can be placed in an
+	OPTIONS pragma.  See <xref
+	linkend="static-dynamic-flags">.</para>
       </listitem>
       <listitem>
-	<para><command>hsc2hs</command> added</para>
+	<para><option>-fglasgow-exts</option> no longer implies
+	<option>-package lang</option>.</para>
+      </listitem>
+      <listitem>
+	<para><option>-noC</option> is no more.</para>
+      </listitem>
+      <listitem>
+	<para><option>-hi</option> and <option>-nohi</option> are no more.</para>
+      </listitem>
+      <listitem>
+	<para>The concept of &ldquo;packages&rdquo; has been
+	generalised and extended.  Packages may be installed or
+	removed from an existing GHC installation using the new
+	<command>ghc-pkg</command> tool.  See <xref
+	linkend="packages">.</para>
+      </listitem>
+      <listitem>
+	<para>Initial unicode support: the <literal>Char</literal>
+	type is now 31 bits.  We don't yet have support for unicode
+	I/O.</para>
+      </listitem>
+      <listitem>
+	<para><option>-v</option> now takes an optional numeric
+        argument indicating the level of verbosity (<xref
+        linkend="options-help">).  <option>-dshow-passes</option> has
+        been removed.</para>
+      </listitem>
+      <listitem>
+	<para>Parallel list comprehensions added.</para>
+      </listitem>
+      <listitem>
+	<para>Profiling: please use 
+              <literal>{-# SCC ".." #-}</literal> 
+              rather than <literal>_scc_ "..."</literal>.  The latter
+              will be phased out in due course.</para>
+      </listitem>
+      <listitem>
+	<para>A new experimental optimisation, SpecConstr, is turned
+	on with <literal>-O2</literal>.</para>
+      </listitem>
+      <listitem>
+	<para>Please report bugs using the <ulink
+	url="http://sourceforge.net/projects/ghc/">SourceForge bug
+	tracker</ulink> instead of
+	<email>glasgow-haskell-bugs@haskell.org</email> if
+	possible.</para>
+      </listitem>
+      <listitem>
+	<para>Documentation changes: there's now a useful Flag
+	Reference section, see <xref linkend="flag-reference">.</para>
+      </listitem>
+      <listitem>
+	<para>Many, many, bugfixes.</para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+
+  <sect2>
+    <title>New experimental features</title>
+
+    <itemizedlist>
+      <listitem>
+	<para>A &ldquo;front panel&rdquo; for GHC-compiled programs
+	displays real-time graphs of memory behaviour in a GTK+
+	window.  You need to recompile the RTS with front panel
+	support to use this.</para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+
+  <sect2>
+    <title>FFI changes</title>
+    <itemizedlist>
+      <listitem>
+	<para><command>hsc2hs</command> added (<xref linkend="hsc2hs">).</para>
+      </listitem>
+      <listitem>
+	<para>FFI libraries have been updated to the latest proposal
+	from the FFI task force.  Too many changes to list here, see
+	the docs: <xref linkend="sec-Foreign">.</para>
       </listitem>
     </itemizedlist>
   </sect2>
@@ -26,7 +110,43 @@
     <title>User-visible library changes</title>
     <itemizedlist>
       <listitem>
-	<para>FFI libraries enhanced, lots of deprecations.</para>
+	<para><function>putMVar</function> now blocks if the
+	<literal>MVar</literal> is already full.  The
+	<literal>PutFullMVar</literal> exception no longer exists.  A
+	non-blocking version of <function>putMVar</function>,
+	<function>tryPutMVar</function>, has been added (<xref
+	linkend="sec-MVars">).</para>
+      </listitem>
+      <listitem>
+	<para>The <literal>Integer</literal> type now has an instance
+        of <literal>Bits</literal> (<xref linkend="sec-Bits">).</para>
+      </listitem>
+      <listitem>
+	<para>Package <literal>hssource</literal> has been added.  It
+	contains a Haskell 98 abstract syntax, parser, lexer and pretty
+	printer.  No documentation yet.</para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+
+  <sect2>
+    <title>Build system changes</title>
+    
+    <itemizedlist>
+      <listitem>
+	<para>The <literal>WithGhcHc</literal> setting in
+	<literal>build.mk</literal> has been replaced by the
+	<literal>--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
+	bootstrap GHC, in order that the build system can figure out
+	what version of GHC you're using.</para>
+      </listitem>
+      <listitem>
+	<para>Source distributions are now made by doing <literal>make
+	distclean</literal> in a build tree, instead of requiring a
+	linked build tree.</para>
       </listitem>
     </itemizedlist>
   </sect2>
@@ -35,10 +155,18 @@
     <title>Internal changes</title>
     <itemizedlist>
       <listitem>
+	<para>Many internal compiler changes: too many to list
+	here.</para>
+      </listitem>
+      <listitem>
 	<para>The old perl driver has been removed and replaced by a
 	driver in the compiler proper.</para>
       </listitem>
       <listitem>
+	<para>We now use GMP 3 instead of GMP 2 for
+	arbitrary-precision integer support.</para>
+      </listitem>
+      <listitem>
 	<para>Several libraries rewritten to use the FFI.</para>
       </listitem>
     </itemizedlist>