From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] trunk r115961: Document `subr-x' functions. Date: Fri, 10 Jan 2014 12:24:16 -0500 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1389374673 9412 80.91.229.3 (10 Jan 2014 17:24:33 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 10 Jan 2014 17:24:33 +0000 (UTC) Cc: =?windows-1252?Q?R=FCdiger?= Sonderfeld , emacs-devel To: Bozhidar Batsov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jan 10 18:24:36 2014 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 1W1fox-0007Kc-Au for ged-emacs-devel@m.gmane.org; Fri, 10 Jan 2014 18:24:35 +0100 Original-Received: from localhost ([::1]:58028 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1fow-0007ne-Px for ged-emacs-devel@m.gmane.org; Fri, 10 Jan 2014 12:24:34 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53305) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1fon-0007nJ-0z for emacs-devel@gnu.org; Fri, 10 Jan 2014 12:24:32 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1W1fof-000290-Ny for emacs-devel@gnu.org; Fri, 10 Jan 2014 12:24:24 -0500 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.181]:58095) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1fof-00028u-LF for emacs-devel@gnu.org; Fri, 10 Jan 2014 12:24:17 -0500 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AhAKABK/CFFFxKG9/2dsb2JhbABEvgwEA3sXc4IeAQEEAVYXDAULCzQSFBgNJIgeBsEtkQoDiGGcGYFegxU X-IPAS-Result: AhAKABK/CFFFxKG9/2dsb2JhbABEvgwEA3sXc4IeAQEEAVYXDAULCzQSFBgNJIgeBsEtkQoDiGGcGYFegxU X-IronPort-AV: E=Sophos;i="4.84,565,1355115600"; d="scan'208";a="44658386" Original-Received: from 69-196-161-189.dsl.teksavvy.com (HELO pastel.home) ([69.196.161.189]) by ironport2-out.teksavvy.com with ESMTP/TLS/ADH-AES256-SHA; 10 Jan 2014 12:24:17 -0500 Original-Received: by pastel.home (Postfix, from userid 20848) id 0B0356045A; Fri, 10 Jan 2014 12:24:17 -0500 (EST) In-Reply-To: (Bozhidar Batsov's message of "Fri, 10 Jan 2014 18:22:02 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 206.248.154.181 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:168024 Archived-At: > There should be some guidelines about what needs documenting and what > doesn't. Personally, I feel that hash and string related functions are > worth documenting, as many people are likely learning Elisp by reading the > Elisp manual. subr-x functions are functions which haven't yet proved useful enough to deserve to be in subr.el, so for the same reason I don't think they belong in the Lispref either. Stefan