MPS issue job001429

TitleMPS lacks documentation on how to use allocation points
Assigned userRichard Kistruck
DescriptionMPS lacks documentation on how to use allocation points

RHSK 2006-06-08
The [Reference Manual] does not document:
AnalysisRHSK 2006-06-08
Collect documentation here, and migrate it to Wiki or the
Reference Manual as it becomes mature enough.

Here's a start:

Some pool classes (eg LO) only support allocation through
allocation points.

Allocation points require the reserved size to be aligned to the
pool alignment (see AVER in mps_ap_fill), whereas mps_alloc does
not (it is up to the pool class, and poolmv for example does
SizeAlignUp on the size argument).

Normally, use mps_reserve and mps_commit.

If you are using a very weak compiler that does not detect common
subexpressions, you may find that replacing mps_reserve by
MPS_RESERVE_BLOCK (functionally identical) generates faster code.
Or it may generate slower code. It depends on your compiler, and
you will have to conduct tests to find out.

RHSK 2007-01-04
(2006-06-22, change 159369)
New wiki article: manual/wiki/apguide.html "Allocation Points -- User's Guide"
How foundunknown
Evidence[Reference Manual]: //
Observed in1.106.2
Created byRichard Kistruck
Created on2006-06-08 14:26:32
Last modified byGareth Rees
Last modified on2013-05-22 12:06:55
History2006-06-08 RHSK Created.
2007-01-04 RHSK Was fixed by new wiki article.


Change Effect Date User Description
180943 closed 2013-02-08 16:17:34 Richard Brooksby Integrating branch/2012-10-09/user-guide back to master.
159369 closed 2006-06-22 13:33:30 Richard Kistruck MPS wiki: move Allocation Points -- User's Guide into its own article