Added soundex (sigh)

gvanrossum · gvanrossum · commit 3486f27428e0 · 1996-12-12T17:02:21.000Z
diff --git a/Doc/Makefile b/Doc/Makefile
@@ -112,7 +112,7 @@ LIBFILES = lib.tex \
     libcd.tex libfl.tex libfm.tex libgl.tex libimgfile.tex libsun.tex \
     libxdrlib.tex libimghdr.tex \
     librestricted.tex librexec.tex libbastion.tex \
-    libformatter.tex liboperator.tex
+    libformatter.tex liboperator.tex libsoundex.tex
 
 # Library document
 lib.dvi: $(LIBFILES)
diff --git a/Doc/lib.tex b/Doc/lib.tex
@@ -93,6 +93,7 @@
 \input{libregex}
 \input{libregsub}
 \input{libstruct}
+\input{libsoundex}
 
 \input{libmisc}			% Miscellaneous Services
 \input{libmath}
diff --git a/Doc/lib/lib.tex b/Doc/lib/lib.tex
@@ -93,6 +93,7 @@
 \input{libregex}
 \input{libregsub}
 \input{libstruct}
+\input{libsoundex}
 
 \input{libmisc}			% Miscellaneous Services
 \input{libmath}
diff --git a/Doc/lib/libsoundex.tex b/Doc/lib/libsoundex.tex
@@ -0,0 +1,25 @@
+\section{Standard Module \sectcode{soundex}}
+\stmodindex{soundex}
+
+\renewcommand{\indexsubitem}{(in module soundex)}
+The soundex algorithm takes an English word, and returns an
+easily-computed hash of it; this hash is intended to be the same for
+words that sound alike.  This module provides an interface to the
+soundex algorithm.
+
+Note that the soundex algorithm is quite simple-minded, and isn't
+perfect by any measure.  Its main purpose is to help looking up names
+in databases, when the name may be misspelled -- soundex hashes common
+misspellings together.
+
+\begin{funcdesc}{get_soundex}{string}
+Return the soundex hash value for a word; it will always be a
+6-character string.  \var{string} must contain the word to be hashed,
+with no leading whitespace; the case of the word is ignored.
+\end{funcdesc}
+
+\begin{funcdesc}{sound_similar}{string1, string2}
+Compare the word in \var{string1} with the word in \var{string2}; this
+is equivalent to 
+\code{get_soundex(\var{string1})==get_soundex(\var{string2})}.
+\end{funcdesc}
diff --git a/Doc/libsoundex.tex b/Doc/libsoundex.tex
@@ -0,0 +1,25 @@
+\section{Standard Module \sectcode{soundex}}
+\stmodindex{soundex}
+
+\renewcommand{\indexsubitem}{(in module soundex)}
+The soundex algorithm takes an English word, and returns an
+easily-computed hash of it; this hash is intended to be the same for
+words that sound alike.  This module provides an interface to the
+soundex algorithm.
+
+Note that the soundex algorithm is quite simple-minded, and isn't
+perfect by any measure.  Its main purpose is to help looking up names
+in databases, when the name may be misspelled -- soundex hashes common
+misspellings together.
+
+\begin{funcdesc}{get_soundex}{string}
+Return the soundex hash value for a word; it will always be a
+6-character string.  \var{string} must contain the word to be hashed,
+with no leading whitespace; the case of the word is ignored.
+\end{funcdesc}
+
+\begin{funcdesc}{sound_similar}{string1, string2}
+Compare the word in \var{string1} with the word in \var{string2}; this
+is equivalent to 
+\code{get_soundex(\var{string1})==get_soundex(\var{string2})}.
+\end{funcdesc}
