From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Bozhidar Batsov Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] trunk r115961: Document `subr-x' functions. Date: Fri, 10 Jan 2014 19:40:37 +0200 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=e89a8ff1c01c57e47704efa139ac X-Trace: ger.gmane.org 1389375648 20620 80.91.229.3 (10 Jan 2014 17:40:48 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 10 Jan 2014 17:40:48 +0000 (UTC) Cc: =?UTF-8?Q?R=C3=BCdiger_Sonderfeld?= , emacs-devel To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jan 10 18:40:55 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 1W1g4f-0001Y0-BT for ged-emacs-devel@m.gmane.org; Fri, 10 Jan 2014 18:40:49 +0100 Original-Received: from localhost ([::1]:58116 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1g4e-0001bu-Oc for ged-emacs-devel@m.gmane.org; Fri, 10 Jan 2014 12:40:48 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57554) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1g4a-0001bl-P6 for emacs-devel@gnu.org; Fri, 10 Jan 2014 12:40:46 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1W1g4V-0007TR-2G for emacs-devel@gnu.org; Fri, 10 Jan 2014 12:40:44 -0500 Original-Received: from mail-oa0-x235.google.com ([2607:f8b0:4003:c02::235]:47450) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1g4U-0007Sn-F9 for emacs-devel@gnu.org; Fri, 10 Jan 2014 12:40:38 -0500 Original-Received: by mail-oa0-f53.google.com with SMTP id h16so5228027oag.26 for ; Fri, 10 Jan 2014 09:40:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:cc:content-type; bh=wokPqcr1Ey998u/mMuVw4JUdhMPz670rQSkv3bcWG/8=; b=IZaZLx9WPl/T4VUg3wd8lAQnHpdPfeG7t/hIa7qv/JPwqf8D4HYS2+F+v3v2zC1/MB 2GbMRzrcsULlgjz45Sf3Va0m0zUzrJsxj1ClGJlA/Kgjx2p7aDp25Yvi6wIj3g/xlNPb jbB1LiHnN2vUaXHj7yHG6UFGvMs7QC4qkHZXJgqDFV982SwE848dxmwU0H1IA0fA5Yb3 AJE8zwQLjJB6LNv0yME7qGPcpOimpVp0OrekkRtLpIQBFT3Pofhe3Tcmo25oeVHilVVb F7HHTv45w1FbBDxhlXp0Pit3Zz1VOCgsiRitcUjC6Gh4cdpHMRNFrIu+kHB9gIDyD/Kz PY2w== X-Received: by 10.182.204.41 with SMTP id kv9mr1665778obc.78.1389375637675; Fri, 10 Jan 2014 09:40:37 -0800 (PST) Original-Received: by 10.76.109.98 with HTTP; Fri, 10 Jan 2014 09:40:37 -0800 (PST) In-Reply-To: X-Google-Sender-Auth: 7_ieenWydhpH6874-nthBvg9kek X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:4003:c02::235 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:168026 Archived-At: --e89a8ff1c01c57e47704efa139ac Content-Type: text/plain; charset=UTF-8 Fair enough. On 10 January 2014 19:24, Stefan Monnier wrote: > > 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 > --e89a8ff1c01c57e47704efa139ac Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
Fair enough.


On 10 January 2014 19:24, Stefan Monnier <mon= nier@iro.umontreal.ca> wrote:
> There should be some = guidelines about what needs documenting and what
> doesn't. =C2=A0Personally, I feel that hash and string related fun= ctions 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 en= ough to
deserve to be in subr.el, so for the same reason I don't think they
belong in the Lispref either.


=C2=A0 =C2=A0 =C2=A0 =C2=A0 Stefan

--e89a8ff1c01c57e47704efa139ac--