|Title||MPS lacks documentation on how to use allocation points|
|Assigned user||Richard Kistruck|
|Description||MPS lacks documentation on how to use allocation points|
The [Reference Manual] does not document:
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 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.
(2006-06-22, change 159369)
New wiki article: manual/wiki/apguide.html "Allocation Points -- User's Guide"
|Evidence||[Reference Manual]: |
|Created by||Richard Kistruck|
|Created on||2006-06-08 14:26:32|
|Last modified by||Gareth Rees|
|Last modified on||2013-05-22 12:06:55|
|History||2006-06-08 RHSK Created.|
2007-01-04 RHSK Was fixed by new wiki article.
|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|