From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Tino Calancha Newsgroups: gmane.emacs.devel Subject: Re: "internal" designation [ Date: Wed, 12 Oct 2016 14:11:05 +0900 Message-ID: <87mviaup7a.fsf@gmail.com> References: <48df5626-be32-ffb0-55f5-1b6f116a6940@easy-emacs.de> <87fuo3r1p0.fsf@gmail.com> <08d6c55e-f060-fabc-5657-2e80a1d06ab0@easy-emacs.de> <878ttu97e3.fsf@gmail.com> <37cfca80-c58d-41b5-9cb5-b510bb97ecc5@default> <0568ffe9-4dc2-44fe-c2a2-4ea99f9cf4e4@easy-emacs.de> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1476249349 30148 195.159.176.226 (12 Oct 2016 05:15:49 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 12 Oct 2016 05:15:49 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) Cc: tino.calancha@gmail.com, Drew Adams , emacs-devel@gnu.org To: Andreas =?utf-8?Q?R=C3=B6hler?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Oct 12 07:15:45 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1buBt6-0005ph-2O for ged-emacs-devel@m.gmane.org; Wed, 12 Oct 2016 07:15:32 +0200 Original-Received: from localhost ([::1]:59356 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1buBt4-0002bF-K3 for ged-emacs-devel@m.gmane.org; Wed, 12 Oct 2016 01:15:30 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46206) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1buBow-0007xa-2V for emacs-devel@gnu.org; Wed, 12 Oct 2016 01:11:15 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1buBos-00034Z-0P for emacs-devel@gnu.org; Wed, 12 Oct 2016 01:11:13 -0400 Original-Received: from mail-pf0-x233.google.com ([2607:f8b0:400e:c00::233]:34847) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1buBor-00034P-Q4 for emacs-devel@gnu.org; Wed, 12 Oct 2016 01:11:09 -0400 Original-Received: by mail-pf0-x233.google.com with SMTP id s8so13068735pfj.2 for ; Tue, 11 Oct 2016 22:11:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:subject:references:cc:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=mkvWX1OOcjngcCSUpHyfNmRiuPVmv5lW15dIEpIA4aw=; b=os1wOfJihqOo//B5cojWFaf1p4n15WahLPShq9MQ9DC+qTp5icv87l+KZWGhcqz3iz d/avqnkImxp7DdTPdVUYbB+1aLVEwpfl1hh+Im2Wz0l/zLktmxwU7+N75hpeTQ69+enj RXoPgcdteXM7/UvBXSZfaVqoS8Emdx7GCW+6f0/skxkCcYZKYhWd5AGzxbKyL/tXoLyZ Ozq+o6PYRpVAM6LYYtxJHOyOljqUi8DPjIUSMZ96gdf6/lZyOsGRHdRgDEg/DvVeoCog w7fpsTvxuDGPgRcWHHT0vsWeRPXeC95yjT95KjfdF9PxHvZ1m7UgVLP8YhbdPzuh5z2v cy5w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:subject:references:cc:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=mkvWX1OOcjngcCSUpHyfNmRiuPVmv5lW15dIEpIA4aw=; b=DmW7Ej6RjL5vaIcA7EuMyE/szf+glCKCt2L9ZWFLWOTjdAy6PqYzEv5QWsU1ZK5uq8 JRAT6PFdouwp6jIuNsAcVS3xX7jf6gzeqcjF6TsEm9Qvs/ZnMLPq9ol66ByFE/vLxqpn rZZMHBiaILFeQvVZX+/AOHWc9ZTY3HRf7KyDmcPPNQfUzE+amJ7d2mtmMf/dQBXRpjQH kePtC8Rl1uGXPYNzFiBSzxP/uWg6dgS1ZfJyHLebyK7AYy8ge/4V0bVsf/YLtPYpD1FB j5ve6tpuS868HUYSWrZR0jI3cL/gXIlJu/M386DJR922JObe6KoJlu5O5t0NYB3uY1ul nXUg== X-Gm-Message-State: AA6/9RnvwSQPeESwvvkLJGNrphSFG+is7G3hMl1jikxBIyMLZBw2GYFV1sqxTsMOU957yg== X-Received: by 10.99.4.141 with SMTP id 135mr6261131pge.175.1476249068946; Tue, 11 Oct 2016 22:11:08 -0700 (PDT) Original-Received: from calancha-pc (57.92.100.220.dy.bbexcite.jp. [220.100.92.57]) by smtp.gmail.com with ESMTPSA id af17sm8175043pac.14.2016.10.11.22.11.07 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 11 Oct 2016 22:11:08 -0700 (PDT) In-Reply-To: <0568ffe9-4dc2-44fe-c2a2-4ea99f9cf4e4@easy-emacs.de> ("Andreas \=\?utf-8\?Q\?R\=C3\=B6hler\=22's\?\= message of "Tue, 11 Oct 2016 21:13:22 +0200") X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:400e:c00::233 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:208168 Archived-At: Andreas R=C3=B6hler writes: > On 11.10.2016 19:20, Drew Adams wrote: >> (Sorry - I initially put this in a reply to the bug thread. >> Meant to send it here.) >> >>> (defun thing-at-point-bounds-of-list-at-point () >>> "Return the bounds of the list at point. >>> -[Internal function used by `bounds-of-thing-at-point'.]" >>> +\[Internal function used by `bounds-of-thing-at-point'.\]" >> FWIW: >> >> I object to such an "internal" designation being in that doc string. > > BTW this function looks redundant - can't see why lists shouldn't be > dealt with from > > bounds-of-thing-at-point I don't think is redundant. This function allows to write a much simple `bounds-of-thing-at-point'. Try to write a `bounds-of-thing-at-point' which handles symbol, list, sexp, etc. You will see why it's nice to have `thing-at-point-bounds-of-list-at-point'. Similar 'thing' happen with number: `bounds-of-thing-at-point' doesn't return the boundaries of a number. Instead, the boundaries of a number are obtained with `thing-at-point-looking-at' inside `number-at-point'. I guess, trying to modify `bounds-of-thing-at-point' to match all kind of entities would increase the complexity of that function too much.