From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Albinus Newsgroups: gmane.emacs.devel Subject: Re: Docstrings and manuals Date: Sun, 17 Apr 2016 10:49:56 +0200 Message-ID: <87k2jwd3gr.fsf_-_@gmx.de> References: <6ok2vyzwf9.fsf@fencepost.gnu.org> <08f70cda-44be-0657-e50a-2b2c80d2c21c@yandex.ru> <87oa9dzgl0.fsf@gmx.de> <87potshczh.fsf@gmx.de> <87h9f4ghzg.fsf@gmx.de> <8737qnc8ep.fsf@gmx.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1460883021 17910 80.91.229.3 (17 Apr 2016 08:50:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 17 Apr 2016 08:50:21 +0000 (UTC) Cc: Glenn Morris , emacs-devel To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Apr 17 10:50:10 2016 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 1ariP9-00008O-UP for ged-emacs-devel@m.gmane.org; Sun, 17 Apr 2016 10:50:08 +0200 Original-Received: from localhost ([::1]:42600 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ariP9-0006ae-7k for ged-emacs-devel@m.gmane.org; Sun, 17 Apr 2016 04:50:07 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55082) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ariP5-0006SM-Hf for emacs-devel@gnu.org; Sun, 17 Apr 2016 04:50:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ariP4-00060d-NF for emacs-devel@gnu.org; Sun, 17 Apr 2016 04:50:03 -0400 Original-Received: from mout.gmx.net ([212.227.17.22]:56621) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ariOz-0005zj-UB; Sun, 17 Apr 2016 04:49:58 -0400 Original-Received: from detlef.gmx.de ([87.146.42.239]) by mail.gmx.com (mrgmx103) with ESMTPSA (Nemesis) id 0MPlMc-1ammRy44fq-004x3o; Sun, 17 Apr 2016 10:49:57 +0200 In-Reply-To: (Dmitry Gutov's message of "Sun, 17 Apr 2016 03:17:54 +0300") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) X-Provags-ID: V03:K0:lDm4BeLyXLH3eAInxlVo051KOXZmNUO968Y9MM2jb5afOdjJmUi Bap8gxloOFPnOKxSfaCFsr3Nit8VGI/BwiR90JoqxFhYfEss+RfNnAhyBHbKiSnG5b9BbX/ M6xm/JRtsRmSq4ZQmfnYgYoCf9LtRZYCMLhNulgGDSQcnY8iQaATg6+msdvXDJNsVJu8Vi8 +X+f4pKPkzvCFPqT7QG5A== X-UI-Out-Filterresults: notjunk:1;V01:K0:C9wJ0R3SExg=:3TRNmV4y9HVcSSY8vj45B6 ceyaEV2czHFMk776XaB+5THx7qptPjH3THX9EWYkecEYCb3dP6PzZ8Fax2V6pIjBHI8n5wOG+ rMEUFiWdN1IsIZlCIb+ejStIfF7dTQLhgSFuqfiS0lEvtbHLWXdGUcGyGlAOMkGINyvxjoMUY WlzdM0pV60Lt7aGt1e2/dnGwSJK6wz8DKkWm7wAaRnZ0Rw6M9ahXzSO0vklWTxD54hfINyuF1 1FRCyQuG93M4eg5OJnAMYamnPrcHRRKXisLLtqq8DAstzlbzJQNYywRuY+AmSfypPRDLzv+mj nOmTiqt11O53+SkShmTEGtayZFFbN0eMVQEfG0G6XDmue0BMfQTuiNLcO/OvbyS2Ps9zd3Nik +yHmNL3Br/YzKY/Zka1+JIkkeAl4zNruqaGdJbGi5C0BLDcMB4ZPFH2vQ7ILHmtfL+T3Y4Yib 9VxQ4danpcikMlefaDT7HNQjexnnTUOk6cQuuji0DR86A2p6fp6bFTBVd+rnOt4i0RWPBPEjV +nW3fkZMrwGnbgY2m16LMKHiWjPEfNwz4jUrhdliQNUw3HHYFKMamhbX5Lp6Qpl2sg+b8auYm HF4SGEgmWJw+iEOvjQJ3OmkGvQP2Fgtd6GMCJMX9DS1utkqgE27z1waU7zVXMSAMTtRihqfgf eKUQDfhKNFdfe1llDyujOifPthRHS7vswifYG+TuhrzHwuTOsTzTPIJA9vBBlF450ju6wlTXL 9vNirn0LZDP49iTtSwRkR5PUj7hamK+IdfNioUknWt0PWJQaE3wCE5+Fw95FuGUXkgfIMShZ X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 212.227.17.22 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:203004 Archived-At: Dmitry Gutov writes: > So, to be clear, I dislike the ambiguity that manuals that try to be > all-encompassing, like this one, create about the main source of > information about each function. We will always find examples where the entries in the manual are inferior, compared with the docstring. We will also find examples with incompatible information in the docstring and the manual. This does not mean that manuals are useless. It only means, that there's a bug to be fixed. Best regards, Michael.