From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Visuwesh Newsgroups: gmane.emacs.bugs Subject: bug#56809: file-name-with-extension: Improve docstring. Date: Thu, 28 Jul 2022 16:04:21 +0530 Message-ID: <87o7x9wmoi.fsf@gmail.com> References: <87edy5929v.fsf@cassou.me> <83ilnhad8j.fsf@gnu.org> <87bkt98wju.fsf@cassou.me> 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="32177"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: Eli Zaretskii , 56809@debbugs.gnu.org To: Damien Cassou Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jul 28 12:35:41 2022 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 1oH0rl-0008CW-L3 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 28 Jul 2022 12:35:41 +0200 Original-Received: from localhost ([::1]:47658 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oH0rj-0001KI-WB for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 28 Jul 2022 06:35:40 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50348) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oH0r8-0001JG-4l for bug-gnu-emacs@gnu.org; Thu, 28 Jul 2022 06:35:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:39728) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oH0r7-0005oE-Qu for bug-gnu-emacs@gnu.org; Thu, 28 Jul 2022 06:35:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oH0r7-0000T8-Kf for bug-gnu-emacs@gnu.org; Thu, 28 Jul 2022 06:35:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Visuwesh Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 28 Jul 2022 10:35:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 56809 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 56809-submit@debbugs.gnu.org id=B56809.16590044871774 (code B ref 56809); Thu, 28 Jul 2022 10:35:01 +0000 Original-Received: (at 56809) by debbugs.gnu.org; 28 Jul 2022 10:34:47 +0000 Original-Received: from localhost ([127.0.0.1]:57709 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oH0qt-0000SY-CZ for submit@debbugs.gnu.org; Thu, 28 Jul 2022 06:34:47 -0400 Original-Received: from mail-pg1-f194.google.com ([209.85.215.194]:45637) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oH0qq-0000SH-SE for 56809@debbugs.gnu.org; Thu, 28 Jul 2022 06:34:46 -0400 Original-Received: by mail-pg1-f194.google.com with SMTP id f65so1196077pgc.12 for <56809@debbugs.gnu.org>; Thu, 28 Jul 2022 03:34:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:in-reply-to:references:date:message-id :user-agent:mime-version:content-transfer-encoding; bh=Y9g9iRhR0y8TJ/2jj4bY1tO3ybO0Pi7Haga2FpgwIm4=; b=BxCVxWEhlHYGZMjH8U4EEAh+hm6WTCqQzjufrGYrBmW11AvvzjRqCrclf2+xjvi+vt FGu1LLsS4RODLQH2FkoJ6B1t77XF/c1Bdn7i4heYZxWIaYja4uLBTsxm3NspBRQT8pbk dzkN/JMHoSbId7sIrXM5zBt4873NakA8zptwJ30XS3Rc2FTymA9qYprDfSUOQWUrnkSn StvuiFC7jutXqES0+hnom1lEzMsDbsxdQDQbwhhHZFHHDwnnVXp/1l/LUS51nxvJ7mqQ yn53hcEQfdb6L4QwoJe1XSBZBJpltDrlt2s63qRJhaIektt77ZGE4pb/TkicZ9ZTLsbI zn9g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:user-agent:mime-version:content-transfer-encoding; bh=Y9g9iRhR0y8TJ/2jj4bY1tO3ybO0Pi7Haga2FpgwIm4=; b=jt8sLUhiZWBFfUSLS08PkHBp1GvJzLZEeOJ9zRTiXqF+gwI81FjCQMMwFfZC5KVle9 3CB3HesdnWNoVjrbbrQaQnw1aPvSmSw1B8T4SgVVbqIssLoEbIJ0jwYP5yhUQ2D8NKkQ bfSoHnNKWgfHZqdpvSfwIj7NRRu39slten8JKJ/UYYmea4vPwuqP36b475DoAnwtzUrK AR1+S+PVhy7V1JIlTK01zzDwXKF3HRgMI6dSRFlOILRquihQ0G5H/+TOkfJw7tS4Ddly mpCARLeKbAzwXEE11VfJZ1Q60yD3uDFYw3s2BjB3HmAl8ndie86Bq2BDO7E13kKCHLaN lt9w== X-Gm-Message-State: AJIora/TgYFUHVVq+DLtLeL2+GYJ9Onsbj3QUOvXFxhMBh3K5iGOl/Vd qntRsOdYTAdA1J02tARwu78= X-Google-Smtp-Source: AGRyM1uTHx14t5EDzYTKAS584vHMv0IOwfAzpkxPwWlI+oCEdRyQz0/lG4pJ9rYH4N+Uq1zkhe9YhQ== X-Received: by 2002:aa7:9519:0:b0:528:c2e0:b7ae with SMTP id b25-20020aa79519000000b00528c2e0b7aemr26321648pfp.39.1659004478897; Thu, 28 Jul 2022 03:34:38 -0700 (PDT) Original-Received: from localhost ([49.204.141.236]) by smtp.gmail.com with ESMTPSA id g2-20020a170902d1c200b0016dc6279ab8sm845836plb.159.2022.07.28.03.34.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 28 Jul 2022 03:34:37 -0700 (PDT) In-Reply-To: <87bkt98wju.fsf@cassou.me> (Damien Cassou's message of "Thu, 28 Jul 2022 10:35:01 +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" Xref: news.gmane.io gmane.emacs.bugs:238099 Archived-At: [=E0=AE=B5=E0=AE=BF=E0=AE=AF=E0=AE=BE=E0=AE=B4=E0=AE=A9=E0=AF=8D =E0=AE=9C= =E0=AF=82=E0=AE=B2=E0=AF=88 28, 2022] Damien Cassou wrote: >> "Return FILENAME modified to=E2=80=A6 > > Most readers will know that FILENAME is not going to be modified but the > phrasing is still confusing in my opinion. I would prefer a version > around the word "concatenate" or similar. Here is another version: > > Concatenate FILENAME without its extension and EXTENSION. I find this confusing. Eli's version looks better (the other one which mentions basename is no good either).