diff --git a/Doc/library/crypt.rst b/Doc/library/crypt.rst
index 740084b40c5ac96..84168bbfe74aa8c 100644
--- a/Doc/library/crypt.rst
+++ b/Doc/library/crypt.rst
@@ -20,6 +20,14 @@
    The :mod:`crypt` module is deprecated
    (see :pep:`PEP 594 <594#crypt>` for details and alternatives).
    The :mod:`hashlib` module is a potential replacement for certain use cases.
+   The :mod:`passlib` package can replace all use cases of this module.
+
+    >>> import crypt
+    >>> crypt.crypt("cleartext", salt="ab")
+    'ab/GpyA5I.S12'
+    >>> from passlib.hash import des_crypt
+    >>> des_crypt.hash("cleartext", salt="ab")
+    'ab/GpyA5I.S12'
 
 --------------