Index: /trunk/doc/pslib/psLibSDRS.tex
===================================================================
--- /trunk/doc/pslib/psLibSDRS.tex	(revision 7427)
+++ /trunk/doc/pslib/psLibSDRS.tex	(revision 7428)
@@ -1,3 +1,3 @@
-%%% $Id: psLibSDRS.tex,v 1.398 2006-06-07 04:06:37 price Exp $
+%%% $Id: psLibSDRS.tex,v 1.399 2006-06-08 20:05:47 price Exp $
 \documentclass[panstarrs,spec]{panstarrs}
 
@@ -445,4 +445,17 @@
 \end{prototype}
 
+Sometimes system code will need to allocate complex structures (such
+as a \code{psMetadata}) that must all be marked as \code{persistent}.
+To save this code the trouble of tracking down every allocated pointer
+to mark each \code{persistent}, we define an additional private
+function, \code{p_psMemAllocatePersistent}, that sets the use of
+\code{persistent} within \code{psAlloc}.  This allows us to call
+\code{p_psMemAllocatePersistent(true)}, allocate all our persistent
+memory, and then call \code{p_psMemAllocatePersistent(false)}.  The
+initial setting shall be for allocated memory not to be marked
+\code{persistent}.
+\begin{prototype}
+bool p_psMemAllocatePersistent(bool is_persistent);
+\end{prototype}
 
 The \code{psMemBlock} structure element \code{refCounter} is provided