From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#39778: [PATCH] checkdoc: Don't mistake "cf." for sentence end Date: Tue, 25 Feb 2020 13:41:31 -0800 (PST) Message-ID: References: <877e0aambr.fsf@gmail.com> <0aabe857-71d1-4509-9794-f53697f824c9@default> <8736ayac57.fsf@gmail.com> <7982367d-3711-4dd3-ac78-097bfe966235@default> <87imjumxff.fsf@gnu.org> <878skqz8k2.fsf@stefankangas.se> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-2 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="111224"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 39778@debbugs.gnu.org, =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= To: Stefan Kangas , Bastien Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Feb 25 22:42:13 2020 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 1j6hy0-000Spe-UG for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 25 Feb 2020 22:42:13 +0100 Original-Received: from localhost ([::1]:35324 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j6hxz-0006J9-WC for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 25 Feb 2020 16:42:12 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40444) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j6hxr-0006J2-9s for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 16:42:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j6hxq-0000ND-8C for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 16:42:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:50254) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1j6hxq-0000Mh-48 for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 16:42:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1j6hxp-0007fz-Vi for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 16:42:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 25 Feb 2020 21:42:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 39778 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 39778-submit@debbugs.gnu.org id=B39778.158266690529479 (code B ref 39778); Tue, 25 Feb 2020 21:42:01 +0000 Original-Received: (at 39778) by debbugs.gnu.org; 25 Feb 2020 21:41:45 +0000 Original-Received: from localhost ([127.0.0.1]:56227 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j6hxY-0007fN-Ta for submit@debbugs.gnu.org; Tue, 25 Feb 2020 16:41:45 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:54952) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j6hxV-0007fA-Fo for 39778@debbugs.gnu.org; Tue, 25 Feb 2020 16:41:42 -0500 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 01PLXdsO155779; Tue, 25 Feb 2020 21:41:34 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=Fu1kMF1KdpWyjtIhFTA/6XSlS1KMXRGdHhZkEIwnhyM=; b=Yl9Rkm8/DCoBsMfgv+/5DH0i9kCb9whosQynlbm6N9IV8wya9KfZQFNxFdSQ4tFFMkfd 0zRA2CROju9QDksNBEX8+aop+rOzQGq+LpGMt0fOg1eIpBVMeGbHywlmEJuX+NU6s4Fb txLW9LLWtejuEJd9Cij+jkkEV037ppbusrKxd3WPQaWQ0OHegD6Ur5gl8zje4Yodq4nv sSvmIwdJkST3x5o77ukc840v6lMg9wJQpKlWhQFY9+ZA8819txz5Ch2whyUs1nbkw2cc fdICYD+umWOEDI6+SlphNEvSvkaYz4wMSHsc5mmzvCal3j+ykd5kSB34rSrA88q13GjE 5Q== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 2yd093mdm0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 25 Feb 2020 21:41:34 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 01PLW07d008289; Tue, 25 Feb 2020 21:41:33 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userp3020.oracle.com with ESMTP id 2yd17qwmdf-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 25 Feb 2020 21:41:33 +0000 Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 01PLfWCW023595; Tue, 25 Feb 2020 21:41:32 GMT In-Reply-To: <878skqz8k2.fsf@stefankangas.se> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4966.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9542 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 bulkscore=0 mlxlogscore=619 malwarescore=0 adultscore=0 phishscore=0 suspectscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2001150001 definitions=main-2002250151 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9542 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 lowpriorityscore=0 malwarescore=0 impostorscore=0 suspectscore=0 priorityscore=1501 phishscore=0 clxscore=1015 mlxlogscore=664 spamscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2001150001 definitions=main-2002250151 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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:176484 Archived-At: > >>> Is "cf." really so much less common? > >> I think it is, but I won't try to support that as a fact. >=20 > While looking into this, I found Writing for Computer Science by > (2004) by Justin Zobel. >=20 > "It is often tempting to use abbreviations such as 'no.', 'i.e.', > 'e.g.' 'c.f.' and 'w.r.t.' These save little space on the page, > but slow readers down. It is almost always desirable to expand > these abbreviations, to 'number', 'that is', 'for example', > 'compared with' (or more accurately 'in contrast to', since that > is the sense in which 'c.f.' should be used), and 'with respect > to', or synonyms of these expressions. Where such abbreviations > are used, the punctuation should be as if the expanded form were > used. Also consider expanding abbreviations such as 'Fig.' and > 'Alg.' and don't use concoctions such as '1st' or '2nd'. Months > should not be abbreviated. Make sure that all abbreviations and > acronyms are explained when they are first used." (page 57) >=20 > I think the above points should be carefully considered. I agree. Nothing is really gained, and something is lost, for many readers. > > FWIW I think "cf." is pretty common. It also has the advantage > > of being understood by non-english speaker. >=20 > That's not the case when it comes to speakers of Swedish. I don't > know this for a fact, but I'd assume that this abbreviation is more > common in the Romance languages. Yes, especially for non-English readers, in general. Many programmers whose main language is not English will understand "see also" or "compare". But how many will need to look up "cf."? (But again, reasons to avoid using "cf." are not reasons not to fix the 2-space bug. That should be done, regardless of whether we replace uses of "cf.")