From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: =?ISO-8859-1?Q?R=FCdiger?= Sonderfeld Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] trunk r115961: Document `subr-x' functions. Date: Fri, 10 Jan 2014 17:26:17 +0100 Message-ID: <2254903.gTYTJaMKO1@descartes> References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1389371201 30813 80.91.229.3 (10 Jan 2014 16:26:41 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 10 Jan 2014 16:26:41 +0000 (UTC) Cc: Stefan Monnier To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jan 10 17:26:47 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 1W1ev0-00048D-Pe for ged-emacs-devel@m.gmane.org; Fri, 10 Jan 2014 17:26:46 +0100 Original-Received: from localhost ([::1]:57675 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1ev0-0001DB-2z for ged-emacs-devel@m.gmane.org; Fri, 10 Jan 2014 11:26:46 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42022) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1eur-0001D5-6Z for emacs-devel@gnu.org; Fri, 10 Jan 2014 11:26:44 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1W1euj-0001pz-Fh for emacs-devel@gnu.org; Fri, 10 Jan 2014 11:26:37 -0500 Original-Received: from ptmx.org ([178.63.28.110]:35743) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W1euj-0001li-8e for emacs-devel@gnu.org; Fri, 10 Jan 2014 11:26:29 -0500 Original-Received: from localhost (localhost [127.0.0.1]) by ptmx.org (Postfix) with ESMTP id C620324CE0; Fri, 10 Jan 2014 17:26:27 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at ptmx.org Original-Received: from ptmx.org ([127.0.0.1]) by localhost (ptmx.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 3NieJs1c8AO3; Fri, 10 Jan 2014 17:26:26 +0100 (CET) Original-Received: from descartes.localnet (chello080108246092.7.14.vie.surfer.at [80.108.246.92]) by ptmx.org (Postfix) with ESMTPSA id 60EA624B79; Fri, 10 Jan 2014 17:26:26 +0100 (CET) User-Agent: KMail/4.11.3 (Linux/3.11.0-14-generic; KDE/4.11.3; x86_64; ; ) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 178.63.28.110 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:168019 Archived-At: On Friday 10 January 2014 10:22:51 Stefan Monnier wrote: > > Document `subr-x' functions. >=20 > Please don't. The Elisp manual is already very large, we don't want = to > document everything in it. They weren't marked "---" in NEWS and the hash-table functions were alr= eady=20 documented. Right now `subr-x' is too small to deserve a separate manu= al. =20 Maybe not every function should be documented but there should be at le= ast a=20 hint in the manual to make it more discoverable. Shall I revert the patch? Regards, R=C3=BCdiger