[project @ 2002-07-02 13:13:36 by simonmar]
Add descriptions to the top level of each package documentation

[project @ 2002-07-02 10:34:52 by simonmar]
Point the punters to the online report at haskell.org until the
documentation for the Prelude is up to scratch.

[project @ 2002-07-02 10:33:23 by simonmar]
Documentation for getProgName.

[project @ 2002-07-02 10:31:35 by simonmar]
Documentation for system

[project @ 2002-07-02 10:28:54 by simonmar]
Documentation for hSetBinaryMode

[project @ 2002-07-01 18:50:54 by sof]
closesocket() is stdcall-based

[project @ 2002-07-01 11:37:35 by simonmar]
Replace divInt# with a version which doesn't suffer from overflow
problems (thanks to Dylan Thurston for the code).

[project @ 2002-06-27 17:19:01 by sof]
theStdGen: initialise it via mkStdRNG (as was done in <= 5.02)

[project @ 2002-06-27 15:38:58 by simonmar]
Finally fix foreign export and foreign import "wrapper" so that
exceptions raised during the call are handled properly rather than
causing the RTS to bomb out.

In particular, calling System.exitWith in a foreign export will cause
the program to terminate cleanly with the desired exit code.  All
other exceptions are printed on stderr (and the program is
terminated).

Details:

GHC.TopHandler.runMain is now called runIO, and has type IO a -> IO a
(previously it had type IO a -> IO (), but that's not general enough
for a foreign export).  The stubs for foreign export and forein import
"wrapper" now automatically wrap the computation in runIO or its dual,
runNonIO.  It turned out to be simpler to do it this way than to do
the wrapping in Haskell land (plain foreign exports don't have
wrappers in Haskell).

[project @ 2002-06-27 13:40:37 by stolz]
- forkProcess[Prim] wrapper
- document forkProcess[Prim] & labelThread

[project @ 2002-06-26 08:18:45 by stolz]
- Make TSO "stable" again: The thread label was changing the size of the
   TSO if you were building a debugging-RTS, leading to binary
   incompatibility. Now we map TSOs to strings using Hash.c.

- API change for labelThread: Label arbitrary threads.

[project @ 2002-06-24 14:40:02 by simonmar]
Makefile updates for generating docs with Haddock:

- explicitly depend on package base
- set SRC_HADDOCK_OPTS in some places

[project @ 2002-06-21 14:00:32 by simonmar]
Mention the package name in the Haddock title

[project @ 2002-06-21 09:12:37 by simonmar]
Andy Gill asked me to remove his license to keep things simple.

[project @ 2002-06-20 16:12:58 by simonmar]
Haddock stuff has moved to ../../mk/package.mk

[project @ 2002-06-20 16:11:45 by simonmar]
use $(includedir) and INSTALL_INCLUDES rather than overriding $(datadir)

[project @ 2002-06-20 14:56:11 by malcolm]
Remove spurious comma in export list.

[project @ 2002-06-20 13:54:40 by simonmar]
Add license from Andy Gill's HTML library

[project @ 2002-06-19 14:33:24 by simonmar]
Remove this hack.  Happy 1.13 is now required to build GHC.

[project @ 2002-06-18 13:58:22 by simonpj]
---------------------------------------
    Rehash the handling of SeqOp
---------------------------------------

See the comments in the commentary (Cunning Prelude Code).

* Expunge SeqOp altogether

* Add GHC.Base.lazy :: a -> a
  to GHC.Base

* Add GHC.Base.lazy
  to basicTypes/MkId.  The idea is that this defn will over-ride
  the info from GHC.Base.hi, thereby hiding strictness and
  unfolding

* Make stranal/WorkWrap do a "manual inlining" for GHC.Base.lazy
  This happens nicely after the strictness analyser has run.

* Expunge the SeqOp/ParOp magic in CorePrep

* Expunge the RULE for seq in PrelRules

* Change the defns of pseq/par in GHC.Conc to:

{-# INLINE pseq  #-}
        pseq :: a -> b -> b
        pseq  x y = x `seq` lazy y

        {-# INLINE par  #-}
        par :: a -> b -> b
        par  x y = case (par# x) of { _ -> lazy y }

[project @ 2002-06-18 13:01:43 by simonmar]
Fix bug in the implementation of hGetLine: on finding the EOF when we
have a partial line in our hands, we weren't resetting the state of
the buffer to empty, so the same partial line would be returned for
each subsequent call to hGetLine.

[project @ 2002-06-18 09:31:05 by simonpj]
--------------------------
Deal with NaN and Infinity
--------------------------

This commit arranges that

* GHC.Real exports infinity   :: Rational = 1 :% 0
notANumber :: Rational = 0 :% 0

* GHC.Float.fromRat converts these Rational non-numbers into
  their Float/Double equivalents

As a result, arith015/arith016 start to work again.  We can
read NaN and Infinity into Float/Double.

[project @ 2002-06-14 08:17:08 by simonpj]
Add comment

[project @ 2002-06-13 23:26:55 by sof]
Provide STRefs over both lazy and strict ST monads as,

   Data.STRef.Lazy
   Data.STRef.Strict
   Data.STRef      <-- the strict version.

i.e., mirror how the strict and lazy ST monads are
organised over in Control.Monad.ST

[project @ 2002-06-13 10:41:31 by simonmar]
Some extra docs, from Jon Fairbairn

[project @ 2002-06-11 10:53:03 by simonmar]
typo in email address (noticed by J?n Fairbairn, thanks J?n).

[project @ 2002-06-09 14:20:06 by panne]
Use :%, not % for Inf/NaN, the latter would immediately lead to a
runtime error. Note that

   isInfinite (read "Infinity" :: Float)

or

   isInfinite (fromRational (1 :% 0))

still don't work, because fromRational is not OK for those cases.

[project @ 2002-06-08 14:14:08 by panne]
Minor doc formatting improvement

[project @ 2002-06-08 13:11:27 by panne]
Install HSbase3.o, too.
NOTE: This is untested, but probably corrects the previous commit.

[project @ 2002-06-06 16:03:16 by simonpj]
Read instance for Array, plus some documentation

[project @ 2002-06-06 16:01:37 by simonpj]
Win32 comment

[project @ 2002-06-05 14:08:24 by simonpj]
------------------------------------------------
Fix the (new) lexer, and make the derived read
and show code work according to the new H98 report
------------------------------------------------

The new lexer, based on Koen's cunning parser (Text.ParserCombinators.ReadP)
wasn't quite right.  It's all very cool now.

In particular:

* The H98 "lex" function should return the exact string parsed, and it
now does, aided by the new combinator ReadP.gather.

* As a result the Text.Read.Lex Lexeme type is much simpler than before
    data Lexeme
      = Char   Char -- Quotes removed,
      | String String --  escapes interpreted
      | Punc   String  -- Punctuation, eg "(", "::"
      | Ident  String -- Haskell identifiers, e.g. foo, baz
      | Symbol String -- Haskell symbols, e.g. >>, %
      | Int Integer
      | Rat Rational
      | EOF
     deriving (Eq,Show)

* Multi-character punctuation, like "::" was getting lexed as a Symbol,
but it should be a Punc.

* Parsing numbers wasn't quite right.  "1..n" got it confused because it
got committed to a decimal point and then found a second '.'.

* The new H98 spec for Show is there, which ignores associativity.

[project @ 2002-06-05 11:30:38 by ross]
documentation adjustments.

[project @ 2002-06-04 19:13:31 by sof]
Adjust to three-way split of HSbase + accommodate cygwin.

[project @ 2002-06-04 19:12:53 by sof]
PEi(x86) backends: The addition of Parsec to libraries/ put us over
the limit for splitting HSbase into two parts (at least I couldn't
find a good paritioning), we now need three. Fun and games.

[project @ 2002-06-03 13:19:37 by simonmar]
IO.hGetContents ==> System.IO.hGetContents (in docs)

[project @ 2002-05-31 12:22:33 by panne]
Moved Parsec to its new home

[project @ 2002-05-31 09:43:04 by panne]
Added Show instance for FunPtr

[project @ 2002-05-29 13:28:36 by simonmar]
doc fixes

[project @ 2002-05-29 13:27:04 by simonmar]
fix case of markup inside bird tracks.

[project @ 2002-05-29 13:22:10 by simonmar]
Don't need to escape single quotes

[project @ 2002-05-28 19:22:04 by sof]
make it compile

[project @ 2002-05-28 16:33:46 by simonmar]
Documentation for the overloaded array interfaces (currently a bit
flaky due to a couple of shortcomings in Haddock).

[project @ 2002-05-28 16:32:45 by simonmar]
Documentation

[project @ 2002-05-28 15:04:54 by simonmar]
Documentation

[project @ 2002-05-28 14:06:01 by simonmar]
Add (minimal) documentation

[project @ 2002-05-28 14:04:18 by simonmar]
Fix mistake in 'evaluate'.

[project @ 2002-05-28 12:03:06 by simonmar]
Document

[project @ 2002-05-28 12:00:17 by simonmar]
typo

[project @ 2002-05-28 11:43:59 by simonmar]
Export list tweak

[project @ 2002-05-28 11:41:29 by simonmar]
Documentation tweaks

[project @ 2002-05-28 11:21:56 by simonmar]
tweak documentationa

[project @ 2002-05-28 11:21:03 by simonmar]
Add documentation

[project @ 2002-05-28 10:38:50 by simonmar]
Document Text.Regex.Posix and Text.Regex

[project @ 2002-05-27 15:57:01 by simonmar]
Documentation, such as it is

[project @ 2002-05-27 15:43:44 by simonmar]
Documentation for System.Mem.Weak

[project @ 2002-05-27 14:54:27 by simonmar]
Add documentation

[project @ 2002-05-27 14:36:51 by simonmar]
Documentation

[project @ 2002-05-27 14:31:06 by simonmar]
Document Control.Exception and Data.Dynamic

[project @ 2002-05-27 14:30:49 by simonmar]
Define __HADDOCK__ for .hs files as well as .lhs files.

[project @ 2002-05-16 11:39:36 by simonmar]
Happy -g currently requires GlaExts, which means it can't be used
inside fptools/libraries (GlaExts comes from lang, and lang isn't
built yet).  So, until I've fixed Happy and everyone has built &
installed the vnew version...

   Add a dummy GlaExts module.

This is a TEMPORARY HACK to keep Happy happy during the switchover
period, and will go away before the release.

[project @ 2002-05-15 12:17:18 by simonmar]
Fix comment to avoid confusing Haddock

[project @ 2002-05-15 12:16:11 by simonmar]
Fix non-Haddockish comments

[project @ 2002-05-15 09:00:00 by chak]
* Added the options `-ffi' and `-fffi', which switch on FFI support
  (`-fglasgow-exts' implies `-fffi').

  NB: Strictly speaking `-fffi' is the correct name; however, `-ffi' is
      supported as an alternative spelling.

* `-fglasgow-exts' no longer enables the `with' keyword for implicit
  parameters.  To use `with' as a keyword, the additional option `-fwith' has
  to be supplied.  (Note that SimonM recently enabled the use of `let' instead
  of `with'.)

  NB: This might prompt some makefile tweaks in libraries or regression tests.

* Renamed `Foreign.Marshal.Utils.withObject' to `Foreign.Marshal.Utils.with'
  as required by the FFI Addendum.  (The old name is still available, but
  marked as deprecated.)

* Added `realloc' to `Foreign.Marshal.Alloc' (tracking RC4 of the FFI
  Addendum).

Docu
~~~~
* Added `-ffi', `-fffi', and `-fwith' to the flag reference and the section
  describing options for Glasgow extensions

* Removed most of the FFI section in the User's Guide in favour of a reference
  to the Addendum plus a brief description of additional features supported by
  GHC.

  NB: The old material is still available at fptools/docs/, I merely removed
  the reference in the User's Guide.

[project @ 2002-05-14 21:08:59 by sof]
lexNumberBase: support negative exponents

[project @ 2002-05-14 13:22:37 by simonmar]
Replace qsort by mergesort, which is more reliable performance-wise.
From: Ian Lynagh <igloo@earth.li>

[project @ 2002-05-11 08:59:08 by panne]
Now that Int is exported, it might be a good idea to import it
first...

[project @ 2002-05-10 16:18:28 by simonmar]
More documentation

[project @ 2002-05-10 15:41:33 by simonmar]
More documentation

[project @ 2002-05-10 14:52:00 by simonmar]
give slurpFile, hGetBuf and hPutBuf reasonable behaviour for
zero-sized files

[project @ 2002-05-10 14:51:14 by simonmar]
Add some documentation for IORef

[project @ 2002-05-10 13:42:07 by simonmar]
Add documentation

[project @ 2002-05-10 13:17:27 by simonmar]
- Add documentation to Control.Concurrent and friends
- Other documentation tweaks

[project @ 2002-05-10 13:16:55 by simonmar]
Add GHC/PrimopWrappers to EXTRA_SRCS

[project @ 2002-05-10 08:58:34 by simonmar]
Convert these files from .lhs to .hs, and give them proper headers to
match the style used in the rest of the libraries.

[project @ 2002-05-10 08:38:53 by simonmar]
import GHC.Ptr to get the representation of Ptr.  This module should
really be split into compiler-dep and indep. parts.

[project @ 2002-05-10 08:35:05 by simonmar]
import GHC.Ptr instead of Foreign.Ptr (I fixed the latter to export
Ptr abstractly yesterday).

[project @ 2002-05-09 13:28:30 by simonmar]
Add a type signature for getClockTime

[project @ 2002-05-09 13:16:29 by simonmar]
Rename libraries/core to libraries/base in the module headers.

[project @ 2002-05-09 13:15:07 by simonmar]
Various tweaks needed to get the source processed cleanly with Haddock.

[project @ 2002-05-09 13:14:42 by simonmar]
tweak the module comment

[project @ 2002-05-09 13:13:28 by simonmar]
Add documentation Haddock-style

[project @ 2002-05-09 13:09:30 by simonmar]
singletonSet has been deprecated for a while; remove it now

[project @ 2002-05-09 13:05:46 by simonmar]
Fix comments that are misinterpreted by Haddock

[project @ 2002-05-09 10:43:42 by simonmar]
We can process GHC.Err with Haddock now

[project @ 2002-05-09 10:43:26 by simonmar]
Omit the imports in Haddock, to avoid module recursion

[project @ 2002-05-06 06:51:00 by sof]
timezone mingw fix, making this module resemble even more of a dog's dinner

[project @ 2002-05-03 08:39:17 by simonmar]
Fix the build on Sparc-Solaris, hopefully without breaking it on Windows.

[project @ 2002-05-02 15:20:02 by sof]
extra_libraries(mingw): The Return of MSVCRT

[project @ 2002-04-28 02:01:00 by sof]
\\begin{code} prefix missing

[project @ 2002-04-26 15:39:50 by lewie]
Fix broken def of fixST.

[project @ 2002-04-26 13:34:05 by simonmar]
Remove \$Id\$ from all files: it isn't particularly useful (see
previous discussion on cvs-ghc@haskell.org), and it confuses Haddock.

[project @ 2002-04-26 13:33:10 by simonmar]
- Remove \$Id\$
- Fix comments that confuse Haddock

[project @ 2002-04-26 13:26:39 by simonmar]
We can cope with Control.Monad.Reader & friends now (Haddock can parse
fundeps).

[project @ 2002-04-26 12:58:45 by simonmar]
doc string wibble

[project @ 2002-04-26 12:48:16 by simonmar]
- Add proper module headers to these guys
- Remove \$Id\$
- Update copyrights
- Int.lhs and Word.lhs were just wrapped in \begin{code}..\end{code},
  so make them .hs files instead.

[project @ 2002-04-26 12:31:06 by simonmar]
Add a LICENSE

[project @ 2002-04-24 17:57:55 by ross]
haddock food.

[project @ 2002-04-24 16:31:37 by simonmar]
Add the single character '|' to the header comment of each module so
that Haddock will parse it as the module documentation.

[project @ 2002-04-24 16:13:26 by simonmar]
Makefile rules for building HTML documentation using Haddock.  It's a
bit rough around the edges so far, and I haven't added any actual
documentation yet, but you can build Haddock (in fptools/haddock) and
then say

$ make haddock-docs

in fptools/libraries/base to get bare-bones HTML docs for the entire
contents (almost) of the base package.