From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: martin rudalics Newsgroups: gmane.emacs.devel Subject: Re: Support for butterfly editing Date: Fri, 08 Feb 2008 10:59:46 +0100 Message-ID: <47AC2812.1050807@gmx.at> References: <87prv848t0.wl%raffael.mancini@hcl-club.lu> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1202464871 13108 80.91.229.12 (8 Feb 2008 10:01:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 8 Feb 2008 10:01:11 +0000 (UTC) Cc: emacs-devel@gnu.org To: raffael.mancini@hcl-club.lu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Feb 08 11:01:32 2008 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JNQ2z-0003mO-1o for ged-emacs-devel@m.gmane.org; Fri, 08 Feb 2008 11:01:29 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JNQ2W-0004tq-Dr for ged-emacs-devel@m.gmane.org; Fri, 08 Feb 2008 05:01:00 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JNQ25-0004YZ-Vm for emacs-devel@gnu.org; Fri, 08 Feb 2008 05:00:34 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JNQ22-0004Se-9X for emacs-devel@gnu.org; Fri, 08 Feb 2008 05:00:32 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JNQ21-0004SM-Fw for emacs-devel@gnu.org; Fri, 08 Feb 2008 05:00:30 -0500 Original-Received: from mail.gmx.net ([213.165.64.20]) by monty-python.gnu.org with smtp (Exim 4.60) (envelope-from ) id 1JNQ20-0001BN-Tb for emacs-devel@gnu.org; Fri, 08 Feb 2008 05:00:29 -0500 Original-Received: (qmail invoked by alias); 08 Feb 2008 10:00:27 -0000 Original-Received: from N932P008.adsl.highway.telekom.at (EHLO [62.47.60.104]) [62.47.60.104] by mail.gmx.net (mp055) with SMTP; 08 Feb 2008 11:00:27 +0100 X-Authenticated: #14592706 X-Provags-ID: V01U2FsdGVkX18WChQTlu0W5vYvzuY6wn6gPmv/MncD8W7RZfluTe p2W+YgqweyIpfo User-Agent: Mozilla Thunderbird 1.0 (Windows/20041206) X-Accept-Language: de-DE, de, en-us, en In-Reply-To: <87prv848t0.wl%raffael.mancini@hcl-club.lu> X-Y-GMX-Trusted: 0 X-detected-kernel: by monty-python.gnu.org: Linux 2.6 (newer, 1) 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: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:88511 Archived-At: > "This function is designed to be used only be the most\ > proficient hackers on earth. If equipped with a butterfly key, > it\ should be bound to C-x M-c M-butterfly (for further > information please refer to http://xkcd.com/378/" With this doc-string C-h f RET butterfly RET gives on my system butterfly is an interactive Lisp function. (butterfly) This function is designed to be used only be the mostproficient hackers on earth. If equipped with a butterfly key, itshould be bound to C-x M-c M-butterfly (for further information please refer to http://xkcd.com/378/ The doc-string violates at least the following four conventions from appendix D.6 of the Emacs Lisp Reference Manual The first line of the documentation string should consist of one or two complete sentences that stand on their own as a summary. For a function, the first line should briefly answer the question, "What does this function do?" Finally, to create a hyperlink to URLs, write the URL in single quotes, preceded by `URL'. Don't write key sequences directly in documentation strings. has two silly backslashes and misses a right paren and a period. I think C-h f RET butterfly RET should give something like butterfly is an interactive Lisp function. It is bound to . (butterfly) Flip desired bit on drive platter. This function is designed to be used only by the most proficient hackers on earth. For further information please refer to `http://xkcd.com/378/'.