From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Josh Newsgroups: gmane.emacs.devel Subject: Re: About `--' (was Re: filenotify.el) Date: Sun, 30 Jun 2013 11:50:34 -0700 Message-ID: References: <87d2ra9z4x.fsf@gmx.de> <1383316.4Bc292dOgY@descartes> <87vc52yq04.fsf@gmx.de> <4199085.Bycd8r9Vun@descartes> <8761x12x4k.fsf@gmx.de> <878v1x71lb.fsf_-_@rosalinde.fritz.box> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: ger.gmane.org 1372618272 12244 80.91.229.3 (30 Jun 2013 18:51:12 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 30 Jun 2013 18:51:12 +0000 (UTC) Cc: =?ISO-8859-1?Q?R=FCdiger_Sonderfeld?= , Stephen Berman , Michael Albinus , emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jun 30 20:51:12 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UtMiO-0004zZ-C2 for ged-emacs-devel@m.gmane.org; Sun, 30 Jun 2013 20:51:12 +0200 Original-Received: from localhost ([::1]:52710 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UtMiO-0004tb-2c for ged-emacs-devel@m.gmane.org; Sun, 30 Jun 2013 14:51:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60171) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UtMiK-0004sA-JG for emacs-devel@gnu.org; Sun, 30 Jun 2013 14:51:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UtMiH-00017x-Lw for emacs-devel@gnu.org; Sun, 30 Jun 2013 14:51:08 -0400 Original-Received: from mail-qa0-f52.google.com ([209.85.216.52]:62205) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UtMiH-00016L-IX for emacs-devel@gnu.org; Sun, 30 Jun 2013 14:51:05 -0400 Original-Received: by mail-qa0-f52.google.com with SMTP id bv4so1633711qab.11 for ; Sun, 30 Jun 2013 11:51:04 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type :x-gm-message-state; bh=nWZATUFJdehYDjrEkPEMBU9jLuegRTRBXeeg8VP2raQ=; b=j/yg4A4Ve/+OttrRf6eKbc7Yv3BLuSugZCt4eK/iG095j6LIAQ1rzoaTG/pYRSDZK6 aB/77wxyL9k6n7nxGaTyRrPPXrwD8MI1gw3n5+YhdC2/Ujw5EThQe3HdhfVcYFK1A1Ha jMY2diAqUxH/IdBUz5Mc4sTM8VeaKzBsNh922hpmaYnPJdgnvflEfQaGpKnPEzU7+nTv kOwASEmM8V/1PnZ5LVSWBHw5bh1lnBDB3tWsCN3hD2GEtW0Os916DFp4u/0oCJNgg+Xe zpmdr1aPsKiRke50CIyTS3xNkKg0kOsrrFHiOVSXcJ3QVpGy8GQmVk1QQ9Bm1C1BoLiQ O0yQ== X-Received: by 10.229.201.129 with SMTP id fa1mr6745382qcb.103.1372618264769; Sun, 30 Jun 2013 11:51:04 -0700 (PDT) Original-Received: by 10.49.17.136 with HTTP; Sun, 30 Jun 2013 11:50:34 -0700 (PDT) In-Reply-To: X-Google-Sender-Auth: XszEYwBw77EnKyrevBzvb3Pm-RY X-Gm-Message-State: ALoCoQlz/H5S4GVK5GGfY5TEfo9YzWD4cJH6Ndf7ov/3WRFtyjKA54yTLhB+z5Ynr3BbgQdZOZ6X X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.85.216.52 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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 Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:161378 Archived-At: On Fri, Jun 28, 2013 at 2:59 PM, Richard Stallman wrote: > The downside of this is that it would require documenting all these > functions in the Emacs Lisp Reference Manual, which is already > unwieldy. What does "unwieldy" mean in the context of an easily searchable and navigable hypertext resource like the elisp manual? > It might be better for people to reinvent these as needed. > Or put them in a separate category with the prefix `aux-' and document > them in a different manual. People are already reinventing such functions in large numbers today, but I believe this is frequently not "as needed" but because we wrongly believe it doesn't exist yet after failing to find evidence to the contrary in the documentation and/or source code where it would logically appear if it did. It seems to me that prefixing some set of functions (which ones?) with "aux-" and documenting them in a separate manual could only exacerbate this problem.