From 5c6e3738cd2179600c24bc1241eb5daa584ccc47 Mon Sep 17 00:00:00 2001
From: Guido van Rossum <guido@python.org>
Date: Wed, 10 Apr 1996 16:18:20 +0000
Subject: [PATCH] Added lost docs for crypt module.

---
 Doc/lib.tex          |  1 +
 Doc/lib/lib.tex      |  1 +
 Doc/lib/libcrypt.tex | 21 +++++++++++++++++++++
 Doc/lib/libunix.tex  |  3 +++
 Doc/libcrypt.tex     | 21 +++++++++++++++++++++
 Doc/libunix.tex      |  3 +++
 6 files changed, 50 insertions(+)
 create mode 100644 Doc/lib/libcrypt.tex
 create mode 100644 Doc/libcrypt.tex

diff --git a/Doc/lib.tex b/Doc/lib.tex
index dad66ddd4e5..513f81a2e79 100644
--- a/Doc/lib.tex
+++ b/Doc/lib.tex
@@ -116,6 +116,7 @@ to Python and how to embed it in other applications.
 \input{libppath}		% == posixpath
 \input{libpwd}
 \input{libgrp}
+\input{libcrypt}
 \input{libdbm}
 \input{libgdbm}
 \input{libtermios}
diff --git a/Doc/lib/lib.tex b/Doc/lib/lib.tex
index dad66ddd4e5..513f81a2e79 100644
--- a/Doc/lib/lib.tex
+++ b/Doc/lib/lib.tex
@@ -116,6 +116,7 @@ to Python and how to embed it in other applications.
 \input{libppath}		% == posixpath
 \input{libpwd}
 \input{libgrp}
+\input{libcrypt}
 \input{libdbm}
 \input{libgdbm}
 \input{libtermios}
diff --git a/Doc/lib/libcrypt.tex b/Doc/lib/libcrypt.tex
new file mode 100644
index 00000000000..e44f7b2be99
--- /dev/null
+++ b/Doc/lib/libcrypt.tex
@@ -0,0 +1,21 @@
+\section{Built-in module {\tt crypt}}
+\bimodindex{crypt}
+
+This module implements an interface to the crypt({\bf 3}) routine,
+which is a one-way hash function based upon a modified DES algorithm;
+see the Unix man page for further details.  Possible uses include
+allowing Python scripts to accept typed passwords from the user, or
+attempting to crack Unix passwords with a dictionary.
+\index{crypt(3)}
+
+\begin{funcdesc}{crypt}{word\, salt} 
+\var{word} will usually be a user's password.  \var{salt} is a
+2-character string which will be used to select one of 4096 variations
+of DES.  The characters in \var{salt} must be either \code{.},
+\code{/}, or an alphanumeric character.  Returns the hashed password
+as a string, which will be composed of characters from the same
+alphabet as the salt.
+\end{funcdesc}
+
+The module and documentation were written by Steve Majewski.
+\index{Majewski, Steve}
diff --git a/Doc/lib/libunix.tex b/Doc/lib/libunix.tex
index fe92d9797a7..895c6e57453 100644
--- a/Doc/lib/libunix.tex
+++ b/Doc/lib/libunix.tex
@@ -18,6 +18,9 @@ some or many variants of it.  Here's an overview:
 \item[grp]
 --- The group database (\code{getgrnam()} and friends).
 
+\item[crypt]
+--- The (\code{crypt()} function used to check Unix passwords).
+
 \item[dbm]
 --- The standard ``database'' interface, based on \code{ndbm}.
 
diff --git a/Doc/libcrypt.tex b/Doc/libcrypt.tex
new file mode 100644
index 00000000000..e44f7b2be99
--- /dev/null
+++ b/Doc/libcrypt.tex
@@ -0,0 +1,21 @@
+\section{Built-in module {\tt crypt}}
+\bimodindex{crypt}
+
+This module implements an interface to the crypt({\bf 3}) routine,
+which is a one-way hash function based upon a modified DES algorithm;
+see the Unix man page for further details.  Possible uses include
+allowing Python scripts to accept typed passwords from the user, or
+attempting to crack Unix passwords with a dictionary.
+\index{crypt(3)}
+
+\begin{funcdesc}{crypt}{word\, salt} 
+\var{word} will usually be a user's password.  \var{salt} is a
+2-character string which will be used to select one of 4096 variations
+of DES.  The characters in \var{salt} must be either \code{.},
+\code{/}, or an alphanumeric character.  Returns the hashed password
+as a string, which will be composed of characters from the same
+alphabet as the salt.
+\end{funcdesc}
+
+The module and documentation were written by Steve Majewski.
+\index{Majewski, Steve}
diff --git a/Doc/libunix.tex b/Doc/libunix.tex
index fe92d9797a7..895c6e57453 100644
--- a/Doc/libunix.tex
+++ b/Doc/libunix.tex
@@ -18,6 +18,9 @@ some or many variants of it.  Here's an overview:
 \item[grp]
 --- The group database (\code{getgrnam()} and friends).
 
+\item[crypt]
+--- The (\code{crypt()} function used to check Unix passwords).
+
 \item[dbm]
 --- The standard ``database'' interface, based on \code{ndbm}.