From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= Newsgroups: gmane.emacs.bugs Subject: bug#39778: [PATCH] checkdoc: Don't mistake "cf." for sentence end Date: Tue, 25 Feb 2020 17:02:12 +0100 Message-ID: <8736ayac57.fsf@gmail.com> References: <877e0aambr.fsf@gmail.com> <0aabe857-71d1-4509-9794-f53697f824c9@default> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="62467"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Notmuch/0.29.3 (https://notmuchmail.org) Emacs/28.0.50 (x86_64-pc-linux-gnu) To: Drew Adams , 39778@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Feb 25 17:03:14 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 1j6cfy-000G8K-1r for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 25 Feb 2020 17:03:14 +0100 Original-Received: from localhost ([::1]:59598 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j6cfw-0006Fa-3S for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 25 Feb 2020 11:03:13 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37431) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j6cfn-0006Dd-4A for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 11:03:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j6cfm-0003Es-5l for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 11:03:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:50046) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1j6cfm-0003EY-2N for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 11:03:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1j6cfl-0005Ps-VT for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 11:03:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 25 Feb 2020 16:03: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.158264653420763 (code B ref 39778); Tue, 25 Feb 2020 16:03:01 +0000 Original-Received: (at 39778) by debbugs.gnu.org; 25 Feb 2020 16:02:14 +0000 Original-Received: from localhost ([127.0.0.1]:56019 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j6cf0-0005Op-Bs for submit@debbugs.gnu.org; Tue, 25 Feb 2020 11:02:14 -0500 Original-Received: from mail-lj1-f180.google.com ([209.85.208.180]:37748) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j6cex-0005OZ-VD for 39778@debbugs.gnu.org; Tue, 25 Feb 2020 11:02:12 -0500 Original-Received: by mail-lj1-f180.google.com with SMTP id q23so14656243ljm.4 for <39778@debbugs.gnu.org>; Tue, 25 Feb 2020 08:02:11 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:in-reply-to:references:user-agent:date:message-id :mime-version:content-transfer-encoding; bh=Q5xeok5QPxU6qfQVaWpW4c3H78CxWRI0s2Ds/zXLifQ=; b=cD263MEn9TTEJIYN4F1G4C+wkIkTuQdUW2DvwbwSpL/wqgaqXp5wPLhYnQGwjyRBys vLX0PmecWjAh4S6pGmclr492ahx8G1FSzyHsQn58LF2MNWbX1aDF6/Kpj5/pkOtPlle+ 14mUrodecjJaPCThl2nPRgXdEy+OIC3RIjIl9HaMmUGxTKNV7tpJFKvy6fARX6UnQdJy iIh8YIwSNQBQYrjERv97K/S1x908bX5stDevdT+Vb8XsOnXKFkMm78hwTbawMALvXLiK 2PhmA+n7gcL5REoC4j/9xBolp/2NParfuVGy7QiBd4J13FFpGVAKbNT0CwMEdSxtDO0S 0IgA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:in-reply-to:references :user-agent:date:message-id:mime-version:content-transfer-encoding; bh=Q5xeok5QPxU6qfQVaWpW4c3H78CxWRI0s2Ds/zXLifQ=; b=isCZKR312ta3kB1X4SNCXrM4zwWfiI66KntmgwLHBJciBrgt5QOLu8q6I/UdhlLSn3 oQBCVWYl0Omnnwb3pE8cSthFUn2/TFMENXWRgPsN5eJy17dq56jw4XBl4N8XuF5DluKh HWwLAn/k5+xh2AztVea636PU6qnZ2UkuLaY662/CJwJl2LZKxApd5NchoTW3yj9If20y YpNDIEf6jWHbpIFjy1M9Pv0iLqCE78agttyPDqtBr6sQKjucjd0TldR1TwJ5FBi8vImg 0Hdvs0/LJJbhRxPDcYqEMU39zm5jQxTSZtAVppFnb2RnpQR7VdA+6synZe05Fpd7V6DP 3T4w== X-Gm-Message-State: APjAAAUPl7Q+Ns8Ega8Y1zK9DYPFYDisR/x6cd77lMFj76AXfsFbQMem 05CaiIEWysXqKylTk4lYtQk= X-Google-Smtp-Source: APXvYqy0luLThHxK7w7ixOFS0soTXrQq8mx3eW63/5T4wuMd0MW4iTj/pFl53Ewj8fL73krlDwvq1A== X-Received: by 2002:a2e:a37c:: with SMTP id i28mr33268379ljn.118.1582646525876; Tue, 25 Feb 2020 08:02:05 -0800 (PST) Original-Received: from localhost ([185.112.167.59]) by smtp.gmail.com with ESMTPSA id i4sm8081666ljg.102.2020.02.25.08.02.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 25 Feb 2020 08:02:05 -0800 (PST) In-Reply-To: <0aabe857-71d1-4509-9794-f53697f824c9@default> 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:176469 Archived-At: On Tue, 25 Feb 2020 07:49:49 -0800 Drew Adams wrote: >> "Cf." is a common abbreviation in documentation. >>=20 >> Currently checkdoc warns about lack of double space after "cf." or >> "Cf.". The attached patch adds an exception similar to the already >> handled "eg." and and "ie.". > > Yes. > > But even better is to remove uses of "Cf." (which > is not so common nowadays, and is understood by > fewer and fewer readers). It can typically be > replaced by something as simple as "Compare" or > sometimes even just "See also". Do you have any hard data for your claims? Couldn't the same be argued about "e.g." vs "for example" or "i.e." vs "that is"? Is "cf." really so much less common? Anyway, it is probably largely subjective, but unless you can bring up many examples of potential further requests (I can't think of anything else myself), just adding "cf." shouldn't hurt, should it? --=20 =C5=A0t=C4=9Bp=C3=A1n