[Emacs-diffs] /srv/bzr/emacs/trunk r107228: Document secure-hash

[Glenn Morris]

------------------------------------------------------------
revno: 107228
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Fri 2012-02-10 00:51:37 -0800
message:
  Document secure-hash
  
  * doc/lispref/text.texi (Checksum/Hash): Rename node from MD5 Checksum.
  Mention secure-hash.
  * doc/lispref/elisp.texi, doc/lispref/vol1.texi, doc/lispref/vol2.texi:
  Update menu entry.
  * etc/NEWS: Related markup.
modified:
  doc/lispref/ChangeLog
  doc/lispref/elisp.texi
  doc/lispref/text.texi
  doc/lispref/vol1.texi
  doc/lispref/vol2.texi
  etc/NEWS

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-02-10 08:08:23 +0000
+++ b/doc/lispref/ChangeLog     2012-02-10 08:51:37 +0000
@@ -1,3 +1,9 @@
+2012-02-10  Glenn Morris  <address@hidden>
+
+       * text.texi (Checksum/Hash): Rename node from MD5 Checksum.
+       Mention secure-hash.
+       * elisp.texi, vol1.texi, vol2.texi: Update menu entry.
+
 2012-02-10  Chong Yidong  <address@hidden>
 
        * loading.texi (Loading): Don't emphasize "library" terminology.

=== modified file 'doc/lispref/elisp.texi'
--- a/doc/lispref/elisp.texi    2012-02-09 07:48:22 +0000
+++ b/doc/lispref/elisp.texi    2012-02-10 08:51:37 +0000
@@ -1061,7 +1061,7 @@
 * Registers::               How registers are implemented.  Accessing
                               the text or position stored in a register.
 * Base 64::                 Conversion to or from base 64 encoding.
-* MD5 Checksum::            Compute the MD5 "message digest"/"checksum".
+* Checksum/Hash::           Computing "message digests"/"checksums"/"hashes".
 * Atomic Changes::          Installing several buffer changes "atomically".
 * Change Hooks::            Supplying functions to be run when text is changed.
 

=== modified file 'doc/lispref/text.texi'
--- a/doc/lispref/text.texi     2012-02-04 19:48:06 +0000
+++ b/doc/lispref/text.texi     2012-02-10 08:51:37 +0000
@@ -56,7 +56,7 @@
 * Registers::        How registers are implemented.  Accessing the text or
                        position stored in a register.
 * Base 64::          Conversion to or from base 64 encoding.
-* MD5 Checksum::     Compute the MD5 "message digest"/"checksum".
+* Checksum/Hash::    Computing "message digests"/"checksums"/"hashes".
 * Parsing HTML::     Parsing HTML and XML.
 * Atomic Changes::   Installing several buffer changes "atomically".
 * Change Hooks::     Supplying functions to be run when text is changed.
@@ -4071,9 +4071,11 @@
 The decoding functions ignore newline characters in the encoded text.
 @end defun
 
address@hidden MD5 Checksum
address@hidden MD5 Checksum
address@hidden Checksum/Hash
address@hidden Checksum/Hash
 @cindex MD5 checksum
address@hidden hashing, secure
address@hidden SHA-1
 @cindex message digest computation
 
   MD5 cryptographic checksums, or @dfn{message digests}, are 128-bit
@@ -4084,7 +4086,7 @@
 For an explanation of what is an RFC, see the footnote in @ref{Base
 64}.
 }1321.  This section describes the Emacs facilities for computing
-message digests.
+message digests and other forms of ``secure hash''.
 
 @defun md5 object &optional start end coding-system noerror
 This function returns the MD5 message digest of @var{object}, which
@@ -4119,6 +4121,16 @@
 coding instead.
 @end defun
 
address@hidden secure-hash algorithm object &optional start end binary
+This function provides a general interface to a variety of secure
+hashing algorithms.  As well as the MD5 algorithm, it supports SHA-1,
+SHA-2, SHA-224, SHA-256, SHA-384 and SHA-512.  The argument
address@hidden is a symbol stating which hash to compute.  The
+arguments @var{object}, @var{start}, and @var{end} are as for the
address@hidden function.  If the optional argument @var{binary} is
address@hidden, returns a string in binary form.
address@hidden defun
+
 @node Parsing HTML
 @section Parsing HTML
 @cindex parsing html

=== modified file 'doc/lispref/vol1.texi'
--- a/doc/lispref/vol1.texi     2012-02-09 07:48:22 +0000
+++ b/doc/lispref/vol1.texi     2012-02-10 08:51:37 +0000
@@ -1082,7 +1082,7 @@
 * Registers::               How registers are implemented.  Accessing
                               the text or position stored in a register.
 * Base 64::                 Conversion to or from base 64 encoding.
-* MD5 Checksum::            Compute the MD5 "message digest"/"checksum".
+* Checksum/Hash::           Computing "message digests"/"checksums"/"hashes".
 * Atomic Changes::          Installing several buffer changes "atomically".
 * Change Hooks::            Supplying functions to be run when text is changed.
 

=== modified file 'doc/lispref/vol2.texi'
--- a/doc/lispref/vol2.texi     2012-02-09 07:48:22 +0000
+++ b/doc/lispref/vol2.texi     2012-02-10 08:51:37 +0000
@@ -1081,7 +1081,7 @@
 * Registers::               How registers are implemented.  Accessing
                               the text or position stored in a register.
 * Base 64::                 Conversion to or from base 64 encoding.
-* MD5 Checksum::            Compute the MD5 "message digest"/"checksum".
+* Checksum/Hash::           Computing "message digests"/"checksums"/"hashes".
 * Atomic Changes::          Installing several buffer changes "atomically".
 * Change Hooks::            Supplying functions to be run when text is changed.
 

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-02-10 08:38:22 +0000
+++ b/etc/NEWS  2012-02-10 08:51:37 +0000
@@ -408,6 +408,7 @@
 +++
 ** The variable `focus-follows-mouse' now always defaults to nil.
 
++++
 ** New primitive `secure-hash' that supports many secure hash algorithms:
 md5, sha1, sha2, sha224, sha256, sha384, and sha512.  The lisp library
 sha1.el has been removed.  The `sha1' feature is provided by default.