Programmer's Reference

Shared pool accessing

addSharedPoolName:, allSharedPoolNames, removeSharedPoolName:, setSharedPoolNames:, sharedPoolNames

Note:
The Blue Book defines the messages addSharedPool:, allSharedPools, removeSharedPool:, and sharedPools, but it takes an inconsistent approach to identifying the shared pool dictionary, referencing it sometimes by name and other times by value. We decided to standardize on reference by name, and appended the suffix Name to the messages to reinforce this point. The aggregate message setSharedPoolNames: is a basic accessor that works outside the source code manager. There is no Blue Book equivalent to setSharedPoolNames:.
Porting tip:
Not supported by Smalltalk/V or Objectworks\Smalltalk. Smalltalk/V provides instead the messages addSharedPool:, removeSharedPool:, sharedPool, and sharedPool:. Objectworks\Smalltalk provides the Blue Book messages noted above in the Rationale; however, it changes the Blue Book semantics to always use reference by value.
Tip:
Using setSharedPoolNames: will make the image inconsistent with the source code management system. This method should only be sent by experienced developers who are certain of the outcome.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]