From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#68375: 29.1; lispref documentation fixes Date: Thu, 11 Jan 2024 12:46:34 +0200 Message-ID: <83wmsgkv05.fsf@gnu.org> References: <87wmsgztk8.fsf@debian-hx90.lan> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="20333"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 68375-done@debbugs.gnu.org To: Xiyue Deng Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jan 11 11:47:25 2024 Return-path: Envelope-to: geb-bug-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 1rNsar-00055y-3B for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 11 Jan 2024 11:47:25 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rNsab-0004z2-VP; Thu, 11 Jan 2024 05:47:09 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rNsaY-0004yb-F0 for bug-gnu-emacs@gnu.org; Thu, 11 Jan 2024 05:47:06 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rNsaX-0003dm-Hx for bug-gnu-emacs@gnu.org; Thu, 11 Jan 2024 05:47:06 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rNsaU-0007XG-J3 for bug-gnu-emacs@gnu.org; Thu, 11 Jan 2024 05:47:02 -0500 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Thu, 11 Jan 2024 10:47:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 68375 X-GNU-PR-Package: emacs Mail-Followup-To: 68375@debbugs.gnu.org, eliz@gnu.org, manphiz@gmail.com Original-Received: via spool by 68375-done@debbugs.gnu.org id=D68375.170497001628944 (code D ref 68375); Thu, 11 Jan 2024 10:47:02 +0000 Original-Received: (at 68375-done) by debbugs.gnu.org; 11 Jan 2024 10:46:56 +0000 Original-Received: from localhost ([127.0.0.1]:58807 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rNsaN-0007Wl-FC for submit@debbugs.gnu.org; Thu, 11 Jan 2024 05:46:55 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50696) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rNsaM-0007WW-9k for 68375-done@debbugs.gnu.org; Thu, 11 Jan 2024 05:46:54 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rNsaJ-0003SL-9K; Thu, 11 Jan 2024 05:46:51 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=7Juold9UURxbcEUVF+q+ERlAfMYKHS4HoNZLNi3AOiU=; b=Df2HN7dqvR0m OXyXq3czmjKqBsC10D+bDYStV8tzv7DiNEFDTyPy1UDrhCpmKjzJIAjVZMl6R0vZRuYJpp5mbhpl/ 7k0+F1Q9OkJTbB3ENVa2MfwJviJNG7T/iCCctv1uxTm8zbzuGT4PNl7sxG4cvYptHX1V/HvZ4S18M VAqR0oWCDfBPxqqnhFQTDoEslGQRjB750oM5aO7gfGau+WT2m0+AZzuwvJEshz/4hwHXUOoKHRASb RhuO+ZRxGnGbZ2bHBhq1RJWrGkdAD7sJ2iuDg7XPOEqRIarpj09hZULnJmvHnqsnTIyE41aDhTrqE SagoZHvjFu4hJF7Vcy9baQ==; In-Reply-To: <87wmsgztk8.fsf@debian-hx90.lan> (message from Xiyue Deng on Wed, 10 Jan 2024 14:56:23 -0800) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:277883 Archived-At: > From: Xiyue Deng > Date: Wed, 10 Jan 2024 14:56:23 -0800 > > Please find the attached patches for a cumulation of documentation fixes > for lispref up to chapter 19 that includes typos, formatting, etc. > Please let me know if any changes need improvements and I'll adjust > accordingly. Thanks. See below. > --- a/doc/lispref/objects.texi > +++ b/doc/lispref/objects.texi > @@ -1573,7 +1573,7 @@ editing. > (@pxref{Files}) so they can be edited, but some are used for other > purposes. Most buffers are also meant to be seen by the user, and > therefore displayed, at some time, in a window (@pxref{Windows}). But > -a buffer need not be displayed in any window. Each buffer has a > +a buffer needs not be displayed in any window. Each buffer has a This is not a typo: the wording here is correct English. So I didn't install this part. > A string is a fixed sequence of characters. It is a type of > -sequence called a @dfn{array}, meaning that its length is fixed and > +sequence called an @dfn{array}, meaning that its length is fixed and The "an" here is correct, since in a manual one sees "an array", which is correct English. So I didn't install this part. > For information about other concatenation functions, see the > -description of @code{mapconcat} in @ref{Mapping Functions}, > +descriptions of @code{mapconcat} in @ref{Mapping Functions}, There's nothing wrong with using singular here, so I didn't install this part. > * doc/lispref/symbols.texi (Shorthands): Wrap `@pxref{Abbrevs}' in > parentheses. I installed this part. > >From 454ed28e302493d678d2306b908c9542a8491daa Mon Sep 17 00:00:00 2001 > From: Xiyue Deng > Date: Tue, 2 Jan 2024 16:31:30 -0800 > Subject: [PATCH 5/6] Fix count of no-op functions > > It looks like there are actually three kinds of no-op functions. > > * doc/lispref/functions.texi (Calling Functions): Fix count and > plural of no-op functions. I installed this part as well. > * doc/lispref/debugging.texi (Syntax Errors): Fix unmatched > parentheses. I didn't install this part, because there's nothing wrong with parentheses here. Using @pxref as below: > If the problem is not simply an imbalance of parentheses, a useful > -technique is to try @kbd{C-M-e} (@code{end-of-defun}, @pxref{Moving by > +technique is to try @kbd{C-M-e} (@code{end-of-defun}), @pxref{Moving by > Defuns,,,emacs, The GNU Emacs Manual}) at the beginning of each defun, is perfectly correct. So I didn't install this part. Please note that with this contribution we've exhausted the amount of changes we can accept from you without a copyright assignment. Would you like to start the legal paperwork of assigning to the FSF the copyright for your future contributions? If so, I will send you the form to fill and the instructions to email the filled form. Thanks, I will now close this bug.