GNU bug report logs - #61736
Fix typos in docstrings in c-ts-common.el

Previous Next

Package: emacs;

Reported by: Daniel Martín <mardani29 <at> yahoo.es>

Date: Thu, 23 Feb 2023 17:34:02 UTC

Severity: normal

Tags: patch

Done: Yuan Fu <casouri <at> gmail.com>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Daniel Martín <mardani29 <at> yahoo.es>
Subject: bug#61736: closed (Re: bug#61736: Fix typos in docstrings in
 c-ts-common.el)
Date: Sat, 25 Feb 2023 04:52:02 +0000
[Message part 1 (text/plain, inline)]
Your bug report

#61736: Fix typos in docstrings in c-ts-common.el

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 61736 <at> debbugs.gnu.org.

-- 
61736: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=61736
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
From: Yuan Fu <casouri <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 61736-done <at> debbugs.gnu.org,
 Daniel Martín <mardani29 <at> yahoo.es>
Subject: Re: bug#61736: Fix typos in docstrings in c-ts-common.el
Date: Fri, 24 Feb 2023 20:50:48 -0800
Eli Zaretskii <eliz <at> gnu.org> writes:

>> Date: Thu, 23 Feb 2023 18:32:58 +0100
>> From:  Daniel Martín via "Bug reports for GNU Emacs,
>>  the Swiss army knife of text editors" <bug-gnu-emacs <at> gnu.org>
>> 
>> I've attached a patch to fix a couple of typos in c-ts-common.el.
>
> Thanks.
>
>>  (defun c-ts-common-statement-offset (node parent &rest _)
>> -  "This anchor is used for children of a statement inside a block.
>> +  "Return an offset for children of a statement inside a block.
>
> Is the new text really accurate?  The rest of the doc string doesn'
> mention "offset" even once, and without explaining what kind of
> "offset" is this, the first sentence could mislead and confuse.
>
> So I think this part of the patch "needs more work".
>
> I installed the first part, thanks.

The second part is valid. I applied it with some minor change, thanks!

Yuan

[Message part 3 (message/rfc822, inline)]
From: Daniel Martín <mardani29 <at> yahoo.es>
To: bug-gnu-emacs <at> gnu.org
Subject: Fix typos in docstrings in c-ts-common.el
Date: Thu, 23 Feb 2023 18:32:58 +0100
[Message part 4 (text/plain, inline)]
Tags: patch


I've attached a patch to fix a couple of typos in c-ts-common.el.

[0001-Fix-typos-in-docstrings-in-c-ts-common.el.patch (text/patch, attachment)]

This bug report was last modified 2 years and 91 days ago.

Previous Next


GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.