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: RE: bounds-of-thing-at-point for paragraphs Date: Sun, 1 Nov 2020 23:36:25 +0100 Message-ID: References: <568cb7cf-928b-4c5a-af3f-fd0d3d13f55a@default> <5ce46139-e884-45f9-9332-772ec50e6340@default> <5b3e2e05-8e94-42c5-9669-ba519d86a469@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="28456"; 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 23:38:59 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 1kZM02-0007GZ-TW for geh-help-gnu-emacs@m.gmane-mx.org; Sun, 01 Nov 2020 23:38:58 +0100 Original-Received: from localhost ([::1]:58498 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kZM01-0004SH-M7 for geh-help-gnu-emacs@m.gmane-mx.org; Sun, 01 Nov 2020 17:38:57 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50362) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZLyB-0004Rw-Rf for help-gnu-emacs@gnu.org; Sun, 01 Nov 2020 17:37:03 -0500 Original-Received: from mout.gmx.net ([212.227.15.15]:47273) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZLy9-0008To-Fl for help-gnu-emacs@gnu.org; Sun, 01 Nov 2020 17:37:03 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1604270185; bh=ioz/yHCOqVOzMOc7d7xqIOVlvZXngNcOgyPumhvPQ+I=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=Jd8OI0iof8USVy8RJcBw5TSU5wsCJP1z3XPovMVMhM4/fDlcW4OhRT41gmGfQ1ewY Jv7SF7/RCRmIvm0k18AKlFmSBPuiK5B4Epqt2Mj5KCEhhhSq3i6Uw9k1z+w1wRjp6n 1rkkFjomu51W0KcTwhlJis1ojxpAqnT5FrCwf8J0= 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 23:36:25 +0100 Importance: normal Sensitivity: Normal In-Reply-To: <5b3e2e05-8e94-42c5-9669-ba519d86a469@default> X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:s8nM8kWrUHRJb3LlS8i4bMu1c5TP/KehD41Y99nk47x2kpnN39En2znt0gF9Ionu75anu sAVTKIPsOHu6SiH0+Ef57MepSR/ozJePtHGZVh4e64dEy9AnfgA25H8rFaHBu+PsuhO3neeyYMmg G5YunWRI5ZtjnTbfd95KXPMMtLckNJijwU2Uk0GarWlDx71ymprm94M0+R3lkczenLNe3+2d+OeP dgzGA5jzl+CNR4bkzZOHFmpZb2LYFRVNTCVEIb5V6xYSngnyl3QJ2DH8PfL7j3iTzm6The+eDnQr uo= X-UI-Out-Filterresults: notjunk:1;V03:K0:8cowbhZyGKs=:q2NCrkwkou64AwbpGZJoJH MvCWsHtBkmh4c06WULFxKZWmBu76tMx3xm1023QswltAeEY7UaWdX4eZmbHVuzbGOqY6omJgV MdIxjaeQhHJbtMlj1lACD/q+7E2Y2PHPQCPpI9Gr4gocvqTRaRkzvk7SmIm7gvjJwhuzDTbp7 TfGpvs8nDrG3pZW3BF4UVnp/uMZXJNAEAusdfOuawpJodP4AUV/ZT/CJn61JDode9lu57V67a tLQMniWnzCOT3nJyfMjlR4DB0eVi5Cs3s8cZcdPenYGHVe0RUbkuyIleuwBbWHWB8+ksMgMm3 s7Ihr47EfrZH0b84J7zrNYS9AfEL6uZ1jZcY7sOsKORvA12H/6WU66OXmLzzCV3IiSpPQGCKC BhuaHw59Gt3CagAZIWT0QDnqLRxh3Y4ySiKJL/1Ncu3wgv0kAYUqnKFE2KFDo+r/2FtO2on7d 3LEE7rxUhASysvw2qx9nInTSEieGGeCV/7BMJYodzh//bzrTxPlmdy5M7aDG3GOSBGeEYl9ZN wS/TCLgJG6v+Ca8mkbxu0FW8b13ZZdi9f2qO3fJoGfNc+9iThiYR2BM6YcVGQ7ijV2acWncOk x2Pk6JBvzHFFY= Received-SPF: pass client-ip=212.227.15.15; envelope-from=dimech@gmx.com; helo=mout.gmx.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/01 17:36:59 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:124928 Archived-At: When I tried I got "Can't find library thingatapt" M-x finder-commentary thingatpt > Sent: Sunday, November 01, 2020 at 11:06 PM > From: "Drew Adams" > To: "Christopher Dimech" > Cc: "Help Gnu Emacs" , "Jean Louis" > Subject: RE: RE: bounds-of-thing-at-point for paragraphs > > > Looking at thingatpt.el is not helpful. > > It's very helpful. It directly answers your question. > > Or perhaps you meant that needing to look at that file > is a burden. That's different from saying that if you > do look in the file you find no help. > > > If you know important things that are useful to know > > about it, place it at the top of the file. > > Define "top" of the file. Elisp files have certain > things, conventionally, at the very top. > > One of the things they can have near the top, i.e., > in the file header, is a Commentary section, which is > documentation. > > And lo and behold, what do we find there, in lines > 4-7 of the Commentary? > > The function bounds-of-thing-at-point finds the beginning and end > positions by moving first forward to the end of the "thing", and then > backwards to the beginning. By default, it uses the corresponding > forward-"thing" operator (eg. forward-word, forward-line). > > That directly answers your question, no? > > What happens when you do `C-h f forward- TAB'? Do you > see `forward-paragraph' listed? QED. > > > I customarily define a documentation function for the file so that it > > would be available interactively, even if mostly of interest to Elisp > > Designers. > > You want interactive access to just the Commentary? > Your wish is granted: > > M-x finder-commentary thingatpt > > That's how I got the text to include in my answer to > you, without having to remove comment chars (`;'). > > (And yes, you can use `TAB' with `finder-commentary' > to see all of the currently available libraries as > candidates.) > >