DarcsURL: http://darcs.haskell.org/packages/base
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=_"
--=_
Content-Type: text/plain
Content-Transfer-Encoding: quoted-printable
Sat Nov 29 11:46:39 =93=8C=8B=9E (=95W=8F=80=8E=9E) 2008 shelarcy
* Fix typo (or out of date reference) in throwTo documentation.
--=_
Content-Type: text/x-darcs-patch; name="fix-typo-_or-out-of-date-reference_-in-throwto-documentation_.dpatch"
Content-Transfer-Encoding: quoted-printable
Content-Description: A darcs patch for your repository!
New patches:
[Fix typo (or out of date reference) in throwTo documentation.
shelarcy **20081129024639] hunk ./GHC/Conc.lhs 304
(http://research.microsoft.com/~simonpj/Papers/asynch-exns.htm).
In the paper, 'throwTo' is non-blocking; but the library implementation ad=
opts
a more synchronous design in which 'throwTo' does not return until the exc=
eption
-is received by the target thread. The trade-off is discussed in Section 8=
of the paper.
-Like any blocking operation, 'throwTo' is therefore interruptible (see Sec=
tion 4.3 of
+is received by the target thread. The trade-off is discussed in Section 9=
of the paper.
+Like any blocking operation, 'throwTo' is therefore interruptible (see Sec=
tion 5.3 of
the paper).
=
There is currently no guarantee that the exception delivered by 'throwTo' =
will be
Context:
[Add more description of what "round" does, from the H98 report
Ian Lynagh **20081119143131] =
[re-instate the gcd/Integer and lcm/Integer RULES
Simon Marlow **20081120101826
Fixes a performance regression between 6.8.3 and 6.10.1
] =
[Change an "undefined" into a more informative error; trac #2782
Ian Lynagh **20081116160228] =
[updating Haddock documentation
jpm@cs.uu.nl**20081111095023
=
Fixed the broken link from Data.Generics to Data.Data.
] =
[add GHC.Conc.runSparks (required by GHC patch "Run sparks in batches")
Simon Marlow **20081106095419] =
[FIX #2722: update RULES for the Category/Arrow split
Ross Paterson **20081104144515
=
The rule
=
arr id =3D id
=
interacts unpleasantly with the advice to define
=
id =3D arr id
=
in instances of Category that are also instances of Arrow (#2722).
=
Also changed a couple of >>>'s to .'s in later rules.
] =
[Add AnnotationWrapper type so GHC can capture annotation dictionaries duri=
ng compilation
Max Bolingbroke **20081016122608] =
[docs about how exceptions are handled by forkIO'd threads (#2651)
Simon Marlow **20081016100410] =
[Import n_capabilities via import symbol when linking dynamically
Clemens Fruhwirth **20081013161220] =
[add link to the new syb wiki
jpm@cs.uu.nl**20081013111605] =
[changing haddock links
jpm@cs.uu.nl**20081010095434] =
[add readTVarIO :: TVar a -> IO a
Simon Marlow **20081010113835] =
[removed (->) instance from Data.Data
jpm@cs.uu.nl**20081006075254] =
[non-GHC: delete unnecessary imports
Ross Paterson **20081007134809] =
[added new module Data.Data
'Jose Pedro Magalhaes '**20081002140535
=
The new Data.Data module contains all of Data.Generics.Basics =
and most of Data.Generics.Instances. The missing instances were =
deemed dubious and moved to the syb package.
] =
[add new Data.Data module
'Jose Pedro Magalhaes '**20081002082735] =
[restore Complex's derived Data instance
'Jose Pedro Magalhaes '**20081002082655] =
[update Data.Generics import
'Jose Pedro Magalhaes '**20081002082604] =
[Don't use ^(2::Int) in Data.Complex.magnitude; partially fixes trac #2450
Ian Lynagh **20081004142651
We still might want to make a RULE for this, so the bug is not fully fixed=
.
] =
[Restore the Haskell 98 behaviour of Show Ratio (#1920)
Simon Marlow **20080923134949] =
[Pad version number to 4.0.0.0
Ian Lynagh **20080920155801] =
[TAG 6.10 branch has been forked
Ian Lynagh **20080919123437] =
[In nhc98, Word is a type synonym, so class instance is not possible.
Malcolm.Wallace@cs.york.ac.uk**20080917075326] =
[Fix bugs in Text.Printf (#1548)
Simon Marlow **20080916133505] =
[We should be including Rts.h here, not Stg.h
Simon Marlow **20080912134901
Stg.h is for .hc files only, and it sets up various global register
variables.
] =
[Generic functions that take integral arguments should work the same way as=
their prelude counterparts
**20080822022755
=
The Prelude functions drop, take, and splitAt are unfailing (never call er=
ror). This patch changes the Data.List generic versions to behave the same =
way. At present, they call error on negative arguments.
=
] =
[Don't define __hscore_s_issock on Windows
Ian Lynagh **20080904202845] =
[Unbreak the GHC build with older versions of gcc
Ian Lynagh **20080904185122
Patch from kili@outback.escape.de, who says:
Stg.h must be included before HsBase.h, because the latter contains
function definitions causing older versions of gcc (3.3.5 in my
case) to bail out with "error: global register variable follows a
function definition" on Regs.h, which is included by Stg.h.
] =
[Don't make S_ISSOCK use conditional
Ian Lynagh **20080904164234
We were conditionally defining the C wrapper, but unconditionally using
it. So if it didn't exist then things would have broken anyway.
] =
[Add missing files
Ian Lynagh **20080904100951] =
[Remerge concurrent,unique,timeout,st,getopt into base
Ian Lynagh **20080903201908] =
[remove 'pure' method from Arrow class (#2517)
Ross Paterson **20080903144436] =
[make Typeable instances for larger tuples available to non-GHC
Ross Paterson **20080903113543] =
[Don't look for actual OldException.Exception exceptions
Ian Lynagh **20080902224730
We don't actually throw them (we throw the new Exception equivalents
instead), and looking for them was causing an infinite loop
] =
[add include/CTypes.h to extra-source-files
Ross Paterson **20080902153029] =
[avoid relying on the implementation of SomeException
Ross Paterson **20080902080113
=
This is because Hugs uses a different implementation.
No semantic change.
] =
[non-GHC: leave out Belch functions
Ross Paterson **20080831180227] =
[non-GHC: add Typeable instance for ForeignPtr
Ross Paterson **20080831180048] =
[docs: mention that killThread on a completed thread is a no-op
Simon Marlow **20080902093126] =
[#2528: reverse the order of args to (=3D=3D) in nubBy to match nub
Simon Marlow **20080902092950
This only makes a difference when the (=3D=3D) definition is not
reflexive, but strictly speaking it does violate the report definition
of nubBy, so we should fix it.
] =
[System.Timeout is no longer part of base
Malcolm.Wallace@cs.york.ac.uk**20080901145738] =
[getopt is no longer part of base
Malcolm.Wallace@cs.york.ac.uk**20080827145336] =
[Split syb off into its own package
Ian Lynagh **20080825214144
I've also moved the Data (Complex a) instance into it, and made it
portable rather than GHC-only in the process.
] =
[add extra-source-files field
Ross Paterson **20080825231317] =
[Fix warnings in PrelIOUtils.c
Ian Lynagh **20080825141841] =
[Windows-only fixes for moving concurrent out of base
Ian Lynagh **20080824164146] =
[Split off the concurrent hierarchy (concurrent, unique, timeout)
Ian Lynagh **20080824123956] =
[Split getopt off into its own package
Ian Lynagh **20080824020213] =
[Remove ST stuff that is now in the new st package
Ian Lynagh **20080823223014] =
[Fix Windows-only warnings
Ian Lynagh **20080823002249] =
[Fix Windows-only warnings in GHC.Conc
Ian Lynagh **20080822234837] =
[Suppress some warnings that are hard to fix because of ifdefs
Ian Lynagh **20080822233951] =
[Provide blockedOnDeadMVar, blockedIndefinitely for the RTS
Ian Lynagh **20080821110723] =
[Fix more warnings
Ian Lynagh **20080820233958] =
[Suppress a couple of warnings in GHC.PArr
Ian Lynagh **20080820232018
The fix isn't immediately obvious to me
] =
[Fix more warnings
Ian Lynagh **20080820231937] =
[Fix warnings in Data.Generics.*
Ian Lynagh **20080820230437] =
[Fix some more warnings
Ian Lynagh **20080820223252] =
[Ignore some orphan warnings
Ian Lynagh **20080820211901] =
[remove some functions that aren't used in base
Simon Marlow **20080821142339] =
[remove __hscore_renameFile, it is no longer uesd
Simon Marlow **20080818155950
System.Directory implements renameFile using unix/Win32 now.
] =
[Rewrite the documentation for forkOS again
Simon Marlow **20080818132856
Try to make it clearer that forkOS is only necessary when calling
foreing libraries that use thread-local state, and it has nothing to
do with scheduling behaviour between Haskell threads. I also added
something about the performance impact of forkOS, and mentioned that
the main thread is a bound thread.
] =
[nhc only: expose Foldable and Traversable instances of Array
Ross Paterson **20080817002719
=
These were turned off as a side-effect of a previous nhc-only fix for
#2176 that is no longer needed. They should be fine for nhc now.
] =
[Fix hReady (trac #1063)
Ian Lynagh **20080816182715
We now throw an EOF exception when appropriate
] =
[Fix oversight in Control.OldException
Bertram Felgenhauer **20080816132631
The NonTermination constructor slipped through in the Exception instance.
] =
[Eliminate orphan rules and instances in the array package
Ian Lynagh **20080816122253] =
[Control.OldException: Map exceptions to old exceptions and back properly.
Ian Lynagh **20080814210219
* Control.OldException: Map exceptions to old exceptions and back proper=
ly.
=
It's really necessary to map them back as well, or the RTS and base librar=
y
will not recognize exceptions that got caught and rethrown. (See #2508)
=
Patch from Bertram Felgenhauer
] =
[add Traversable generalizations of mapAccumL and mapAccumR (#2461)
Ross Paterson **20080814162617] =
[simplify definition of Prelude.catch
Ross Paterson **20080814143650] =
[remove returns from void functions
Ross Paterson **20080814110841] =
[No reason for Handler and catches to exclude nhc98.
Malcolm.Wallace@cs.york.ac.uk**20080813125850] =
[Must import ExitCode for its instance to be re-exported.
Malcolm.Wallace@cs.york.ac.uk**20080813125710
The Cabal library depends on "instance Exception ExitCode", and expects
to import it from Control.Exception, not Control.Exception.Base.
] =
[use New.catch instead of catchException in OldException
Ross Paterson **20080813071307] =
[use the Haskell 98 module Control.Exception.Base in the Concurrent modules
Ross Paterson **20080813000219] =
[export Control.Exception.Base
Ross Paterson **20080812233640] =
[use dummy implementation of timeout for all non-GHCs
Ross Paterson **20080812151602] =
[Hugs only: fix imports
Ross Paterson **20080812145654] =
[non-GHC: hide Prelude.catch
Ross Paterson **20080812145622] =
[add Control.Exception.Base to nhc98 build
Malcolm.Wallace@cs.york.ac.uk**20080812174300] =
[bump to version 4.0
Simon Marlow **20080805153354] =
[Hugs only: don't import exception types -- their instances are now in Cont=
rol.Exception.Base
Ross Paterson **20080812140433] =
[split most of Control.Exception into new Control.Exception.Base
Ross Paterson **20080812124912
=
Move everything but catches/Handler into a new internal module.
This was needed to get the new exceptions working with Hugs, because Hugs
has the constraint that all Haskell 98 library modules, and everything
they include, must be Haskell 98. This also involves a different
representation of SomeException for Hugs, so that type is exported
opaquely for Hugs. Then Control.Exception.Base is Haskell 98 as far as
Hugs is concerned, but Control.Exception needs the extensions turned on.
=
Control.Exception re-exports everything from Control.Exception.Base
except the functions used by the GHC runtime.
] =
[remove kludges, now that Control.Exception is imported
Ross Paterson **20080811180328] =
[threadDelay and friends are GHC-only
Ross Paterson **20080811175039] =
[fix imports for non-GHC
Malcolm.Wallace@cs.york.ac.uk**20080808092017] =
[Eq and Ord have moved into GHC.Classes
Ian Lynagh **20080807095352] =
[Use the proper CInt type in GHC.Unicode
Ian Lynagh **20080806232948] =
[Import wibbles
Ian Lynagh **20080806232055] =
[Remove unnecessary Data/Dynamic.hs-boot
Ian Lynagh **20080806230623] =
[Remove more redundant GHC.Float imports
Ian Lynagh **20080806225411] =
[Remove an unnecessary import
Ian Lynagh **20080806224742] =
[Move Int, Float and Double into ghc-prim:GHC.Types
Ian Lynagh **20080806191554] =
[Put some explicit import lists in Data.Typeable
Ian Lynagh **20080806190353] =
[Fix a couple of imports
Ian Lynagh **20080806165549] =
[Remove unused conditional import
Ian Lynagh **20080806124930] =
[Swap imports around to get GHC.ForeignPtr out of the base knot
Ian Lynagh **20080806121313] =
[Move some bits around to stop Data.Either being in the base import knot
Ian Lynagh **20080806120504] =
[Tweak an import
Ian Lynagh **20080806000440] =
[Remove the DynIOError constructor of IOErrorType
Ian Lynagh **20080805234720
As far as I can see it is never used or exported
] =
[Move some internals around to simplify the import graph a bit
Ian Lynagh **20080805221341] =
[Move the Char datatype into ghc-prim
Ian Lynagh **20080805204009] =
[Remove an unnecessary import
Ian Lynagh **20080805182336] =
[The [] definition has moved to ghc-prim
Ian Lynagh **20080805182332] =
[Fix warnings
Ian Lynagh **20080805150250] =
[Add a missing case to Show AsyncException
Ian Lynagh **20080805142811] =
[Remove GHC.Dotnet
Ian Lynagh **20080804215840] =
[Hide standalone deriving clauses from haddock
Ian Lynagh **20080804211617] =
[Control.Exception doesn't need to export assertError
Ian Lynagh **20080804161838] =
[Generalise the type of mapException; pointed out by Isaac Dupree
Ian Lynagh **20080804160941] =
[Remove some unnecessary Data.Tuple imports
Ian Lynagh **20080804155956] =
[The tuple datatype definitions have moved to ghc-prim
Ian Lynagh **20080804155420] =
[make ExitCode an instance of Exception for nhc98
Malcolm.Wallace@cs.york.ac.uk**20080805160330] =
[poke and peek come from Foreign.Storable
Malcolm.Wallace@cs.york.ac.uk**20080804160616] =
[zipWithM_ comes from Control.Monad
Malcolm.Wallace@cs.york.ac.uk**20080804160319] =
[Fix nhc98 code variations to use the extensible exception API.
Malcolm.Wallace@cs.york.ac.uk**20080804155842
There is still only one real exception type in nhc98, so it is not truly
extensible. But this is enough to get the base package building again.
] =
[nhc98 needs the Prelude for this module
Malcolm.Wallace@cs.york.ac.uk**20080804133853] =
[Change some imports and derive Show (Either a b)
Ian Lynagh **20080804004147
rather than writing it by hand in GHC.Show
] =
[Windows fixes
Ian Lynagh **20080803180345] =
[Remove the duplicate definition of throwTo in Control.Exception
Ian Lynagh **20080803141703
It now imports GHC.Conc, so it is no longer necessary
] =
[Remove the only import of GHC.Exts
Ian Lynagh **20080803141944] =
[Move assertError into GHC.IOBase
Ian Lynagh **20080803141040] =
[Use onException rather than catchAny
Ian Lynagh **20080803114104] =
[Generalise the type of onException
Ian Lynagh **20080803003001
The type of the thing to do on an exception is now
IO b
rather than
IO ()
which better matches functions like bracket.
] =
[Remove the dangerous Exception functions
Ian Lynagh **20080802231358
Removed: catchAny, handleAny, ignoreExceptions
These make it easy to eat /any/ exception, which is rarely what you want.
Normally you either want to:
* only catch exceptions in a certain part of the hierarchy, e.g.
"file not found", in which case you should only catch exceptions
of the appropriate type,
or
* you want to do some cleanup when an exception happens, and then rethrow
the exception, in which case you should use onException, or one of the
bracketing functions.
] =
[Remove an unused import
Ian Lynagh **20080801230343] =
[Remove unused imports
Ian Lynagh **20080801230059] =
[Remove unused imports in Control.Exception
Ian Lynagh **20080801225847] =
[Get rid of some duplicate imports
Ian Lynagh **20080801214933] =
[Remove the now-unused GHC/Conc.lhs-boot
Ian Lynagh **20080801214707] =
[Make some more imports non-recursive
Ian Lynagh **20080801214546] =
[Rejig some code so Control.Exception and GHC.Conc don't need recursive imp=
orts
Ian Lynagh **20080801214208] =
[Remove the now-unused GHC/TopHandler.lhs-boot
Ian Lynagh **20080801212105] =
[Reshuffle GHC.Conc/GHC.TopHandler a bit to remove a recursive import
Ian Lynagh **20080801211801] =
[Don't import Control.Concurrent.MVar in GHC.TopHandler
Ian Lynagh **20080801200123] =
[Export assertError from Control.Exception to make GHC happy
Ian Lynagh **20080801111716
It's a wired-in name in GHC. We should possibly move it to another module.
] =
[TopHandler now uses the new extensible exceptions
Ian Lynagh **20080731153553] =
[Comment wibble
Ian Lynagh **20080730202127] =
[Make numericEnumFrom more efficient
Ian Lynagh **20080730202049] =
[Put in some parens to clarify how things parse
Ian Lynagh **20080730201934] =
[applied patches to make enumFrom and friends strict in arguments as per th=
e Report; closes ticket #1997
Bart Massey **20080726080444] =
[Don't use "deriving Typeable" (for portability reasons)
Ian Lynagh **20080730194434] =
[Add onException
Ian Lynagh **20080730172014] =
[Fix whitespace
Ian Lynagh **20080730171951
The space after "\begin{code}" was confusing haddock
] =
[Re-add blocked; it got lost in the extensible exceptions patches
Ian Lynagh **20080730145614] =
[Start to actually use extensible exceptions
Ian Lynagh **20080730145115] =
[Rejig the extensible exceptions so there is less circular importing
Ian Lynagh **20080730122539] =
[Define nonTermination for the RTS to use
Ian Lynagh **20080621144420
We'll probably need to do the same for some other exceptions too
] =
[Use extensible exceptions at the lowest level
Ian Lynagh **20080621121501
Everything above is largely unchanged; just the type of catch and throw.
] =
[add comment
Simon Marlow **20080730114559] =
[add some big warnings to the docs for unsafeIOToSTM (#2401)
Simon Marlow **20080730114554] =
[FIX #2376: inline shiftR
Simon Marlow **20080730103539
Duplicating the default definition for shiftR doesn't seem quite right
to me, but it gets the right results when compiling the example
program, and I couldn't find a better way to do it.
] =
[Add instance Show Control.Exception.Exception for nhc98.
Malcolm.Wallace@cs.york.ac.uk**20080728164537] =
[Extend nhc98's Exception type to resemble ghc's more closely
Malcolm.Wallace@cs.york.ac.uk**20080728163445] =
[fix dummy async implementations for non-GHC
Ross Paterson **20080715125521] =
[Fix haddocking with older haddocks
Ian Lynagh **20080710190855] =
[Add threadStatus :: ThreadId -> IO ThreadStatus
Simon Marlow **20080710151711
=
-- | The current status of a thread
data ThreadStatus
=3D ThreadRunning
-- ^the thread is currently runnable or running
| ThreadFinished
-- ^the thread has finished
| ThreadBlocked BlockReason
-- ^the thread is blocked on some resource
| ThreadDied
-- ^the thread received an uncaught exception
deriving (Eq,Ord,Show)
=
data BlockReason
=3D BlockedOnMVar
-- ^blocked on on 'MVar'
| BlockedOnBlackHole
-- ^blocked on a computation in progress by another thread
| BlockedOnException
-- ^blocked in 'throwTo'
| BlockedOnSTM
-- ^blocked in 'retry' in an STM transaction
| BlockedOnForeignCall
-- ^currently in a foreign call
| BlockedOnOther
-- ^blocked on some other resource. Without @-threaded@,
-- I/O and 'threadDelay' show up as 'BlockedOnOther', with @-threa=
ded@
-- they show up as 'BlockedOnMVar'.
deriving (Eq,Ord,Show)
=
This is useful for concurrency debugging. I've left threadStatus in
GHC.Conc for now, since the ThreadStatus type is somewhat GHC-specific.
] =
[forkOS: start the new thread in blocked mode iff the parent was (#1048)
Simon Marlow **20080709135558
This matches the behaviour of forkIO
] =
[Add Control.Exception.blocked :: IO Bool
Simon Marlow **20080709133139
Tells you whether async exceptions are currently blocked or not.
] =
[FIX BUILD (on Windows)
Simon Marlow **20080709123110] =
[check CONST_SIGINT
Simon Marlow **20080709122527] =
[Make threadWaitRead/threadWaitWrite partially useable on Windows
Simon Marlow **20080709111008
=
They work with -threaded by calling fdReady() in a separate thread.
=
"threadWaitRead 0" also works without -threaded (because we happen to
know it's virtually equivalent to "hWaitForInput stdin (-1)").
] =
[FIX #1198: hWaitForInput on Windows
Simon Marlow **20080708134254
Now we do the appropriate magic in fdReady() to detect when there is
real input available, as opposed to uninteresting console events.
] =
[FIX part of #2301
Simon Marlow **20080709094437
=
Control-C now causes the new exception (AsyncException UserInterrupt)
to be raised in the main thread. The signal handler is set up by
GHC.TopHandler.runMainIO, and can be overriden in the usual way by
installing a new signal handler. The advantage is that now all
programs will get a chance to clean up on ^C.
=
When UserInterrupt is caught by the topmost handler, we now exit the
program via kill(getpid(),SIGINT), which tells the parent process that
we exited as a result of ^C, so the parent can take appropriate action
(it might want to exit too, for example).
=
One subtlety is that we have to use a weak reference to the ThreadId
for the main thread, so that the signal handler doesn't prevent the
main thread from being subject to deadlock detection.
] =
[() has moved to ghc-prim:GHC.Unit, and the Eq and Ord instances to Data.Tu=
ple
Ian Lynagh **20080624144932] =
[Add GHC.Exts.maxTupleSize :: Int, the size of the largest tuple supported
Ian Lynagh **20080622141559] =
[Remove code for older GHC versions
Ian Lynagh **20080620194521] =
[Make the macros in Typeable.h add type signatures
Ian Lynagh **20080619235808] =
[Fix #2363: getChar cannot be interrupted with -threaded
Simon Marlow **20080619141911
Now in -threaded mode, instead of just making a blocking call to
read(), we call select() first to make sure the read() won't block,
and if it would block, then we use threadWaitRead.
=
The idea is that the current thread must be interruptible while it
blocks. This is a little slower than before, but the overhead only
applies to blocking Handles (stdin/stdout/stderr, and those created by
System.Process).
] =
[Remove -fglasgow-exts from pragmas and comments
Ian Lynagh **20080616230727] =
[Avoid using deprecated flags
Ian Lynagh **20080616145207] =
[delete __hscore_{mkstemp,getrlimit,setrlimit} (moved to unix)
Ross Paterson **20080615224413] =
[Update WCsubst.c for Unicode 5.1.0, and add a README.Unicode
Ian Lynagh **20080613201754
README.Unicode describes how to do updates in the future.
] =
[Fix ubconfc
Ian Lynagh **20080613201456
The current code doesn't seem to be what was used to generate WCsubst.c,
so I'm not sure if it never worked, or if my tools work slightly
differently to those of the previous user.
] =
['permutations' is now more lazy and also faster
Twan van Laarhoven **20080102231712] =
['subsequences' is now more lazy and also faster
Twan van Laarhoven **20080102231629] =
[Add 'subsequences' and 'permutations' to Data.List
Twan van Laarhoven **20071218154950] =
[Tweak the definition of (^) again
Ian Lynagh **20080601120759
This fixes trac #2306 (do the minimum number of (*)s), and also means
that we don't use the value of (1 :: a) which causes problems if the
Num a definition isn't complete.
] =
[note about evaluation affecting StableNames
Simon Marlow **20080527110549] =
[TAG 2008-05-28
Ian Lynagh **20080528003830] =
Patch bundle hash:
525406fd5ead4fca8b9b099f3b4b649c8a09ec66
--=_--
.