This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Crypto terminology for crypto hash function
Type: Stage:
Components: Documentation Versions:
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: rhettinger Nosy List: rhettinger, ronrivest
Priority: normal Keywords:

Created on 2003-09-11 01:07 by ronrivest, last changed 2022-04-10 16:11 by admin. This issue is now closed.

Messages (2)
msg18131 - (view) Author: Ronald L. Rivest (ronrivest) Date: 2003-09-11 01:07
On web page:

http://www.python.org/dev/doc/devel////lib/module-
sha.html

the documentation should be improved to make it clear 
that the hash function implemented here is really what 
is known as "SHA-1" and not just "SHA".  NIST originally 
proposed a "SHA" hash function.  NSA found a problem 
with SHA, and proposed a small fix to it; the revised 
hash function is typically called "SHA-1".   The version 
implemented is indeed "SHA-1" and not "SHA" (I tested 
it).   The documentation should make this clear, and 
might also include "SHA1" somewhere as a synonym so 
searches will find this common spelling variant too.  
Renaming the module as "sha1" would also be nice...
msg18132 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2003-09-15 18:25
Logged In: YES 
user_id=80475

Fixed the docs.

Renaming the module would be a bigger step that causes 
difficulty for people upgrading to the next Python version, 
challenges for people distributing code expected to work 
under multiple versions, and would outdate existing Python 
publications.  Passing on that step because it gets too little 
benefit for the cost.

See Doc/lib/libsha.tex  1.10.26.1 and 1.11.

Thanks for the report.
History
Date User Action Args
2022-04-10 16:11:05adminsetgithub: 39212
2003-09-11 01:07:54ronrivestcreate