Remove documentation for the soundex module; the module is no longer

included with Python.
This commit is contained in:
Fred Drake 2001-02-22 21:25:20 +00:00
parent 1c8e1f0654
commit 7c30de65f4
2 changed files with 32 additions and 76 deletions

View File

@ -8,9 +8,9 @@
\input{boilerplate} \input{boilerplate}
\makeindex % tell \index to actually write the \makeindex % tell \index to actually write the
% .idx file % .idx file
\makemodindex % ... and the module index as well. \makemodindex % ... and the module index as well.
\begin{document} \begin{document}
@ -62,16 +62,16 @@ and how to embed it in other applications.
\tableofcontents \tableofcontents
% Chapter title: % Chapter title:
\input{libintro} % Introduction \input{libintro} % Introduction
\input{libobjs} % Built-in Types, Exceptions and Functions \input{libobjs} % Built-in Types, Exceptions and Functions
\input{libstdtypes} \input{libstdtypes}
\input{libexcs} \input{libexcs}
\input{libfuncs} \input{libfuncs}
\input{libpython} % Python Runtime Services \input{libpython} % Python Runtime Services
\input{libsys} \input{libsys}
\input{libgc} \input{libgc}
\input{libweakref} \input{libweakref}
@ -83,7 +83,7 @@ and how to embed it in other applications.
\input{libtraceback} \input{libtraceback}
\input{liblinecache} \input{liblinecache}
\input{libpickle} \input{libpickle}
\input{libcopyreg} % really copy_reg \input{libcopyreg} % really copy_reg
\input{libshelve} \input{libshelve}
\input{libcopy} \input{libcopy}
\input{libmarshal} \input{libmarshal}
@ -96,10 +96,10 @@ and how to embed it in other applications.
\input{libnew} \input{libnew}
\input{libsite} \input{libsite}
\input{libuser} \input{libuser}
\input{libbltin} % really __builtin__ \input{libbltin} % really __builtin__
\input{libmain} % really __main__ \input{libmain} % really __main__
\input{libstrings} % String Services \input{libstrings} % String Services
\input{libstring} \input{libstring}
\input{libre} \input{libre}
\input{libstruct} \input{libstruct}
@ -109,7 +109,7 @@ and how to embed it in other applications.
\input{libcodecs} \input{libcodecs}
\input{libunicodedata} \input{libunicodedata}
\input{libmisc} % Miscellaneous Services \input{libmisc} % Miscellaneous Services
\input{libdoctest} \input{libdoctest}
\input{libmath} \input{libmath}
\input{libcmath} \input{libcmath}
@ -124,9 +124,9 @@ and how to embed it in other applications.
\input{libcmd} \input{libcmd}
\input{libshlex} \input{libshlex}
\input{liballos} % Generic Operating System Services \input{liballos} % Generic Operating System Services
\input{libos} \input{libos}
\input{libposixpath} % os.path \input{libposixpath} % os.path
\input{libdircache} \input{libdircache}
\input{libstat} \input{libstat}
\input{libstatcache} \input{libstatcache}
@ -138,7 +138,7 @@ and how to embed it in other applications.
\input{libmutex} \input{libmutex}
\input{libgetpass} \input{libgetpass}
\input{libcurses} \input{libcurses}
\input{libascii} % curses.ascii \input{libascii} % curses.ascii
\input{libgetopt} \input{libgetopt}
\input{libtempfile} \input{libtempfile}
\input{liberrno} \input{liberrno}
@ -148,7 +148,7 @@ and how to embed it in other applications.
\input{liblocale} \input{liblocale}
\input{libgettext} \input{libgettext}
\input{libsomeos} % Optional Operating System Services \input{libsomeos} % Optional Operating System Services
\input{libsignal} \input{libsignal}
\input{libsocket} \input{libsocket}
\input{libselect} \input{libselect}
@ -166,7 +166,7 @@ and how to embed it in other applications.
\input{libreadline} \input{libreadline}
\input{librlcompleter} \input{librlcompleter}
\input{libunix} % UNIX Specific Services \input{libunix} % UNIX Specific Services
\input{libposix} \input{libposix}
\input{libpwd} \input{libpwd}
\input{libgrp} \input{libgrp}
@ -185,11 +185,11 @@ and how to embed it in other applications.
\input{libsyslog} \input{libsyslog}
\input{libcommands} \input{libcommands}
\input{libpdb} % The Python Debugger \input{libpdb} % The Python Debugger
\input{libprofile} % The Python Profiler \input{libprofile} % The Python Profiler
\input{internet} % Internet Protocols \input{internet} % Internet Protocols
\input{libwebbrowser} \input{libwebbrowser}
\input{libcgi} \input{libcgi}
\input{liburllib} \input{liburllib}
@ -209,7 +209,7 @@ and how to embed it in other applications.
\input{libcookie} \input{libcookie}
\input{libasyncore} \input{libasyncore}
\input{netdata} % Internet Data Handling \input{netdata} % Internet Data Handling
\input{libformatter} \input{libformatter}
\input{librfc822} \input{librfc822}
\input{libmimetools} \input{libmimetools}
@ -242,7 +242,7 @@ and how to embed it in other applications.
\input{xmlsaxreader} \input{xmlsaxreader}
\input{libxmllib} \input{libxmllib}
\input{libmm} % Multimedia Services \input{libmm} % Multimedia Services
\input{libaudioop} \input{libaudioop}
\input{libimageop} \input{libimageop}
\input{libaifc} \input{libaifc}
@ -254,7 +254,7 @@ and how to embed it in other applications.
\input{libimghdr} \input{libimghdr}
\input{libsndhdr} \input{libsndhdr}
\input{libcrypto} % Cryptographic Services \input{libcrypto} % Cryptographic Services
\input{libmd5} \input{libmd5}
\input{libsha} \input{libsha}
\input{libmpz} \input{libmpz}
@ -264,7 +264,7 @@ and how to embed it in other applications.
\input{librexec} \input{librexec}
\input{libbastion} \input{libbastion}
\input{language} % Python Language Services \input{language} % Python Language Services
\input{libparser} \input{libparser}
\input{libsymbol} \input{libsymbol}
\input{libtoken} \input{libtoken}
@ -272,15 +272,15 @@ and how to embed it in other applications.
\input{libtokenize} \input{libtokenize}
\input{libtabnanny} \input{libtabnanny}
\input{libpyclbr} \input{libpyclbr}
\input{libpycompile} % really py_compile \input{libpycompile} % really py_compile
\input{libcompileall} \input{libcompileall}
\input{libdis} \input{libdis}
%\input{libamoeba} % AMOEBA ONLY %\input{libamoeba} % AMOEBA ONLY
%\input{libstdwin} % STDWIN ONLY %\input{libstdwin} % STDWIN ONLY
\input{libsgi} % SGI IRIX ONLY \input{libsgi} % SGI IRIX ONLY
\input{libal} \input{libal}
\input{libcd} \input{libcd}
\input{libfl} \input{libfl}
@ -290,10 +290,10 @@ and how to embed it in other applications.
\input{libjpeg} \input{libjpeg}
%\input{libpanel} %\input{libpanel}
\input{libsun} % SUNOS ONLY \input{libsun} % SUNOS ONLY
\input{libsunaudio} \input{libsunaudio}
\input{windows} % MS Windows ONLY \input{windows} % MS Windows ONLY
\input{libmsvcrt} \input{libmsvcrt}
\input{libwinreg} \input{libwinreg}
\input{libwinsound} \input{libwinsound}
@ -308,7 +308,6 @@ and how to embed it in other applications.
%\input{librand} %\input{librand}
%\input{libregex} %\input{libregex}
%\input{libregsub} %\input{libregsub}
%\input{libsoundex}
\chapter{Reporting Bugs} \chapter{Reporting Bugs}
\input{reportingbugs} \input{reportingbugs}
@ -322,11 +321,11 @@ and how to embed it in other applications.
%begin{latexonly} %begin{latexonly}
\renewcommand{\indexname}{Module Index} \renewcommand{\indexname}{Module Index}
%end{latexonly} %end{latexonly}
\input{modlib.ind} % Module Index \input{modlib.ind} % Module Index
%begin{latexonly} %begin{latexonly}
\renewcommand{\indexname}{Index} \renewcommand{\indexname}{Index}
%end{latexonly} %end{latexonly}
\input{lib.ind} % Index \input{lib.ind} % Index
\end{document} \end{document}

View File

@ -1,43 +0,0 @@
\section{\module{soundex} ---
None}
\declaremodule{builtin}{soundex}
\modulesynopsis{None}
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. (Note
that the original algorithm produces a 4-character result.)
\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})} \code{==}
\code{get_soundex(\var{string2})}.
\end{funcdesc}
\begin{seealso}
\seetext{Donald E. Knuth, \citetitle{Sorting and Searching}, vol. 3
in ``The Art of Computer Programming.'' Addison-Wesley
Publishing Company: Reading, MA: 1973. pp.\ 391-392.
Discusses the origin and usefulness of the algorithm, as
well as the algorithm itself. Knuth gives his sources as
\emph{U.S. Patents 1261167} (1918) and \emph{1435663}
(1922), attributing the algorithm to Margaret K. Odell and
Robert C. Russel. Additional references are provided.}
\end{seealso}