From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#1144: closed by Chong Yidong (Re: 23.0.60; No doc string for `symbol-at-point' and other, similar functions) Date: Thu, 7 Jul 2011 10:30:21 -0700 Message-ID: References: <87ljwgbbh8.fsf@cyd.mit.edu><000e01c92bec$32d29eb0$0200a8c0@us.oracle.com><000501c9b680$6201bd00$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1310064572 15014 80.91.229.12 (7 Jul 2011 18:49:32 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 7 Jul 2011 18:49:32 +0000 (UTC) Cc: 1144@debbugs.gnu.org To: "'Lars Magne Ingebrigtsen'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jul 07 20:49:28 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Qetde-00088n-K2 for geb-bug-gnu-emacs@m.gmane.org; Thu, 07 Jul 2011 20:49:26 +0200 Original-Received: from localhost ([::1]:49117 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qetdd-0008Mt-FX for geb-bug-gnu-emacs@m.gmane.org; Thu, 07 Jul 2011 14:49:25 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:58606) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QesPp-0003Wk-RL for bug-gnu-emacs@gnu.org; Thu, 07 Jul 2011 13:31:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QesPn-0007qb-GS for bug-gnu-emacs@gnu.org; Thu, 07 Jul 2011 13:31:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:60664) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QesPn-0007qV-8o for bug-gnu-emacs@gnu.org; Thu, 07 Jul 2011 13:31:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QesPm-0007Qe-G9; Thu, 07 Jul 2011 13:31:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 07 Jul 2011 17:31:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 1144 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 1144-submit@debbugs.gnu.org id=B1144.131005983828412 (code B ref 1144); Thu, 07 Jul 2011 17:31:02 +0000 Original-Received: (at 1144) by debbugs.gnu.org; 7 Jul 2011 17:30:38 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QesPN-0007OD-IV for submit@debbugs.gnu.org; Thu, 07 Jul 2011 13:30:37 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QesPL-0007CD-9y for 1144@debbugs.gnu.org; Thu, 07 Jul 2011 13:30:35 -0400 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p67HURNw023450 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 7 Jul 2011 17:30:29 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p67HUQVY027143 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 7 Jul 2011 17:30:26 GMT Original-Received: from abhmt118.oracle.com (abhmt118.oracle.com [141.146.116.70]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p67HUL9D028136; Thu, 7 Jul 2011 12:30:21 -0500 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 07 Jul 2011 10:30:21 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Acw8yk2bSXaIAmKmSpeoxFDnO1ANxQAALb1Q X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090209.4E15ED35.007B:SCFMA922111,ss=1,re=-4.000,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Thu, 07 Jul 2011 13:31:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:48188 Archived-At: > >> Must I send a separate bug for each such function? I thought > >> when your complete response was "Done" that you had taken > >> care of all such functions. > >> > >> The following functions are all in the same boat. They are > >> all functions for which users will want to see the doc. > >> > >> beginning-of-thing > >> end-of-thing > >> in-string-p > >> end-of-sexp > >> beginning-of-sexp > >> thing-at-point-bounds-of-url-at-point > >> forward-whitespace > >> forward-symbol > >> forward-same-syntax > >> word-at-point > >> sentence-at-point > >> form-at-point > > No, Chong added documentation to the autoloaded, "external" functions, > but not the purely internal thingatpt functions. And I think > that's the right decision. No, it's not the right thing. Emacs users include Emacs-Lisp users. Users of thingatpt.el, in particular, are mainly Emacs-Lisp users. Whether to document something has nothing to do with whether it is a command or is autoloaded. That is, those predicates do not at all suffice to determine whether something should be documented. And for Emacs there really is no such thing as an "internal" function. Yes, we need not document every function or variable, and yes, some functions and variables we generally do not expect users to fiddle with. But Emacs is 100% open, and it should document itself, as originally intended.