From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: =?UTF-8?B?QW5kcmVhcyBSw7ZobGVy?= Newsgroups: gmane.emacs.devel Subject: Re: Changes in revision 114466 Date: Mon, 30 Sep 2013 13:47:44 +0200 Message-ID: <524964E0.4040607@online.de> References: <831u49fkxk.fsf@gnu.org> <83pprse4mf.fsf@gnu.org> <87ioxk3x9z.fsf@zigzag.favinet> <8c8eb64b-74ca-4fba-bb35-a799582423da@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1380541551 19539 80.91.229.3 (30 Sep 2013 11:45:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 30 Sep 2013 11:45:51 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 30 13:45:53 2013 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 1VQbvF-0003x7-2h for ged-emacs-devel@m.gmane.org; Mon, 30 Sep 2013 13:45:53 +0200 Original-Received: from localhost ([::1]:48291 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQbvE-00060J-Ms for ged-emacs-devel@m.gmane.org; Mon, 30 Sep 2013 07:45:52 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59901) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQbv3-00060A-Nw for emacs-devel@gnu.org; Mon, 30 Sep 2013 07:45:49 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VQbuw-0000WG-92 for emacs-devel@gnu.org; Mon, 30 Sep 2013 07:45:41 -0400 Original-Received: from moutng.kundenserver.de ([212.227.126.187]:54698) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQbuv-0000W4-Vz for emacs-devel@gnu.org; Mon, 30 Sep 2013 07:45:34 -0400 Original-Received: from purzel.sitgens (brln-4db90f82.pool.mediaWays.net [77.185.15.130]) by mrelayeu.kundenserver.de (node=mrbap1) with ESMTP (Nemesis) id 0LswsU-1VpP8b1i5C-011zMA; Mon, 30 Sep 2013 13:45:31 +0200 User-Agent: Mozilla/5.0 (X11; Linux i686; rv:24.0) Gecko/20100101 Thunderbird/24.0 In-Reply-To: <8c8eb64b-74ca-4fba-bb35-a799582423da@default> X-Provags-ID: V02:K0:LYY6FOXNByxs+QghRTiQLqBPegD3qOdKxcpbZTuozwC QNIXifMzTZga4c4z6Ovu6iEjTZ8oGMj3EIXZRzl5Mtf4Nzrhd+ S7lAo4mFBQQ4cVQGZooTspH2H48OxObr+OsMFqUOUhaz8YZ4KN cncgHTPJvL18f29zt3mSvNmEnCp3DsczeSZX4J1SJT4qfL8Joh kOPtMCm8IkXv5+IsHKbzynevayPCx2CL0rIQjnS/22ApgjUV3Z JCyMbcYN66WFukgVj3pV2rsFHAtpR27dYtLv8RLEu/h42SY0Uc Br8ZQA+ppSsVDAkYrw7FtEL5Fe7A3/28Pe6TOgN7KhdOzXTZHv krmHBpVjmTCNOg9yEBRk= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 212.227.126.187 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:163725 Archived-At: Am 30.09.2013 07:21, schrieb Drew Adams: >> But I see one problem: not every {functions, variables, ...} needs >> documenting. E.g., some functions/variables use two hyphens to separate >> prefix. These functions/variables usually don't needs documenting. > > Why not? Do you think developers do not need documentation? > >> IMO every user option and every command needs documentation. > > IMO also. And pretty much every function, variable, face, widget,... > Why not? > > IMO that depends, in some cases would welcome that. OTOH a lot is either trivial or the kind, I would want to read the code, no explanations, maybe run with edebug. Some comments inside the code seem best than.