From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Xiyue Deng Newsgroups: gmane.emacs.bugs Subject: bug#68375: 29.1; lispref documentation fixes Date: Thu, 11 Jan 2024 08:46:57 -0800 Message-ID: <871qan4y2m.fsf@debian-hx90.lan> References: <87wmsgztk8.fsf@debian-hx90.lan> <83wmsgkv05.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="16364"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 68375-done@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jan 11 17:48:24 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 1rNyEB-0003yi-Q8 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 11 Jan 2024 17:48:23 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rNyE1-0000lJ-2M; Thu, 11 Jan 2024 11:48:13 -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 1rNyDt-0000cJ-B5 for bug-gnu-emacs@gnu.org; Thu, 11 Jan 2024 11:48:05 -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 1rNyDs-0004UW-J0 for bug-gnu-emacs@gnu.org; Thu, 11 Jan 2024 11:48:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rNyDq-0006ky-0S for bug-gnu-emacs@gnu.org; Thu, 11 Jan 2024 11:48:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Xiyue Deng Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 11 Jan 2024 16:48:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 68375 X-GNU-PR-Package: emacs Original-Received: via spool by 68375-done@debbugs.gnu.org id=D68375.170499162625747 (code D ref 68375); Thu, 11 Jan 2024 16:48:01 +0000 Original-Received: (at 68375-done) by debbugs.gnu.org; 11 Jan 2024 16:47:06 +0000 Original-Received: from localhost ([127.0.0.1]:33715 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rNyCv-0006hD-Sl for submit@debbugs.gnu.org; Thu, 11 Jan 2024 11:47:06 -0500 Original-Received: from mail-pg1-x535.google.com ([2607:f8b0:4864:20::535]:42438) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rNyCt-0006ga-1A for 68375-done@debbugs.gnu.org; Thu, 11 Jan 2024 11:47:05 -0500 Original-Received: by mail-pg1-x535.google.com with SMTP id 41be03b00d2f7-5ce10b5ee01so3887169a12.1 for <68375-done@debbugs.gnu.org>; Thu, 11 Jan 2024 08:47:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1704991619; x=1705596419; darn=debbugs.gnu.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=PGgQY1cJLwZrzmkUtsfcOFPXJeZWfARGS1CD5jq9cb0=; b=TIA6xF4SN2bhpyl8J6LNkP1lllRGkY1wyPKWWAMpsoAylpMVGWOWEJBumCXtOWU6Ck Wu9eWO4ymVWIso786BFp53iVYagnPCSqnuuZGnEr355/OvCgcwur6/meWEhJirklt5be KzIO/95M/4Wj0xXgCqzfQcdlTc5+1j7e/3oYKPmkSf4gmFDXSbQB+3T7153EzQJRFng1 9Ic9MuLHriPJJ6+f1gYECsTurWG+kVOWCQ77nO6rACkVA6YAtwgmgwrZ06L+fU1RUu0X ZKAyJAi51uOZbQN7G3rrFvTg/xswGWPl4lJJtXy5L8gCoUsRKi2WaVNarT/nJnUI1aXv t7qg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1704991619; x=1705596419; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=PGgQY1cJLwZrzmkUtsfcOFPXJeZWfARGS1CD5jq9cb0=; b=Fi5YtsKfpsF9o8wATEC4a3VyS9w20vCYQPg1OUIA02Oeu7J0cMBPLHCVjgfcgRRBy2 9tDSyO1UYAIca2U16LRX3n/PI1u4zg9MJQ3RGdU8ATQTYEcpz6/gamiwqDqYnvjGKhYL g6NEz3k07eN++Y2Qtsb5l/x2u5XmOqX4QkaY0CooHGpPUqM6WfEDKFc5PNXSLM4yBWi4 SJVm9MrzSrAAizeVNkX6M9L8VzLCYJfn+Eu0dGg+7caCnWlgj8QDGu45XyJoqdSPgMgN GoRXeYYXL46G3ZNuHUmbhVA/VcbrZIM9fdE68xL/9S1/TlBK3YTHPD/lgdUCMK0+b1o0 lo4g== X-Gm-Message-State: AOJu0YyZcx8Cf1rCMgwxJogydII4rHKJfoLylNAr8YWzu7hdJEJPcBOJ 3WvkomPE5ca24pSqYsH74a338K04yDU= X-Google-Smtp-Source: AGHT+IGqRiF0ZxjTBN8ri2BICZdkV0XVJdphGuCLFMZA0kA/t8+DDeUpNufzfGp3lQylrwZ7fvcVmg== X-Received: by 2002:a05:6a20:29a0:b0:199:7522:5973 with SMTP id f32-20020a056a2029a000b0019975225973mr106408pzh.56.1704991619182; Thu, 11 Jan 2024 08:46:59 -0800 (PST) Original-Received: from debian-hx90 (2603-8000-a400-0cdc-7945-1d63-1787-20c0.res6.spectrum.com. [2603:8000:a400:cdc:7945:1d63:1787:20c0]) by smtp.gmail.com with ESMTPSA id t62-20020a625f41000000b006d9a94a03a8sm1431576pfb.77.2024.01.11.08.46.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 11 Jan 2024 08:46:58 -0800 (PST) In-Reply-To: <83wmsgkv05.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 11 Jan 2024 12:46:34 +0200") 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:277919 Archived-At: Eli Zaretskii writes: >> 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. > Indeed. Please excuse my poor English. >> 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. Thanks Stephen for the help, too! > >> 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. Another example that late reading is not a good idea. Sorry for the noise. > > 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. I'm already in the process and finished document. I'm currently still waiting for reply on how to handle employer exemption. Hopefully I'll hear back from assign@gnu.org soon. > > Thanks, I will now close this bug. -- Xiyue Deng