|Title||Purpose of reservoirs is unclear|
|Assigned user||Richard Brooksby|
|Description||The external interface to the MPS contains these symbols that directly refer to the "reservoir":|
In addition, the documentation for these symbols refers to the reservoir:
I cannot document these symbols without understanding the purpose of the reservoir. There's a design document  but this just says, "The low-memory reservoir provides client support for implementing handlers for low-memory situations which allocate" which isn't clear enough to turn into user documentation.
|Analysis||RB dislikes the reservoir design (it causes a proliferation of "reservoir" versions of symbols in the code), so maybe the best thing to do is to deprecate the thing and start again? Needs thought, anyway.|
GDR: for the moment I've not documented any of the symbols with "reservoir" in their names, and for mps_sac_alloc I've just said to pass false for the "has_reservoir_permit" argument.
|Created by||Gareth Rees|
|Created on||2012-10-19 14:13:08|
|Last modified by||Richard Brooksby|
|Last modified on||2016-03-15 13:22:57|
|History||2012-10-19 GDR Created.|
|190106||closed||2016-03-15 13:19:27||Richard Brooksby||Merging branch mps/branch/2016-03-13/without-reservation into master sources.|