From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Simon Josefsson Newsgroups: gmane.emacs.devel Subject: Move sha1.el and hex-util.el from lisp/gnus/ to lisp/net/ (was: Re: Moving files from lisp/gnus/ to lisp/net/?) Date: Sun, 24 Oct 2004 15:05:09 +0200 Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: References: NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1098623370 17726 80.91.229.6 (24 Oct 2004 13:09:30 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 24 Oct 2004 13:09:30 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Oct 24 15:09:23 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CLi7f-0007S6-00 for ; Sun, 24 Oct 2004 15:09:23 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CLiCA-0002aB-HP for ged-emacs-devel@m.gmane.org; Sun, 24 Oct 2004 09:14:02 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CLiBh-0002Xw-Tk for emacs-devel@gnu.org; Sun, 24 Oct 2004 09:13:34 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CLiBa-0002Sr-R0 for emacs-devel@gnu.org; Sun, 24 Oct 2004 09:13:27 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CLiBa-0002Sh-OU for emacs-devel@gnu.org; Sun, 24 Oct 2004 09:13:26 -0400 Original-Received: from [80.91.229.2] (helo=main.gmane.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CLi3y-0000RC-Cc for emacs-devel@gnu.org; Sun, 24 Oct 2004 09:05:34 -0400 Original-Received: from list by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 1CLi3x-0008TE-00 for ; Sun, 24 Oct 2004 15:05:33 +0200 Original-Received: from c494102a.s-bi.bostream.se ([217.215.27.65]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 24 Oct 2004 15:05:33 +0200 Original-Received: from jas by c494102a.s-bi.bostream.se with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 24 Oct 2004 15:05:33 +0200 X-Injected-Via-Gmane: http://gmane.org/ Mail-Followup-To: emacs-devel@gnu.org Original-To: emacs-devel@gnu.org Original-Lines: 28 Original-X-Complaints-To: usenet@sea.gmane.org X-Gmane-NNTP-Posting-Host: c494102a.s-bi.bostream.se Mail-Copies-To: nobody User-Agent: Gnus/5.110003 (No Gnus v0.3) Emacs/21.3.50 (gnu/linux) Cancel-Lock: sha1:yok19zVYnb6HbKs5WJEGxhr9CE4= X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:28831 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:28831 The first file is sha1.el. It is an implementation of an algorithm very similar to MD5, which is part of Emacs (in C). It is generally useful, and not Gnus specific in any way. The API is stable, the only API change that I can locate, since the file was created in 1999, was a new optional parameter to some functions. The file sha1.el needs hex-util.el, which is a small file to hex encode strings. It is similar to base64-*. If it is possible to do the same using other functions in Emacs, that may be better. Please look at the file and tell. But it is a small files, that could be useful elsewhere as well. Both can be documented in LispRef, it seems. For SHA1, I can copy the MD5 node, and for hex-util, I can create something inspired by the base64 node. Alternatively, the functions could be documented in emacs-mime.texi's "Basic Functions". It document many similar packages already. I suggested documenting the new mail-utils functions, proposed in another thread, in the same manual. The name "Emacs-MIME" is confusing though, "Emacs Lisp Mail Handling" or similar would be more appropriate. Documenting Mail Handling related functions in emacs-mime.texi instead of lispref might be good if people think lispref is too large. I suspect people interested in mail utilities will be able to find a different manual. There could be links from lispref to emacs-mime as well.