From 1f08335a4d868168d5c33c289b85b2a7237d4ba1 Mon Sep 17 00:00:00 2001
From: sperber <sperber>
Date: Mon, 7 Jan 2002 13:04:14 +0000
Subject: [PATCH] NTH is obsolete.

---
 RELEASE                       | 3 +++
 doc/scsh-manual/miscprocs.tex | 5 ++++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/RELEASE b/RELEASE
index 6ff0c35..e6784b2 100644
--- a/RELEASE
+++ b/RELEASE
@@ -205,6 +205,9 @@ We now manage the project using SourceForge:
   The default directory for creating temporary files changed: It's now
   $TMPDIR if set and /var/tmp otherwise
 
+  The nth procedure is still there but is now officially obsolete.  It
+  will go away in a future release.
+
 ** HTML version of the manual
   There is now a HTML version of the scsh manual generated by tex2page
 
diff --git a/doc/scsh-manual/miscprocs.tex b/doc/scsh-manual/miscprocs.tex
index ebf0a29..9eb9336 100644
--- a/doc/scsh-manual/miscprocs.tex
+++ b/doc/scsh-manual/miscprocs.tex
@@ -18,7 +18,7 @@
 \end{desc}
 
 \section{List procedures}
-\defun{nth}{list i}\object
+\dfn{nth}{list i}{object}{procedure \textbf{(obsolete)}}
 \begin{desc}
 Returns the $i^{\mathrm th}$ element of \var{list}.
 The first element (the car) is \ex{(nth \var{list} 0)},
@@ -26,6 +26,9 @@ the second element is \ex{(nth \var{list} 1)}, and so on.
 
 This procedure is provided as it is useful for accessing elements
 from the lists returned by the field-readers (chapter~\ref{chapt:fr-awk}).
+
+The functionality of \ex{nth} is equivalent to that of \R4RS{}'s
+\ex{list-ref}.  Therefore, \ex{nth} will go away in a future release.
 \end{desc}