Delphi Language Guide Delphi for Microsoft Win32 Delphi for the Microsoft. Net framework

Shared-Memory Manager (Win32 Only)
On Win32, if a DLL exports routines that pass long strings or dynamic arrays as parameters or function results
(whether directly or nested in records or objects), then the DLL and its client applications (or DLLs) must all use the
ShareMem unit. The same is true if one application or DLL allocates memory with 
New
 or 
GetMem
 which is
deallocated by a call to Dispose or FreeMem in another module. ShareMem should always be the first unit listed in
any program or library uses clause where it occurs.
ShareMem is the interface unit for the BORLANDMM.DLL memory manager, which allows modules to share
dynamically allocated memory. BORLANDMM.DLL must be deployed with applications and DLLs that use
ShareMem. When an application or DLL uses ShareMem, its memory manager is replaced by the memory manager
in BORLANDMM.DLL.
185

---

Packages
The following topics describe packages and various issues involved in creating and compiling them.
Package declarations and source files
Naming packages
The requires clause
Avoiding circular package references
Duplicate package references
The contains clause
Avoiding redundant source code uses
Compiling packages
Generated files
Package-specific compiler directives
Package-specific command-line compiler switches