From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Christopher Dimech Newsgroups: gmane.emacs.help Subject: Re: RE: bounds-of-thing-at-point for paragraphs Date: Sun, 1 Nov 2020 21:07:20 +0100 Message-ID: References: <568cb7cf-928b-4c5a-af3f-fd0d3d13f55a@default> <5ce46139-e884-45f9-9332-772ec50e6340@default> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19729"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Help Gnu Emacs , Jean Louis To: Drew Adams Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Sun Nov 01 21:09:45 2020 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kZJfc-00051T-Um for geh-help-gnu-emacs@m.gmane-mx.org; Sun, 01 Nov 2020 21:09:44 +0100 Original-Received: from localhost ([::1]:58376 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kZJfb-0001A9-Pk for geh-help-gnu-emacs@m.gmane-mx.org; Sun, 01 Nov 2020 15:09:44 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51034) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZJdu-00019k-Gc for help-gnu-emacs@gnu.org; Sun, 01 Nov 2020 15:07:58 -0500 Original-Received: from mout.gmx.net ([212.227.17.21]:54965) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZJds-0007Hy-F9 for help-gnu-emacs@gnu.org; Sun, 01 Nov 2020 15:07:58 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1604261240; bh=okZGULTyvheYR4HnN5eLfWbrP5hwPkx+W0c+/+w/+TY=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=QipAn7nFLO1lORsYdEoHSaX6joGUn22LMXLFfV/PzLDaO8hN4D6nKsWKpHXvXSz2k smxeDVmn63u2UK06dIdpakHinGwcCmlTJRPVhn5FMPF/L69gjOQ+JrgWmX6I+YY4OL o7IRnw06lzx8tt0+121FaV8pu0TI6u8YIU83qx4Y= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [213.165.168.94] ([213.165.168.94]) by web-mail.gmx.net (3c-app-mailcom-bs16.server.lan [172.19.170.184]) (via HTTP); Sun, 1 Nov 2020 21:07:20 +0100 Importance: normal Sensitivity: Normal In-Reply-To: <5ce46139-e884-45f9-9332-772ec50e6340@default> X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:wdSu6V2E+udF+RPCOXWH0VjFMOKAzGuhjPD+ZhGBpqGWA7Dz9v7uMPIRy9YBy7SZhKk+z y3crJK0FjXzLA67CoYJs2wV1ZzEG51VFAejVQM+NBlXl5oLHMPfC+gMazrlvGhVwU4U+plOX4qV6 Aj/wH2uTsqsQgVkedec2ZfhXECT1k5I8Q86i04HdWN3xyJYN1F9B8Bg/4ItB1+4XtEj1E8bL5Qwr uRonL98bBR+EelAK4Qi+DXnDjvjjUNLzIAKiGD3ZH7iKRW8QGMf+sFifnUPdZktF1B5yiW7V2kyh lg= X-UI-Out-Filterresults: notjunk:1;V03:K0:RD+CIg0zWeo=:uwZo3WR/53OxaQwNzHPVha j4uiyTz+e94r6yh+tholeXvuYtmC+LKGZXk8XFUfNujbYwqgmXXqMsa1ItNLfmeJi5xvEKdYX WeDPl7vHxATdZjJlyQCkeKcv52fhw3pLk5WjQesjsBCl0jZfbwRWbuNXSFDq0cvHbaJofqm/u ezc9Dts9ldchE5MWl2Q2bQ+OoAlAN1plPPa+DqXRQbW1Z5v6y0K+G3E/krJyBS6/qzThBkav9 71QP1jcxWbtSmppt9ad0wQB/r//jLianvwYKR2HppOp3fgNOi4YO6yz8SK4E8MNOEc/tvevLc 4mQMjry74k3bfymnbKLIVU8TnyCFUNZUinyi9MmDq+fiwzvH7fOaRmmTccvw16V8E99YUGUvW /pSF36VZF4Fk+Vo1C5DBwH7TV6IemyQmr/DV5Q+qqd0vu6hri9w5YeczfJuTL5o/yOoR18xs0 JGMlfP4z0w8Ij0UDOtLnN5nzkDvy9L0yV4d2xPdYK2ff5hHJk70j0OI7DgxsSild/Lk03Z1Nv e8lESUD0BV2hhSTArxpncKJqbN7vPDwoDzNF+aeAKNi04MsEhGpDdykROYMYy3BH2sdfdZhIA 7JRk/o27UfK78= Received-SPF: pass client-ip=212.227.17.21; envelope-from=dimech@gmx.com; helo=mout.gmx.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/01 15:07:54 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.io gmane.emacs.help:124901 Archived-At: Looking at thingatpt=2Eel is not helpful=2E If you know important things that are useful to know about it, place it at the top of the file=2E I customarily define a documentation function for the file so that it would be available interactively, even if mostly of interest to Elisp Designers=2E > Sent: Sunday, November 01, 2020 at 8:00 PM > From: "Drew Adams" > To: "Jean Louis" > Cc: "Christopher Dimech" , "Help Gnu Emacs" > Subject: RE: bounds-of-thing-at-point for paragraphs > > > > (bounds-of-thing-at-point 'paragraph) works fine=2E > >=20 > > It works fine, but documentation does not describe it: > >=20 > > bounds-of-thing-at-point is an autoloaded compiled Lisp function in > > =E2=80=98thingatpt=2Eel=E2=80=99=2E > >=20 > > (bounds-of-thing-at-point THING) > >=20 > > Determine the start and end buffer locations for the THING at point= =2E > > THING should be a symbol specifying a type of syntactic entity=2E > > Possibilities include =E2=80=98symbol=E2=80=99, =E2=80=98list=E2=80= =99, =E2=80=98sexp=E2=80=99, =E2=80=98defun=E2=80=99, > > =E2=80=98filename=E2=80=99, =E2=80=98url=E2=80=99, =E2=80=98email=E2= =80=99, =E2=80=98uuid=E2=80=99, =E2=80=98word=E2=80=99, =E2=80=98sentence= =E2=80=99, =E2=80=98whitespace=E2=80=99, > > =E2=80=98line=E2=80=99, and =E2=80=98page=E2=80=99=2E > >=20 > > See the file =E2=80=98thingatpt=2Eel=E2=80=99 for documentation on h= ow to define a > > valid THING=2E > >=20 > > Return a cons cell (START =2E END) giving the start and end > > positions of the thing found=2E >=20 > Just read it more carefully=2E >=20 > 1=2E "Possibilities include" > ^^^^^^^ >=20 > It doesn't say that those are the only possibilities=2E >=20 > 2=2E It points you to "`thingatpt=2Eel' for documentation on > how to define a valid THING=2E" IOW, for documentation > what makes a THING defined for use by `thing-at-point'=2E >=20 > > > (thing-at-point 'paragraph) also works fine=2E > >=20 > > Also there documentation is not describing it: > >=20 > > thing-at-point is an autoloaded compiled Lisp function in > > =E2=80=98thingatpt=2Eel=E2=80=99=2E > >=20 > > (thing-at-point THING &optional NO-PROPERTIES) > >=20 > > Probably introduced at or before Emacs version 20=2E > >=20 > > Return the THING at point=2E > > THING should be a symbol specifying a type of syntactic entity=2E > > Possibilities include =E2=80=98symbol=E2=80=99, =E2=80=98list=E2=80= =99, =E2=80=98sexp=E2=80=99, =E2=80=98defun=E2=80=99, > > =E2=80=98filename=E2=80=99, =E2=80=98url=E2=80=99, =E2=80=98email=E2= =80=99, =E2=80=98uuid=E2=80=99, =E2=80=98word=E2=80=99, =E2=80=98sentence= =E2=80=99, =E2=80=98whitespace=E2=80=99, > > =E2=80=98line=E2=80=99, =E2=80=98number=E2=80=99, and =E2=80=98page= =E2=80=99=2E >=20 > See above=2E The word "include" doesn't mean the > same thing as "include only" or "comprise"=2E The > list of THINGS mentioned isn't exhaustive=2E >=20 > The English language includes the words "thing" > and "point" (but it also includes a lot more words)=2E >