summaryrefslogtreecommitdiff
path: root/ghc/docs/users_guide/using.sgml
Commit message (Collapse)AuthorAgeFilesLines
* [project @ 2004-08-15 20:37:22 by panne]panne2004-08-151-1751/+0
| | | | | | Started to convert the users guide to DocBook XML. Not yet finished, there are still *tons* of misplaced indexterms, but some sensible documentation can already be generated.
* [project @ 2004-08-08 20:46:44 by panne]panne2004-08-081-7/+7
| | | | | DocBook XML is case-sensitive. Note that this is still not correct DocBook, tons of indexterm elements within varlistentries are still misplaced.
* [project @ 2004-08-08 17:26:26 by krasimir]krasimir2004-08-081-190/+190
| | | | xmlize sgml docbooks
* [project @ 2004-06-22 13:47:27 by simonpj]simonpj2004-06-221-1/+1
| | | | Clarify words about the -package flag
* [project @ 2003-12-16 16:17:49 by simonpj]simonpj2003-12-161-2/+11
| | | | Clarify warn-unused-bindings documention
* [project @ 2003-11-27 13:27:11 by simonmar]simonmar2003-11-271-48/+9
| | | | Document UNPACK pragma
* [project @ 2003-09-23 16:01:22 by simonmar]simonmar2003-09-231-17/+14
| | | | Some wibbles to the optimisation section.
* [project @ 2003-09-04 13:58:12 by simonmar]simonmar2003-09-041-235/+326
| | | | | | | | | | | - Document -e - Rearrange the documentation on "modes". I've moved the list of modes from the beginning of "Using GHC", to a subsection a little later, and the sections describing make-mode and batch-mode are now further subsections of this. - Add missing modes to the list: -M and --mk-dll.
* [project @ 2003-08-27 13:28:01 by panne]panne2003-08-271-0/+2
| | | | Added short option -V for long option --version
* [project @ 2003-07-21 15:24:42 by simonmar]simonmar2003-07-211-263/+2
| | | | | | | Update the documentation for filenames and related options to reflect the new story. Now we talk about hierarchical modules from the outset, and hopefully the whole description is somewhat clearer than before.
* [project @ 2003-06-25 08:20:20 by simonpj]simonpj2003-06-251-0/+14
| | | | | | | | * Remove -ffoldr-build-on Add -rrules-off Document the change * Document -fwarn-simple-patterns more
* [project @ 2003-03-11 09:08:38 by simonpj]simonpj2003-03-111-1/+5
| | | | Document external core a bit more
* [project @ 2003-02-20 18:27:13 by simonpj]simonpj2003-02-201-0/+4
| | | | Document {-# CORE #-} pragma (thanks to Hal Daume)
* [project @ 2003-01-23 14:55:36 by simonpj]simonpj2003-01-231-4/+19
| | | | Document warning suppression with leading underscore on variable names
* [project @ 2003-01-08 10:10:19 by simonmar]simonmar2003-01-081-7/+8
| | | | | | | | Update the documentation on --make mode to indicate that multiple sources/modules can be given on the command line, as well as multiple object files. MERGE TO STABLE
* [project @ 2002-11-20 09:37:45 by simonpj]simonpj2002-11-201-0/+9
| | | | | | | | | | | | | ----------------------------------------------- Add -Werror flag, which makes warnings fatal ----------------------------------------------- -Werror is standard gcc-ism; it makes warnings into fatal errors so you don't miss them in a batch compile. Fairly easy to implement, by modifying ErrUtils.errorsFound Suggested by Ashley Yakeley
* [project @ 2002-10-11 08:04:55 by simonpj]simonpj2002-10-111-6/+10
| | | | Add an example about -osuf etc
* [project @ 2002-09-26 09:01:34 by simonpj]simonpj2002-09-261-0/+10
| | | | Notes on .exe files
* [project @ 2002-06-27 12:17:47 by simonmar]simonmar2002-06-271-0/+6
| | | | Improve the documentation for hierarchical libraries.
* [project @ 2002-06-25 12:05:14 by simonmar]simonmar2002-06-251-21/+16
| | | | | | | Various hacking on the User's Guide to knock it into shape for the release. Committers: please take a look at the 5.04 release notes and feel free to tweak or embelish the description for your favourite new feature.
* [project @ 2002-01-04 10:18:58 by simonmar]simonmar2002-01-041-22/+22
| | | | | Replace all instances of '--' with '––' since '--' gets interpreted by JadeTeX to mean a single dash.
* [project @ 2001-12-18 13:03:12 by simonmar]simonmar2001-12-181-18/+0
| | | | | | | | | Nuke -O2-for-C, since it can cause gcc to generate incorrect code, and doesn't seem to help much. Add a comment about this in the 5.02 release notes, saying you can still use -optc-O2 if you really want to. (merged from rev. 1.47.2.3)
* [project @ 2001-10-29 13:42:52 by simonmar]simonmar2001-10-291-34/+50
| | | | | - document --print-libdir - replace some <literal>s with <option>s where appropriate
* [project @ 2001-09-14 15:53:41 by sewardj]sewardj2001-09-141-2/+2
| | | | | | merge rev 1.47.2.1: * typo ('-help' -> '--help')
* [project @ 2001-09-06 15:54:48 by apt]apt2001-09-061-0/+34
| | | | document -fext-core flag and set pointers to ext-core docs/tools (MERGE to STABLE pleeeeeease.)
* [project @ 2001-08-23 10:02:46 by simonmar]simonmar2001-08-231-55/+54
| | | | markup fixes
* [project @ 2001-08-23 08:54:45 by simonmar]simonmar2001-08-231-2/+8
| | | | | Put a big flashing warning sign next to the description of -O2-for-C, and don't endorse it by claiming that we actually use it (we don't).
* [project @ 2001-08-21 09:36:15 by simonmar]simonmar2001-08-211-1/+11
| | | | document the requirement for source files in --make.
* [project @ 2001-05-31 12:40:59 by simonmar]simonmar2001-05-311-0/+35
| | | | | | | - document -hidir option - move -ohi documentation to "redirecting output" section - remove duplicate -ohi in the flags table. - add a warning about -ohi confusing the recompilation checker.
* [project @ 2001-05-09 09:43:44 by simonmar]simonmar2001-05-091-24/+22
| | | | Document -hcsuf option
* [project @ 2001-04-30 12:09:09 by simonmar]simonmar2001-04-301-19/+32
| | | | document -fwarn-misc.
* [project @ 2001-03-22 12:12:23 by simonmar]simonmar2001-03-221-5/+5
| | | | | | | | | Move the bug reporting section earlier, and mention the SourceForge bug tracker. Update the release notes. I think I'm just about done in here...
* [project @ 2001-03-22 03:51:08 by hwloidl]hwloidl2001-03-221-87/+137
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | -*- outline -*- Time-stamp: <Thu Mar 22 2001 03:50:16 Stardate: [-30]6365.79 hwloidl> This commit covers changes in GHC to get GUM (way=mp) and GUM/GdH (way=md) working. It is a merge of my working version of GUM, based on GHC 4.06, with GHC 4.11. Almost all changes are in the RTS (see below). GUM is reasonably stable, we used the 4.06 version in large-ish programs for recent papers. Couple of things I want to change, but nothing urgent. GUM/GdH has just been merged and needs more testing. Hope to do that in the next weeks. It works in our working build but needs tweaking to run. GranSim doesn't work yet (*sigh*). Most of the code should be in, but needs more debugging. ToDo: I still want to make the following minor modifications before the release - Better wrapper skript for parallel execution [ghc/compiler/main] - Update parallel docu: started on it but it's minimal [ghc/docs/users_guide] - Clean up [nofib/parallel]: it's a real mess right now (*sigh*) - Update visualisation tools (minor things only IIRC) [ghc/utils/parallel] - Add a Klingon-English glossary * RTS: Almost all changes are restricted to ghc/rts/parallel and should not interfere with the rest. I only comment on changes outside the parallel dir: - Several changes in Schedule.c (scheduling loop; createThreads etc); should only affect parallel code - Added ghc/rts/hooks/ShutdownEachPEHook.c - ghc/rts/Linker.[ch]: GUM doesn't know about Stable Names (ifdefs)!! - StgMiscClosures.h: END_TSO_QUEUE etc now defined here (from StgMiscClosures.hc) END_ECAF_LIST was missing a leading stg_ - SchedAPI.h: taskStart now defined in here; it's only a wrapper around scheduleThread now, but might use some init, shutdown later - RtsAPI.h: I have nuked the def of rts_evalNothing * Compiler: - ghc/compiler/main/DriverState.hs added PVM-ish flags to the parallel way added new ways for parallel ticky profiling and distributed exec - ghc/compiler/main/DriverPipeline.hs added a fct run_phase_MoveBinary which is called with way=mp after linking; it moves the bin file into a PVM dir and produces a wrapper script for parallel execution maybe cleaner to add a MoveBinary phase in DriverPhases.hs but this way it's less intrusive and MoveBinary makes probably only sense for mp anyway * Nofib: - nofib/spectral/Makefile, nofib/real/Makefile, ghc/tests/programs/Makefile: modified to skip some tests if HWL_NOFIB_HACK is set; only tmp to record which test prgs cause problems in my working build right now
* [project @ 2001-03-15 16:17:06 by simonmar]simonmar2001-03-151-3/+18
| | | | document -fignore-asserts
* [project @ 2001-03-13 15:44:58 by simonpj]simonpj2001-03-131-21/+13
| | | | Remove docs for -funfolding-interface-threshold
* [project @ 2001-02-20 18:05:23 by simonmar]simonmar2001-02-201-1/+1
| | | | | | | More doc hacking. Call for Release Notes (CFRN): the 5-00-notes.sgml file is currently a skeleton only; PLEASE add or expand entries for things you've done.
* [project @ 2001-02-16 17:35:01 by simonmar]simonmar2001-02-161-298/+418
| | | | Today's doc hacking.
* [project @ 2001-02-15 17:33:53 by simonmar]simonmar2001-02-151-2334/+402
| | | | | More documentation rewriting... I'm particularly proud of the "flag reference" section, please check it out.
* [project @ 2001-02-13 18:08:44 by simonmar]simonmar2001-02-131-1414/+1839
| | | | beginnings of a documentation revamp
* [project @ 2000-11-13 14:34:03 by sewardj]sewardj2000-11-131-5/+8
| | | | Document change in behaviour of -E.
* [project @ 2000-10-09 16:51:01 by rrt]rrt2000-10-091-2/+9
| | | | Many fixes to make it DocBook friendly.
* [project @ 2000-10-04 11:23:01 by sewardj]sewardj2000-10-041-24/+27
| | | | Update packages stuff to track yesterday's changes to @data Package = ...@.
* [project @ 2000-09-26 15:58:25 by simonpj]simonpj2000-09-261-3/+29
| | | | | | | | Document the new behaviour of -fno-implicit-prelude. (I havn't checked that the new document builds right because my build tree doesn't seem to build documentation. Reuben, could you check, please.)
* [project @ 2000-09-14 13:46:39 by simonpj]simonpj2000-09-141-16/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | --------------------------------------- Simon's tuning changes: early Sept 2000 --------------------------------------- Library changes ~~~~~~~~~~~~~~~ * Eta expand PrelShow.showLitChar. It's impossible to compile this well, and it makes a big difference to some programs (e.g. gen_regexps) * Make PrelList.concat into a good producer (in the foldr/build sense) Flag changes ~~~~~~~~~~~~ * Add -ddump-hi-diffs to print out changes in interface files. Useful when watching what the compiler is doing * Add -funfolding-update-in-place to enable the experimental optimisation that makes the inliner a bit keener to inline if it's in the RHS of a thunk that might be updated in place. Sometimes this is a bad idea (one example is in spectral/sphere; see notes in nofib/Simon-nofib-notes) Tuning things ~~~~~~~~~~~~~ * Fix a bug in SetLevels.lvlMFE. (change ctxt_lvl to dest_level) I don't think this has any performance effect, but it saves making a redundant let-binding that is later eliminated. * Desugar.dsProgram and DsForeign Glom together all the bindings into a single Rec. Previously the bindings generated by 'foreign' declarations were not glommed together, but this led to an infelicity (i.e. poorer code than necessary) in the modules that actually declare Float and Double (explained a bit more in Desugar.dsProgram) * OccurAnal.shortMeOut and IdInfo.shortableIdInfo Don't do the occurrence analyser's shorting out stuff for things which have rules. Comments near IdInfo.shortableIdInfo. This is deeply boring, and mainly to do with making rules work well. Maybe rules should have phases attached too.... * CprAnalyse.addIdCprInfo Be a bit more willing to add CPR information to thunks; in particular, if the strictness analyser has just discovered that this is a strict let, then the let-to-case transform will happen, and CPR is fine. This made a big difference to PrelBase.modInt, which had something like modInt = \ x -> let r = ... -> I# v in ...body strict in r... r's RHS isn't a value yet; but modInt returns r in various branches, so if r doesn't have the CPR property then neither does modInt * MkId.mkDataConWrapId Arrange that vanilla constructors, like (:) and I#, get unfoldings that are just a simple variable $w:, $wI#. This ensures they'll be inlined even into rules etc, which makes matching a bit more reliable. The downside is that in situations like (map (:) xs), we'll end up with (map (\y ys. $w: y ys) xs. Which is tiresome but it doesn't happen much. * SaAbsInt.findStrictness Deal with the case where a thing with no arguments is bottom. This is Good. E.g. module M where { foo = error "help" } Suppose we have in another module case M.foo of ... Then we'd like to do the case-of-error transform, without inlining foo. Tidying up things ~~~~~~~~~~~~~~~~~ * Reorganised Simplify.completeBinding (again). * Removed the is_bot field in CoreUnfolding (is_cheap is true if is_bot is!) This is just a tidy up * HsDecls and others Remove the NewCon constructor from ConDecl. It just added code, and nothing else. And it led to a bug in MkIface, which though that a newtype decl was always changing! * IdInfo and many others Remove all vestiges of UpdateInfo (hasn't been used for years)
* [project @ 2000-08-18 10:50:37 by rrt]rrt2000-08-181-1/+1
| | | | Revoked comments about not using -static under Windows.
* [project @ 2000-08-09 13:37:56 by rrt]rrt2000-08-091-1/+1
| | | | | Updates to Windows docs to cope with changes in new Cygwin and head of tree GHC.
* [project @ 2000-08-03 11:34:41 by simonmar]simonmar2000-08-031-15/+10
| | | | | Update the documentation on the +RTS -C option, and remove the note saying that it doesn't work.
* [project @ 2000-08-03 10:19:40 by simonmar]simonmar2000-08-031-3/+4
| | | | | Add a cross-ref to the section on Packages from the mention of the -package flag in the section on linking.
* [project @ 2000-07-24 15:31:47 by simonmar]simonmar2000-07-241-15/+44
| | | | update documentation to reflect changes in the format of a package spec.
* [project @ 2000-07-23 10:53:11 by panne]panne2000-07-231-7/+6
| | | | | Strictfp-like behaviour is the default now, which can be switched off via -fexcess-precision. (Has anybody a better name for this option?)
View Lorry Controller Status