From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thien-Thi Nguyen Newsgroups: gmane.emacs.devel Subject: Re: Changes in revision 114466 Date: Mon, 30 Sep 2013 17:52:18 +0200 Message-ID: <87bo3a4899.fsf@zigzag.favinet> References: <831u49fkxk.fsf@gnu.org> <83pprse4mf.fsf@gnu.org> <87ioxk3x9z.fsf@zigzag.favinet> <8c8eb64b-74ca-4fba-bb35-a799582423da@default> <87txh24n7d.fsf@rosalinde.fritz.box> <4af8d59a-d39a-4731-85d9-86fa2f01b5fa@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-Trace: ger.gmane.org 1380556165 3291 80.91.229.3 (30 Sep 2013 15:49:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 30 Sep 2013 15:49:25 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 30 17:49:27 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 1VQfit-00013d-II for ged-emacs-devel@m.gmane.org; Mon, 30 Sep 2013 17:49:23 +0200 Original-Received: from localhost ([::1]:49973 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQfit-0000cG-5O for ged-emacs-devel@m.gmane.org; Mon, 30 Sep 2013 11:49:23 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34542) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQfil-0000Tn-4m for emacs-devel@gnu.org; Mon, 30 Sep 2013 11:49:20 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VQfif-0004YY-Jt for emacs-devel@gnu.org; Mon, 30 Sep 2013 11:49:15 -0400 Original-Received: from smtp209.alice.it ([82.57.200.105]:44200) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQfif-0004YG-7H for emacs-devel@gnu.org; Mon, 30 Sep 2013 11:49:09 -0400 Original-Received: from zigzag.favinet (95.233.75.30) by smtp209.alice.it (8.6.060.28) id 52443BB000DAB6EE for emacs-devel@gnu.org; Mon, 30 Sep 2013 17:49:05 +0200 Original-Received: from ttn by zigzag.favinet with local (Exim 4.80) (envelope-from ) id 1VQflt-0003XO-6T for emacs-devel@gnu.org; Mon, 30 Sep 2013 17:52:29 +0200 Mail-Followup-To: emacs-devel@gnu.org In-Reply-To: <4af8d59a-d39a-4731-85d9-86fa2f01b5fa@default> (Drew Adams's message of "Mon, 30 Sep 2013 08:05:04 -0700 (PDT)") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 82.57.200.105 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:163736 Archived-At: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable () Drew Adams () Mon, 30 Sep 2013 08:05:04 -0700 (PDT) Having code does not preclude having comments. Having comments does not preclude having documentation. What precludes most results is the right combination of awareness and effort, which is in YMMV territory. Which is obvious by: [...] From my point of view: [...] My (likely lone) opinion remains [...] It sounds like the scanning program would do well to take options to control its selectivity, something like: -i, --inclusiveness N -- control what to include in the output; N is an integer from 1 (default) to 5: 1 -- "public" funcs, vars 2 -- 1 + faces 3 -- 2 + properties 4 -- 3 + private stuff 5 -- everything=20 Alternatively, something like: -f, --flag ASPECTS -- include only ASPECTS in output; ASPECTS is a comma-separated list, with elements from: function variable face property ... ALL (same as all of the above) -p, --private -- also include "private" elements (those with "--" in their name) The latter gives more control, which i like, but anyway the point is to enable those who want to take a bite out of the doc coverage pie to specify their appetite. Then, ttn the lazy bum can run it w/ =E2=80=98-f function=E2=80=99 and j.r.motivated-hacker can use =E2=80=98= -f ALL -p=E2=80=99. (Of course, what the Official Policy will be is another question. I think for this effort (increasing doc coverage), if we focus on clean mechanism, the need for lots of policy discussion will be reduced -- less need to leave /home, so to speak. :-D) =2D-=20 Thien-Thi Nguyen GPG key: 4C807502 (if you're human and you know it) read my lisp: (responsep (questions 'technical) (not (via 'mailing-list))) =3D> nil --=-=-= Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iEYEARECAAYFAlJJnjYACgkQZwMiJEyAdQJlJgCgi4yGuFW8NLCSdTtUj2H0q+/u t8oAn0xvDr1byxg9stJqsSGMblnfYGhb =IwFo -----END PGP SIGNATURE----- --=-=-=--