From: Chip Salzenberg <chip@atlantic.net>
Date: Sat, 1 Mar 1997 06:40:49 +0000 (+1200)
Subject: Clarify C<crypt> documentation
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=7ced68a9910e3e485fbed4e4fc2c1ca47c313762;p=p5sagit%2Fp5-mst-13.2.git

Clarify C<crypt> documentation

(this is the same change as commit 033135fa782fb902eccfa5fabb72b7be2050ba12, but as applied)
---

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index cf5dd8f..09b5ad3 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -606,8 +606,10 @@ extirpated as a potential munition).  This can prove useful for checking
 the password file for lousy passwords, amongst other things.  Only the
 guys wearing white hats should do this.
 
-Note that there is no corresponding decrypt, so this fucntion isn't
-all that useful for cryptography. (For that, see your nearby CPAN mirror.)
+Note that crypt is intended to be a one-way function, much like breaking
+eggs to make an omelette.  There is no (known) corresponding decrypt
+function.  As a result, this function isn't all that useful for
+cryptography.  (For that, see your nearby CPAN mirror.)
 
 Here's an example that makes sure that whoever runs this program knows
 their own password:
@@ -704,8 +706,6 @@ Examples:
     print "$val\n" while defined($val = pop(@ary));
     die "Can't readlink $sym: $!"
 	unless defined($value = readlink $sym);
-    eval '@foo = ()' if defined(@foo);
-    die "No XYZ package defined" unless defined %_XYZ;
     sub foo { defined &$bar ? &$bar(@_) : die "No bar"; }
     $debugging = 0 unless defined $debugging;