From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#39778: [PATCH] checkdoc: Don't mistake "cf." for sentence end Date: Tue, 25 Feb 2020 22:00:29 +0100 Message-ID: <878skqz8k2.fsf@stefankangas.se> 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> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="65350"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) Cc: 39778@debbugs.gnu.org, =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= To: Bastien Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Feb 25 22:01:21 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 1j6hKT-000Gso-4V for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 25 Feb 2020 22:01:21 +0100 Original-Received: from localhost ([::1]:35060 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j6hKS-0004xz-2b for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 25 Feb 2020 16:01:20 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37036) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j6hKD-0004vs-3L for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 16:01:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j6hKA-0002WM-KB for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 16:01:04 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:50217) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1j6hKA-0002V0-CS for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 16:01:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1j6hKA-0006XE-AM for bug-gnu-emacs@gnu.org; Tue, 25 Feb 2020 16:01:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 25 Feb 2020 21:01:02 +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.158266444625092 (code B ref 39778); Tue, 25 Feb 2020 21:01:02 +0000 Original-Received: (at 39778) by debbugs.gnu.org; 25 Feb 2020 21:00:46 +0000 Original-Received: from localhost ([127.0.0.1]:56190 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j6hJq-0006Wa-TX for submit@debbugs.gnu.org; Tue, 25 Feb 2020 16:00:46 -0500 Original-Received: from ted.gofardesign.uk ([67.225.143.91]:56038) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j6hJl-0006WG-Ni for 39778@debbugs.gnu.org; Tue, 25 Feb 2020 16:00:41 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=marxist.se; s=default; h=Content-Type:MIME-Version:Message-ID:Date:References: In-Reply-To:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=T2izJ8t5BhPEfFXu6OeOhWFCDodtI1ZQ596nVT873VE=; b=lAfBzQ/nXadAgCYmWqJcbQJyMX E/b6BmHbq4A7TklfkQBy9NfVD0KH2KlQ3r7gp+3ZoMFJ5btyC78RCVPkzgP3105pWPwuv/464UqxD UIc7begi4xyChN4UBZrAIkExAEavOkdC0JROD8Gf7pYzjoZ8wgPpWaDYd8Dp40YtU2LmU9tznyIK9 0ow9x4ePtAblPGRR32oTHeiQTX0f2y1OW7hVDNStHJB5KkygZpfiyF1tWj8hZHBSHD+Vw7M2wngtT lyqS/3e8DuPwmkiRvH5mQwAlPSULXAp0hzX2n+DW3aa3HqHAOA02ey7IWEeC/cpPFLeSppKk4cZiZ nNeWQpQg==; Original-Received: from h-4-70-69.a785.priv.bahnhof.se ([155.4.70.69]:57956 helo=localhost) by ted.gofardesign.uk with esmtpsa (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.92) (envelope-from ) id 1j6hJf-000gkr-Jq; Tue, 25 Feb 2020 16:00:31 -0500 In-Reply-To: <87imjumxff.fsf@gnu.org> (Bastien's message of "Tue, 25 Feb 2020 17:41:40 +0100") X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - ted.gofardesign.uk X-AntiAbuse: Original Domain - debbugs.gnu.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - marxist.se X-Get-Message-Sender-Via: ted.gofardesign.uk: authenticated_id: stefan@marxist.se X-Authenticated-Sender: ted.gofardesign.uk: stefan@marxist.se 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:176477 Archived-At: Bastien writes: > Drew Adams writes: > >>> Is "cf." really so much less common? >> >> I think it is, but I won't try to support that as a fact. While looking into this, I found Writing for Computer Science by (2004) by Justin Zobel. "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) I think the above points should be carefully considered. > FWIW I think "cf." is pretty common. It also has the advantage > of being understood by non-english speaker. 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. Best regards, Stefan Kangas