From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: Changes in revision 114466 Date: Sun, 29 Sep 2013 22:21:18 -0700 (PDT) Message-ID: <8c8eb64b-74ca-4fba-bb35-a799582423da@default> References: <831u49fkxk.fsf@gnu.org> <83pprse4mf.fsf@gnu.org> <87ioxk3x9z.fsf@zigzag.favinet> 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 1380518510 31325 80.91.229.3 (30 Sep 2013 05:21:50 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 30 Sep 2013 05:21:50 +0000 (UTC) Cc: emacs-devel To: Xue Fuqiao , Thien-Thi Nguyen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 30 07:21:52 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 1VQVva-0003CB-V7 for ged-emacs-devel@m.gmane.org; Mon, 30 Sep 2013 07:21:51 +0200 Original-Received: from localhost ([::1]:46937 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQVva-0005Ps-1p for ged-emacs-devel@m.gmane.org; Mon, 30 Sep 2013 01:21:50 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43807) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQVvO-0005Pj-Ln for emacs-devel@gnu.org; Mon, 30 Sep 2013 01:21:47 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VQVvG-0005iW-55 for emacs-devel@gnu.org; Mon, 30 Sep 2013 01:21:38 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:27258) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQVv6-0005bY-VO; Mon, 30 Sep 2013 01:21:21 -0400 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r8U5LHbM002161 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 30 Sep 2013 05:21:17 GMT Original-Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r8U5LGRt001844 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Mon, 30 Sep 2013 05:21:16 GMT Original-Received: from abhmt103.oracle.com (abhmt103.oracle.com [141.146.116.55]) by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r8U5LGEI001839; Mon, 30 Sep 2013 05:21:16 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 141.146.126.69 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:163723 Archived-At: > 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?