Changeset 411

Timestamp:

Apr 8, 2004, 7:16:54 PM (22 years ago)

Author:

Paul Price

Message:

Declared that psFree will generate an error if the reference counter
!= 1.

File:

• trunk/doc/pslib/psLibSDRS.tex (modified) (4 diffs)

trunk/doc/pslib/psLibSDRS.tex

@@ -1 @@
-%%% $Id: psLibSDRS.tex,v 1.35 2004-04-09 01:29:44 price Exp $
+%%% $Id: psLibSDRS.tex,v 1.36 2004-04-09 05:16:54 price Exp $
 \documentclass[panstarrs]{panstarrs}
 
@@ -486 +486 @@
 management routines respect the use of the \code{refCounter} field:
 \code{psFree} will not free a block for which \code{refCounter != 1},
-and \code{psAlloc} will initialize the field to 1.  \tbd{should psFree
-give an error if refCounter $>$ 1 or actually do the decrement?}
-However, they do not (and cannot practically) enforce the use of the
-counters; this is a requirement of external APIs which intend to use
-the feature.
+and \code{psAlloc} will initialize the field to 1.  \tbd{\code{psFree}
+should generate an error if \code{refCounter != 1}.}  However, they do
+not (and cannot practically) enforce the use of the counters; this is
+a requirement of external APIs which intend to use the feature.
 
 Several APIs are provided to manage the reference counters.  These
@@ -510 +509 @@
 be in the valid range and should correspond to the address of the
 \code{psMemBlock}).  For an example implementation of the
-\code{refCounter} facilities, see the discussion of \code{psDlist}.
-
-\tbd{REF}.
+\code{refCounter} facilities, see the discussion of \code{psDlist}
+(\S\ref{sec:psDlist}).
 
 \subsubsection{Relation of Memory Management to Structures}
@@ -1025 +1023 @@
 
 \subsection{Doubly-linked lists}
-\hlabel{psDlist}
+\label{sec:psDlist}
 
 \PS{} supports doubly linked lists through a type \code{psDlist}: