From unknown Thu Aug 14 21:52:20 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#12416 <12416@debbugs.gnu.org> To: bug#12416 <12416@debbugs.gnu.org> Subject: Status: 24.2; doc string of `line-beginning-position' Reply-To: bug#12416 <12416@debbugs.gnu.org> Date: Fri, 15 Aug 2025 04:52:20 +0000 retitle 12416 24.2; doc string of `line-beginning-position' reassign 12416 emacs submitter 12416 "Drew Adams" severity 12416 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Tue Sep 11 11:42:39 2012 Received: (at submit) by debbugs.gnu.org; 11 Sep 2012 15:42:39 +0000 Received: from localhost ([127.0.0.1]:54860 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TBSbm-0008Mp-AW for submit@debbugs.gnu.org; Tue, 11 Sep 2012 11:42:38 -0400 Received: from eggs.gnu.org ([208.118.235.92]:39591) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TBSbk-0008Mi-4g for submit@debbugs.gnu.org; Tue, 11 Sep 2012 11:42:37 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TBSb0-00044T-U9 for submit@debbugs.gnu.org; Tue, 11 Sep 2012 11:41:54 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:51065) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TBSb0-00044P-Qw for submit@debbugs.gnu.org; Tue, 11 Sep 2012 11:41:50 -0400 Received: from eggs.gnu.org ([208.118.235.92]:36385) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TBSaz-00067d-A5 for bug-gnu-emacs@gnu.org; Tue, 11 Sep 2012 11:41:50 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TBSat-00042q-EZ for bug-gnu-emacs@gnu.org; Tue, 11 Sep 2012 11:41:49 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:26886) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TBSat-00042j-7j for bug-gnu-emacs@gnu.org; Tue, 11 Sep 2012 11:41:43 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q8BFffaO001575 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 11 Sep 2012 15:41:42 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q8BFffXh024977 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 11 Sep 2012 15:41:41 GMT Received: from abhmt106.oracle.com (abhmt106.oracle.com [141.146.116.58]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q8BFffsA023393 for ; Tue, 11 Sep 2012 10:41:41 -0500 Received: from dradamslap1 (/10.159.175.11) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 11 Sep 2012 08:41:40 -0700 From: "Drew Adams" To: Subject: 24.2; doc string of `line-beginning-position' Date: Tue, 11 Sep 2012 08:41:36 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 Thread-Index: Ac2QM+2qYgiXvPqyQCy52qZB9vMgjg== X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) This makes it sound like a value of 1 is some kind of exception: "With argument N not nil or 1, move forward N - 1 lines first." Actually, 1 is treated like any other number N. The exception is nil. And to document that we should simply say that the default value of N is 1. That takes care of two places where we talk about "if N is nil or 1". IOW, this doc is unnecessarily complicated. And it is misleading to say first that we "move forward" and then state, at the very end, after details about behavior wrt fields, that the function does NOT move point. Just say something like this: Non-nil optional arg N means return the beginning position of the line N lines past the current line (before it if N is negative). The doc is also overly complex in speaking of "the scan", which is undefined and unexplained. And please make clear what the blah-blah about "first character in the logical order..." is all about. If it means anything, then it is worth explaining/describing. So far, it is opaque, or at best, obscure. Likewise, `line-end-position', of course. In GNU Emacs 24.2.1 (i386-mingw-nt5.1.2600) of 2012-08-28 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include' From debbugs-submit-bounces@debbugs.gnu.org Sat Sep 22 11:31:13 2012 Received: (at 12416-done) by debbugs.gnu.org; 22 Sep 2012 15:31:13 +0000 Received: from localhost ([127.0.0.1]:49296 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TFRfk-0006lE-Gj for submit@debbugs.gnu.org; Sat, 22 Sep 2012 11:31:13 -0400 Received: from mail-pb0-f44.google.com ([209.85.160.44]:50003) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TFRfh-0006l6-St for 12416-done@debbugs.gnu.org; Sat, 22 Sep 2012 11:31:10 -0400 Received: by pbbjt11 with SMTP id jt11so7397944pbb.3 for <12416-done@debbugs.gnu.org>; Sat, 22 Sep 2012 08:29:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=ATM0a8pTJl/tb5X3ArN6vALO0cXYgtH+j/A2m3i3a+Q=; b=dx3PcF8Ub/5+RmaO2IV7Juco6TbI12pcIbAVP3Q/ZWrhYayX+m+FTE27FCpYMHWuw7 ZISztVklp4hhT1+dPwq6hsGk3HbpXMN7wbvGOrAsvzRnXrrYlv0yCpA66WLUIvTs+rse 5/rsxbg7bDE0b7jc/zUd+6PNipLoOO6mE7z7PGknIdPPysmooLjhfF/PLfBn5jNZuuVG xNl2reGx0F/TqBUA/aX2vmvhI/ILo1ochPU21x03cWirY0X1u7k27vTMOxjeSDXXH1os v7VkjnQyOc0i/fpMACeKf/bnN+90xxEs43NDnsnMTfm9V/DQwYP7gLkoh3TYRUMmeWiU GFrA== Received: by 10.68.230.232 with SMTP id tb8mr23887653pbc.19.1348327766273; Sat, 22 Sep 2012 08:29:26 -0700 (PDT) Received: from ulysses (cm162.gamma80.maxonline.com.sg. [202.156.80.162]) by mx.google.com with ESMTPS id y11sm6788746pbv.66.2012.09.22.08.29.23 (version=SSLv3 cipher=OTHER); Sat, 22 Sep 2012 08:29:25 -0700 (PDT) From: Chong Yidong To: "Drew Adams" Subject: Re: bug#12416: 24.2; doc string of `line-beginning-position' References: Date: Sat, 22 Sep 2012 23:29:21 +0800 In-Reply-To: (Drew Adams's message of "Tue, 11 Sep 2012 08:41:36 -0700") Message-ID: <87y5k22i0e.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 12416-done Cc: 12416-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) "Drew Adams" writes: > This makes it sound like a value of 1 is some kind of exception: > > "With argument N not nil or 1, move forward N - 1 lines first." > > Actually, 1 is treated like any other number N. > > The exception is nil. And to document that we should simply say that > the default value of N is 1. That takes care of two places where we > talk about "if N is nil or 1". > > IOW, this doc is unnecessarily complicated. Fixed in trunk. From unknown Thu Aug 14 21:52:20 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 21 Oct 2012 11:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator