From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.help Subject: RE: RE: bounds-of-thing-at-point for paragraphs Date: Sun, 1 Nov 2020 14:06:16 -0800 (PST) Message-ID: <5b3e2e05-8e94-42c5-9669-ba519d86a469@default> 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="10665"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Help Gnu Emacs , Jean Louis To: Christopher Dimech Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Sun Nov 01 23:06:46 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 1kZLUr-0002hs-HY for geh-help-gnu-emacs@m.gmane-mx.org; Sun, 01 Nov 2020 23:06:45 +0100 Original-Received: from localhost ([::1]:40796 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kZLUq-0003Lf-Jf for geh-help-gnu-emacs@m.gmane-mx.org; Sun, 01 Nov 2020 17:06:44 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46092) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZLUX-0003LU-Ec for help-gnu-emacs@gnu.org; Sun, 01 Nov 2020 17:06:25 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:42910) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kZLUV-00052x-EY for help-gnu-emacs@gnu.org; Sun, 01 Nov 2020 17:06:24 -0500 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 0A1M3Ut6073769; Sun, 1 Nov 2020 22:06:19 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=201USLEAZZ9qYiKwIRxst7eYbMjeDx+ZQSGwP1SldV8=; b=ofJNMl38RazvvbaEiz5BGat/rIS+sYnBV2kWQcSZG4KMCE72pHRgpMnqotfmJfRM0QJ8 aaIDxwtNYrSZBpQsy0ypvn2wOsrgDOBe5pL/MWBQRmRLwh8M3KKSnnfWXYnJuq/2Ru8V TfXXS1lrjdFiB6wHq/JzPYlxvrEGu7DrJwIawtFKtX/lvsOjUJhsYb2jFG+iZ9/ynuiJ uApeDqPAcMc6WpjS5+9y8UhzNDlX1qgeUQfleATu3iiKF5kSdEw4A7+9d3dRmoN0J6z+ X0y0QukDdDfD4rKd61mVw4N8SPXPPJ8/xDOJ/OC2x5Y2GysfUdG6VK6vXQ5zz0z6i07c ig== Original-Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by aserp2120.oracle.com with ESMTP id 34hhvc1geb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Sun, 01 Nov 2020 22:06:19 +0000 Original-Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 0A1Lxa65075505; Sun, 1 Nov 2020 22:06:18 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userp3030.oracle.com with ESMTP id 34hvrt1jk9-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 01 Nov 2020 22:06:18 +0000 Original-Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 0A1M6HHx022286; Sun, 1 Nov 2020 22:06:17 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5056.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9792 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 adultscore=0 mlxscore=0 malwarescore=0 mlxlogscore=999 suspectscore=0 spamscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2011010180 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9792 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 suspectscore=0 impostorscore=0 malwarescore=0 priorityscore=1501 mlxlogscore=999 bulkscore=0 phishscore=0 adultscore=0 mlxscore=0 lowpriorityscore=0 clxscore=1015 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2011010180 Received-SPF: pass client-ip=141.146.126.78; envelope-from=drew.adams@oracle.com; helo=aserp2120.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/01 17:06:21 X-ACL-Warn: Detected OS = Linux 3.1-3.10 [fuzzy] X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-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:124923 Archived-At: > 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? =20 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.)