From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jean Louis Newsgroups: gmane.emacs.help Subject: Re: bounds-of-thing-at-point for paragraphs Date: Sun, 1 Nov 2020 23:36:12 +0300 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: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="18170"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mutt/+ (1036f0e) (2020-10-18) Cc: Christopher Dimech , Help Gnu Emacs To: Drew Adams Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Sun Nov 01 21:37:07 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 1kZK66-0004df-49 for geh-help-gnu-emacs@m.gmane-mx.org; Sun, 01 Nov 2020 21:37:06 +0100 Original-Received: from localhost ([::1]:51804 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kZK65-0003aJ-7M for geh-help-gnu-emacs@m.gmane-mx.org; Sun, 01 Nov 2020 15:37:05 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:56136) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZK5V-0003a1-Tz for help-gnu-emacs@gnu.org; Sun, 01 Nov 2020 15:36:29 -0500 Original-Received: from static.rcdrun.com ([95.85.24.50]:55059) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZK5T-0002YF-W5 for help-gnu-emacs@gnu.org; Sun, 01 Nov 2020 15:36:29 -0500 Original-Received: from localhost ([::ffff:197.157.0.60]) (AUTH: PLAIN admin, TLS: TLS1.2,256bits,ECDHE_RSA_AES_256_GCM_SHA384) by static.rcdrun.com with ESMTPSA id 00000000002A0B40.000000005F9F1C3F.00001F44; Sun, 01 Nov 2020 20:36:14 +0000 Content-Disposition: inline In-Reply-To: <5ce46139-e884-45f9-9332-772ec50e6340@default> Received-SPF: pass client-ip=95.85.24.50; envelope-from=bugs@gnu.support; helo=static.rcdrun.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/01 10:30:20 X-ACL-Warn: Detected OS = Linux 3.11 and newer [fuzzy] X-Spam_score_int: -3 X-Spam_score: -0.4 X-Spam_bar: / X-Spam_report: (-0.4 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_SORBS_WEB=1.5, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no 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:124909 Archived-At: * Drew Adams [2020-11-01 22:01]: > > > (bounds-of-thing-at-point 'paragraph) works fine. > > > > It works fine, but documentation does not describe it: > > > > bounds-of-thing-at-point is an autoloaded compiled Lisp function in > > ‘thingatpt.el’. > > > > (bounds-of-thing-at-point THING) > > > > Determine the start and end buffer locations for the THING at point. > > THING should be a symbol specifying a type of syntactic entity. > > Possibilities include ‘symbol’, ‘list’, ‘sexp’, ‘defun’, > > ‘filename’, ‘url’, ‘email’, ‘uuid’, ‘word’, ‘sentence’, ‘whitespace’, > > ‘line’, and ‘page’. > > > > See the file ‘thingatpt.el’ for documentation on how to define a > > valid THING. > > > > Return a cons cell (START . END) giving the start and end > > positions of the thing found. > > Just read it more carefully. > > 1. "Possibilities include" > ^^^^^^^ > > It doesn't say that those are the only possibilities. Maybe if I say Sesame open the door... :-) I went into thingatpt.el and I tried searching for "paragraph" and I cannot find it. This opens plethora of possibilities to jump into maybe other files and find "paragraph" defined. > > Return the THING at point. > > THING should be a symbol specifying a type of syntactic entity. > > Possibilities include ‘symbol’, ‘list’, ‘sexp’, ‘defun’, > > ‘filename’, ‘url’, ‘email’, ‘uuid’, ‘word’, ‘sentence’, ‘whitespace’, > > ‘line’, ‘number’, and ‘page’. > > See above. The word "include" doesn't mean the > same thing as "include only" or "comprise". The > list of THINGS mentioned isn't exhaustive. > > The English language includes the words "thing" > and "point" (but it also includes a lot more words). Alright, sure. But that does not make it friendly to user to understand that paragraph is included. Do you have a word "paragraph" in your thingatpt.el? -- There are 57 messages yet in my incoming mailbox.