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 18:22:02 +0200 Message-ID: References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=089e0111bc644c36ad04efa02041 X-Trace: ger.gmane.org 1389370929 27053 80.91.229.3 (10 Jan 2014 16:22:09 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 10 Jan 2014 16:22:09 +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 17:22:14 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 1W1eqb-0004bO-OO for ged-emacs-devel@m.gmane.org; Fri, 10 Jan 2014 17:22:13 +0100 Original-Received: from localhost ([::1]:57666 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1eqb-0007nD-9Z for ged-emacs-devel@m.gmane.org; Fri, 10 Jan 2014 11:22:13 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41036) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1eqT-0007gT-VO for emacs-devel@gnu.org; Fri, 10 Jan 2014 11:22:10 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1W1eqR-0000Nd-NE for emacs-devel@gnu.org; Fri, 10 Jan 2014 11:22:05 -0500 Original-Received: from mail-ob0-x22c.google.com ([2607:f8b0:4003:c01::22c]:64753) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1eqR-0000NP-Hr for emacs-devel@gnu.org; Fri, 10 Jan 2014 11:22:03 -0500 Original-Received: by mail-ob0-f172.google.com with SMTP id gq1so5001134obb.17 for ; Fri, 10 Jan 2014 08:22:02 -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=RT+gyOU5UOPVy8FW0m8vjJcr3Z7rSzSOlUtBxZMVqag=; b=dgZ3wvT1H9POHVO1/NR9XWwtXFDR/kPka6pQU5x7hvxFICZjWgztre6jnoN6KOVK2C bCLcS9SX9qUEawVgqM75xrSQWURdNRHZpWZ4hpk5DUF+5hRhbA4wNgM8dl/bcKJELjWT Cblmgxpd6j7pC/G9PcXsKKb277aX3krCVglFZy1Dj5W9Ce1+zdoYzlfnbqL63IitVvXr U2pd5WuYmK0xHoIWeLxtk8UAK+q64Um/EcjXiJwPzZUyYkr1XsZKhY7VVfavCoVU9URP 00onS1/YCau2/eUD3TkHlUb0piRvA+2gLlz7AakrPk6ZXwX5/H6dtAFlDIABZpcnvNsL XKAg== X-Received: by 10.60.78.9 with SMTP id x9mr1936279oew.72.1389370922510; Fri, 10 Jan 2014 08:22:02 -0800 (PST) Original-Received: by 10.76.109.98 with HTTP; Fri, 10 Jan 2014 08:22:02 -0800 (PST) In-Reply-To: X-Google-Sender-Auth: lza83_8qlFJps7ph0O4UZcLqMU8 X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:4003:c01::22c 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:168018 Archived-At: --089e0111bc644c36ad04efa02041 Content-Type: text/plain; charset=UTF-8 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. On 10 January 2014 17:22, Stefan Monnier wrote: > > Document `subr-x' functions. > > Please don't. The Elisp manual is already very large, we don't want to > document everything in it. > > > Stefan > > --089e0111bc644c36ad04efa02041 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
There should be some guidelines about what needs documenti= ng and what doesn't. Personally, I feel that hash and string related fu= nctions are worth documenting, as many people are likely learning Elisp by = reading the Elisp manual.


On 10 January= 2014 17:22, Stefan Monnier <monnier@iro.umontreal.ca> wrote:
> =C2=A0 Document `subr-x' functions.=

Please don't. =C2=A0The Elisp manual is already very large, we don'= t want to
document everything in it.


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


--089e0111bc644c36ad04efa02041--