Add README and NEWS file for upcoming release.

This commit is contained in:
2012-10-23 11:08:23 +02:00
parent 56bc82ba0d
commit 4034a73008
3 changed files with 42 additions and 1 deletions

24
NEWS Normal file
View File

@ -0,0 +1,24 @@
Release 2.0.0
=============
* This release consolidates the various versions of md5 that have
been floating around, including versions with Lispworks
optimizations, the version maintained by Kevin M. Rosenberg, the
SBCL-optimized version, and various patches and fixes.
* This release tries to separate out string-handling from actual
byte-based MD5 hash generation. Hence users who want to generate
hashes from strings should use the new md5sum-string function,
which will go through your implementation's external-format
handling to generate the actual byte-array that is hashed. Usage
of md5sum-sequence for strings and md5sum-stream for character
streams is deprecated, since it only ever worked correctly for 8bit
characters in most implementations.
* This release should work correctly on at least CMUCL, SBCL, ECL,
CCL, Lispworks, AllegroCL and ABCL and generally most other
conforming implementations. It has been optimized for CMUCL, SBCL
and Lispworks, and should work with adequate performance on most
64bit implementations. Performance on other 32bit implementations
is still sub-optimal if they don't support unboxed bit-operations
on (unsigned-byte 32).

18
README Normal file
View File

@ -0,0 +1,18 @@
This package implements The MD5 Message-Digest Algorithm, as defined
in RFC 1321 by R. Rivest, published April 1992.
It was originally written by Pierre R. Mai, with copious input from
the cmucl-help mailing-list hosted at cons.org, in November 2001 and
has been placed into the public domain. In the meantime various fixes
and improvements for other implementations as well as maintenance have
been provided by Christophe Rhodes, Alexey Dejneka, Nathan Froyd,
Andreas Fuchs, John Desoi, Dmitriy Ivanov, and Kevin M. Rosenberg, and
have been reintegrated into this consolidated version by Pierre R. Mai.
WARNING: The MD5 Message-Digest Algorithm has been compromised as a
cryptographically secure hash for some time, with known theoretical
and practical attacks. Therefore use of this implemenation is only
recommended for legacy uses or uses which do not require a
cryptographically secure hash. Use one of the newer SHA-2 and SHA-3
secure hash standards, or whatever is currently deemed
cryptographically secure for all other uses.

View File

@ -1,5 +1,4 @@
;;;; MD5 --- RFC 1321 The MD5 Message-Digest Algorithm
;;;;
(cl:in-package #:cl-user)