From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#7482: 24.0.50; binhex doc Date: Thu, 25 Nov 2010 09:58:57 -0800 Message-ID: <149BF7F3517B484FBA8AB01A756500EC@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1290708899 24692 80.91.229.12 (25 Nov 2010 18:14:59 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 25 Nov 2010 18:14:59 +0000 (UTC) To: 7482@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Nov 25 19:14:55 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PLgLP-0008GI-8K for geb-bug-gnu-emacs@m.gmane.org; Thu, 25 Nov 2010 19:14:55 +0100 Original-Received: from localhost ([127.0.0.1]:46425 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PLgLO-0000Xp-Gz for geb-bug-gnu-emacs@m.gmane.org; Thu, 25 Nov 2010 13:14:54 -0500 Original-Received: from [140.186.70.92] (port=50794 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PLgLI-0000T1-Nc for bug-gnu-emacs@gnu.org; Thu, 25 Nov 2010 13:14:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PLgLG-00074t-IY for bug-gnu-emacs@gnu.org; Thu, 25 Nov 2010 13:14:48 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:35980) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PLgLG-00074e-EC for bug-gnu-emacs@gnu.org; Thu, 25 Nov 2010 13:14:46 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PLg38-0005Uk-4p; Thu, 25 Nov 2010 12:56:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 25 Nov 2010 17:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7482 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.129070773621090 (code B ref -1); Thu, 25 Nov 2010 17:56:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 25 Nov 2010 17:55:36 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PLg2i-0005U7-IO for submit@debbugs.gnu.org; Thu, 25 Nov 2010 12:55:36 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PLg2h-0005Tw-90 for submit@debbugs.gnu.org; Thu, 25 Nov 2010 12:55:35 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PLg7t-0003dr-Ff for submit@debbugs.gnu.org; Thu, 25 Nov 2010 13:00:59 -0500 Original-Received: from lists.gnu.org ([199.232.76.165]:51797) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PLg7q-0003b7-2E for submit@debbugs.gnu.org; Thu, 25 Nov 2010 13:00:57 -0500 Original-Received: from [140.186.70.92] (port=48070 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PLg7G-00018s-Im for bug-gnu-emacs@gnu.org; Thu, 25 Nov 2010 13:00:19 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PLg7F-0003Td-AX for bug-gnu-emacs@gnu.org; Thu, 25 Nov 2010 13:00:18 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:33449) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PLg7F-0003Su-3E for bug-gnu-emacs@gnu.org; Thu, 25 Nov 2010 13:00:17 -0500 Original-Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id oAPI09Y6012213 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Thu, 25 Nov 2010 18:00:11 GMT Original-Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155]) by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id oAPI07gD001822 for ; Thu, 25 Nov 2010 18:00:08 GMT Original-Received: from abhmt021.oracle.com by acsmt355.oracle.com with ESMTP id 814443561290707933; Thu, 25 Nov 2010 09:58:53 -0800 Original-Received: from dradamslap1 (/10.159.246.94) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 25 Nov 2010 09:58:53 -0800 X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 Thread-Index: AcuMym4i+OTCGwdESDKHnBA8C3tBfA== X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Thu, 25 Nov 2010 12:56:02 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:41890 Archived-At: Library binhex.el is woefully inadequate as regards doc. Nothing is described/explained, starting with what "binhex" is. Please provide some description, at least in the doc strings and file commentary, and perhaps in the manual if appropriate. The _most_ explanation that exists for this library is this acknowledgement in the Emacs manual: Shenghuo Zhu wrote `binhex.el', a package for reading and writing binhex files. There needs to be some description somewhere of what a binhex file is and of what you can do with this library's functions. At least one or two lines (e.g. inspired from wikipedia), please. Mention that it is (was?) for Mac OS and that it is similar to Uuencode. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2010-11-22 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4) --no-opt --cflags -Ic:/imagesupport/include'