Cheng Shao authored 1 year ago and Marge Bot committed 1 year ago

We used to have MIN_UPD_SIZE macro that describes the minimum reserved
size for thunks, so that the thunk can be overwritten in place as
indirections or blackholes. However, this macro has not been actually
defined or used anywhere since a long time ago; StgThunkHeader already
reserves a padding word for this purpose. Hence this patch which drops
stale mentions of MIN_UPD_SIZE.

Sylvain Henry authored 5 years ago and Marge Bot committed 5 years ago

Update Haddock submodule

Metric Increase:
   haddock.compiler

Artem Pelenitsyn authored 6 years ago and Ben Gamari committed 6 years ago

FIxes #15189.

Reviewers: hvr, bgamari, simonmar, simonpj

Reviewed By: simonpj

Subscribers: simonpj, rwbarton, thomie, carter

GHC Trac Issues: #15189

Differential Revision: https://phabricator.haskell.org/D5019

Summary:
We currently have two info tables for a constructor

* XXX_con_info: the info table for a heap-resident instance of the
  constructor, It has type CONSTR, or one of the specialised types like
  CONSTR_1_0

* XXX_static_info: the info table for a static instance of this
  constructor, which has type CONSTR_STATIC or CONSTR_STATIC_NOCAF.

I'm getting rid of the latter, and using the `con_info` info table for
both static and dynamic constructors.  For rationale and more details
see Note [static constructors] in SMRep.hs.

I also removed these macros: `isSTATIC()`, `ip_STATIC()`,
`closure_STATIC()`, since they relied on the CONSTR/CONSTR_STATIC
distinction, and anyway HEAP_ALLOCED() does the same job.

Test Plan: validate

Reviewers: bgamari, simonpj, austin, gcampax, hvr, niteria, erikd

Subscribers: thomie

Differential Revision: https://phabricator.haskell.org/D2690

GHC Trac Issues: #12455

Note: the haddock comment in TyCon.hs seems to be
      garbled syntactically and grammatically

Most of the other users of the fptools build system have migrated to
Cabal, and with the move to darcs we can now flatten the source tree
without losing history, so here goes.

The main change is that the ghc/ subdir is gone, and most of what it
contained is now at the top level.  The build system now makes no
pretense at being multi-project, it is just the GHC build system.

No doubt this will break many things, and there will be a period of
instability while we fix the dependencies.  A straightforward build
should work, but I haven't yet fixed binary/source distributions.
Changes to the Building Guide will follow, too.

Move the RTS document into the ghc tree where it belongs.

Minor documentation fixes, and addition of SRT explanation.

Several updates, mainly to the "heap objects" section.

updates

Added CAF text to rts document

Correct a couple of things: WHNF closures can be partial applications
as well as constructors.

Numerous small changes

	* update layout of info tables.
	* macros \Section, \Subsection etc. for making labels more
	  consistent.
	* macros \secref, \figref for consistent cross-references.
	* fix some cross references.
	* lots of other small changes.

A major rewrite/reorganisation.
New material on bytecodes.
Deleted some of the really out of date stuff about the old system
 (You might have to checkout the previous revision if you need
  historical info.)
I have not merged the sections on TSOs and Stacks.
 SimonM has a clearer idea of what the TSO status words look like and
 I think he said he'd written a new section with stacks part of TSOs.

Added an overview section, commented out some of the more bogus parts of the document (but some bits still remain)

couple of minor fixes

Added 'standard closures' to discussion of how Hugs enters an object

Improved glossary/terminology at start - added unpointed and unboxed.
Created a section at start to describe the source language.  At the moment,
 all it contains is a description of unboxed tuple constructors.
Replaced erroneous uses of "closure" with "heap object".  According to
 the glossary, closures are enterable - things like stack objects
 are not enterable so they can't be closures.
Clarified section 2.7 (heap and stack checks): why should we not move Hp
 during heap check?
Added comment that I don't believe in the notion of fixed headers.

Latest batch of changes.  Merge SRT and Tag fields in the info table,
now that there isn't a bytecode pointer there.

new pictures

latest round of changes.

today's changes.

outstanding changes

finished today's changes.

add RTS draft document

add RTS document into the tree