From 42e029b66000ace57246fcec4cb72a5e18652487 Mon Sep 17 00:00:00 2001
From: Paul Kehrer <paul.l.kehrer@gmail.com>
Date: Sat, 17 Oct 2015 09:52:04 -0500
Subject: expand keywrap intro docs

---
 docs/hazmat/primitives/keywrap.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

(limited to 'docs/hazmat/primitives/keywrap.rst')

diff --git a/docs/hazmat/primitives/keywrap.rst b/docs/hazmat/primitives/keywrap.rst
index 1b49a4c5..429e8928 100644
--- a/docs/hazmat/primitives/keywrap.rst
+++ b/docs/hazmat/primitives/keywrap.rst
@@ -6,7 +6,10 @@ Key wrapping
 ============
 
 Key wrapping is a cryptographic construct that uses symmetric encryption to
-encapsulate key material.
+encapsulate key material. Key wrapping algorithms are occasionally utilized
+to protect keys at rest or transmit them over insecure networks. Many of the
+protections offered by key wrapping are also offered by using authenticated
+:doc:`symmetric encryption </hazmat/primitives/symmetric-encryption>`.
 
 .. function:: aes_key_wrap(wrapping_key, key_to_wrap, backend)
 
-- 
cgit v1.2.3