Index: trunk/doc/pslib/psLibSDRS.tex
===================================================================
--- trunk/doc/pslib/psLibSDRS.tex	(revision 1693)
+++ trunk/doc/pslib/psLibSDRS.tex	(revision 1706)
@@ -1,3 +1,3 @@
-%%% $Id: psLibSDRS.tex,v 1.109 2004-09-07 00:52:16 eugene Exp $
+%%% $Id: psLibSDRS.tex,v 1.110 2004-09-07 23:23:02 price Exp $
 \documentclass[panstarrs,spec]{panstarrs}
 
@@ -35,4 +35,5 @@
    &             & (modified polynomials), ImageTrim for Phase 2. \\
    &             & Changed minimization. \\ \hline
+04-- & Various   & See Appendix A for a change log. \\ \hline
 \RevisionsEnd
 
@@ -174,10 +175,17 @@
 \begin{itemize}
 \item Set the error codes for PSLib.
+\item Seed the random number generator.
 \end{itemize}
 
 The prototype is:
 \begin{verbatim}
-void psLibInit(void)
-\end{verbatim}
+void psLibInit(bool predictable);
+\end{verbatim}
+
+If \code{predictable} is \code{true}, then the random number generator
+shall be seeded with a value that does not vary (allowing bugs relying
+on random numbers to be reproduced); otherwise, the random number
+generator shall be seeded from \code{/dev/random} if it exists,
+otherwise from the system clock.
 
 
@@ -2600,14 +2608,17 @@
 
 \begin{verbatim}
-psC64 psImagePixelInterpolate (const psImage *input, float x, float y,
-                               psC64 unexposedValue, psImageInterpolateMode mode);
+psC64 psImagePixelInterpolate(const psImage *input, float x, float y,
+                              const psImage *mask, unsigned int maskVal,
+			      psC64 unexposedValue, psImageInterpolateMode mode);
 \end{verbatim}
 Perform interpolation of image pixel values to the given fractional
 coordinate \code{x,y}.  The function returns the interpolated value of
 the image at the given fractional pixel coordinates, based on the
-specified interpolation \code{mode}.  This function will likely be
-implemented as a macro for processing speed.  It may also be necessary
-to define a setup macro which pre-calculates certain values which
-would be reused in a loop.
+specified interpolation \code{mode}.  The \code{mask} allows pixels to
+be excluded if their corresponding mask pixel value matches the value
+of \code{maskVal}.  This function will likely be implemented as a
+macro for processing speed.  It may also be necessary to define a
+setup macro which pre-calculates certain values which would be reused
+in a loop.
 
 \subsubsection{Image I/O Functions}
@@ -2651,11 +2662,12 @@
 existing image starting at the coordinate x,y,z.  If any of these
 parameters implies writing pixels outside the existing data area of
-the image, return an error (ie, if x + image.nx >= NAXIS1, y +
-image.ny >= NAXIS2, or z >= NAXIS3).  If the image does not exist,
-require x,y,z to be zero.  This function will only write images of the
-native FITS image types (\code{psU8}, \code{psS16}, \code{psS32},
-\code{psF32}, \code{psF64}).  The user is expected to convert the data
-type as needed with \code{psImageCopy}.  The return value must be 0
-for a successful operation and 1 for an error.
+the image, return an error (ie, if \code{x + image.nx >= NAXIS1},
+\code{y + image.ny >= NAXIS2}, or \code{z >= NAXIS3}).  If the image
+does not exist, require x,y,z to be zero.  This function will only
+write images of the native FITS image types (\code{psU8},
+\code{psS16}, \code{psS32}, \code{psF32}, \code{psF64}).  The user is
+expected to convert the data type as needed with \code{psImageCopy}.
+The return value must be 0 for a successful operation and 1 for an
+error.
 
 \subsubsection{Image Pixel Manipulations}
@@ -3839,4 +3851,16 @@
 \end{verbatim}
 
+We also require the ability to precess coordinates from one equinox to
+another.
+
+\begin{verbatim}
+psSphere *psSpherePrecess(psSphere *coords, const psTime *fromTime, const psTime *toTime);
+\end{verbatim}
+
+Given coordinates, \code{coords}, with equinox for \code{fromTime},
+the coordinates are precessed to equinox for \code{toTime}.  The
+\code{coords} are modified in-place.  Equinoxes shall be Julian
+equinoxes (as opposed to Bessellian).
+
 \subsubsection{Projections}
 
@@ -3926,4 +3950,7 @@
 
 \subsection{Photometry}
+
+\tbd{This section is to be deferred, and for now consists only of
+placeholders, with no functional items.}
 
 Photometric observations are performed in an instrumental photometric
@@ -3995,5 +4022,5 @@
 
 \tbd{These functions are all of low priority, have not yet been
-defined in detail, and are not immediately required.}
+defined in detail, and hence are to be deferred.}
 
 \subsubsection{Positions of Major SS Objects}