From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 03 04:19:18 2022 Received: (at submit) by debbugs.gnu.org; 3 Jun 2022 08:19:18 +0000 Received: from localhost ([127.0.0.1]:55205 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nx2Wb-0007T5-Bn for submit@debbugs.gnu.org; Fri, 03 Jun 2022 04:19:18 -0400 Received: from lists.gnu.org ([209.51.188.17]:41156) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nwuoD-0003jg-4U for submit@debbugs.gnu.org; Thu, 02 Jun 2022 20:05:00 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:58378) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nwuo7-0004xD-DY for bug-gnu-emacs@gnu.org; Thu, 02 Jun 2022 20:04:51 -0400 Received: from wnew1-smtp.messagingengine.com ([64.147.123.26]:52745) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nwuo4-0003bh-Sr for bug-gnu-emacs@gnu.org; Thu, 02 Jun 2022 20:04:50 -0400 Received: from compute2.internal (compute2.nyi.internal [10.202.2.46]) by mailnew.west.internal (Postfix) with ESMTP id 1DD302B0592E; Thu, 2 Jun 2022 20:04:43 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute2.internal (MEProxy); Thu, 02 Jun 2022 20:04:43 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eliza.sh; h=cc :content-transfer-encoding:content-type:date:date:from:from :in-reply-to:message-id:mime-version:reply-to:sender:subject :subject:to:to; s=fm1; t=1654214682; x=1654218282; bh=VonGysp1Ka G+u02aQfvkYEEdLYKs02R58hJ1GJGcTf4=; b=oIRVz1tzDJC2DeG3SwH8rT7aV7 MuaGjnZXUpKBnB/L/HnGUW73GTpn4ML4/j6i6EziW+P+rjanuEfnG2NhRcdtPCQ4 yZ0a6c3vt9QwrB8W11847ZwLp6EqS1LZyf4HnZnXNmu6hCELeXUvK4moX4OAKsCT t/Nb7DWyx+5EKwnREwzRW5FzDzY+83Ps6uHOqwUvJSvnS3e3uZkVgE/VPTQeHfZF tc9jA6qqh+ZRYiJP38TtW0/zs5maVMWhjy368nNSV++piQ/GK4oNrKwHqsiw1aX4 +XnPlpyrOoEOGnTZ+NppU7eGrdyhTfeIm4iypwwTnUZrCvS6kaFOJ4vn/qZg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:date:feedback-id:feedback-id:from:from:in-reply-to :message-id:mime-version:reply-to:sender:subject:subject:to:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm1; t=1654214682; x=1654218282; bh=VonGysp1KaG+u02aQfvkYEEdLYKs 02R58hJ1GJGcTf4=; b=lWJIWrvjZzkJw4OUr1oGh/EFVDJQkrZ6JPEMYufIxmod vlf5lzZ2WRStFqLjyLIs1iSpoOEFZPs/coC6RTqVz1rrU9ng5JvWCbESXE5DEXk7 XTrKTbVEPnLghD/2gDzUS/MRza/hN+G2W4QaKJp88dufjy1I5d+ZeJIWeMLW14d1 eXjunlLYnLhkWAj1YjL7mA3L2v3QBkPFSlVfx+UyE8LbGiDRw2r1Szq/vU39Uvh5 zxrAkiTtwugBdRNo0NOaRN+2KVJVD9uEbpyqM4bT8s0T72cafwNa3f7ghp6Ubr18 M44BWk8iGeAr+drwelgwLwe0R/Srl04S8aV2T7BheQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrleehgddvlecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkfggtgfgsehtqhertddttd ejnecuhfhrohhmpefglhhiiigrucggvghlrghsqhhuvgiiuceovghlihiirgesvghlihii rgdrshhhqeenucggtffrrghtthgvrhhnpeelteduuefhgfdtgfefudeugeevleelieehvd eitdfgvdeuheejgeevveegvdfhgeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgr mhepmhgrihhlfhhrohhmpegvlhhiiigrsegvlhhiiigrrdhshh X-ME-Proxy: Feedback-ID: i87c446d8:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Thu, 2 Jun 2022 20:04:42 -0400 (EDT) From: Eliza Velasquez To: bug-gnu-emacs@gnu.org Subject: 29.0.50; byte-compile-docstring-style-warn warns against valid usages of curved quotes Date: Thu, 02 Jun 2022 17:04:41 -0700 Message-ID: <87h752d33a.fsf@eliza.sh> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=64.147.123.26; envelope-from=eliza@eliza.sh; helo=wnew1-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.7 (-) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Fri, 03 Jun 2022 04:19:15 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.7 (--) The elisp manual states in "(elisp)Documentation Tips" > When a documentation string refers to a Lisp symbol, write it as it > would be printed (which usually means in lower case), surrounding it > with curved single quotes (=E2=80=98..=E2=80=99). =E2=80=98checkdoc=E2=80=99 treats this case as valid. Recently, though, it seems like bytecomp.el=E2=80=99s =E2=80=98byte-compile-docstring-style-warn=E2=80=99 function was recently m= odified by 2701cd59b521989530a7eb7489540c64177e0f69 which mistakenly flags this usage as incorrect. Its news entry states: > When writing code snippets that contains the ' character (APOSTROPHE), > that quote character has to be escaped to avoid Emacs displaying it as > =E2=80=99 (LEFT SINGLE QUOTATION MARK), which would make code examples li= ke >=20 > (setq foo '(1 2 3)) >=20 > invalid. Emacs will now warn during byte compilation if it seems > something like that, and also warn about when using RIGHT/LEFT SINGLE > QUOTATION MARK directly. In both these cases, if these characters > should really be present in the doc string, they should be quoted with > \=3D. Judging by both this news entry and the implementation's regex, I assume this is intended to catch erroneous cases like =E2=80=9C(setq foo =E2=80=99= (1 2 3))=E2=80=9D and allow correct usages like =E2=80=9Cit=E2=80=99s=E2=80=9D, but it inadverten= tly flags cases like =E2=80=9C=E2=80=98lisp-mode=E2=80=99=E2=80=9D. In GNU Emacs 29.0.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.33, c= airo version 1.16.0) Repository revision: e06d600b4963fc6ccc69fb0bbbc725350a80c9fc Repository branch: master System Description: NixOS 22.11 (Raccoon) Configured using: 'configure --prefix=3D/nix/store/banascjwdai200brq116c4m54jx10if9-emacs-pgtk-native-c= omp-20220529.0 --disable-build-details --with-modules --with-x-toolkit=3Dgtk3 --with-cairo --with-native-compilation --with-pgtk' --=20 Eliza From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 03 07:08:32 2022 Received: (at 55780) by debbugs.gnu.org; 3 Jun 2022 11:08:32 +0000 Received: from localhost ([127.0.0.1]:55409 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nx5AO-0005bq-Ek for submit@debbugs.gnu.org; Fri, 03 Jun 2022 07:08:32 -0400 Received: from quimby.gnus.org ([95.216.78.240]:34396) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nx5AM-0005bc-Jq for 55780@debbugs.gnu.org; Fri, 03 Jun 2022 07:08:31 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Transfer-Encoding:Content-Type:MIME-Version:Message-ID :In-Reply-To:Date:References:Subject:Cc:To:From:Sender:Reply-To: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=NDUP5p6f0ZHvomMYF7gPfWKdhqBU+cIaZps18dcaifQ=; b=FonwGahDafn8IJw+lWpYOzn/yD kMKzqAykJhsakuHzKEY2WXD4rXc/Q+L/ZIIF1S3pWt4ikKdnoN4WjztJAae+N6z0zfTdwGo8IHVCk w4kXvO+pJotGkoct1oUUDSzDKgzMHmIyzyPsYg8eIN9gCqXGqW8FU+iKgOP4cVZzriZc=; Received: from [84.212.220.105] (helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nx5AD-0007YJ-8v; Fri, 03 Jun 2022 13:08:24 +0200 From: Lars Ingebrigtsen To: Eliza Velasquez Subject: Re: bug#55780: 29.0.50; byte-compile-docstring-style-warn warns against valid usages of curved quotes References: <87h752d33a.fsf@eliza.sh> X-Now-Playing: The Au Pairs's _Playing With A Different Sex_: "Dear John" Date: Fri, 03 Jun 2022 13:08:19 +0200 In-Reply-To: <87h752d33a.fsf@eliza.sh> (Eliza Velasquez's message of "Thu, 02 Jun 2022 17:04:41 -0700") Message-ID: <87y1ye9f8c.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Eliza Velasquez writes: > The elisp manual states in "(elisp)Documentation Tips" > >> When a documentation string refers to a Lisp symbol, write it as it >> would be printed (which usually means in lower case), surrounding i [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 55780 Cc: 55780@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Eliza Velasquez writes: > The elisp manual states in "(elisp)Documentation Tips" > >> When a documentation string refers to a Lisp symbol, write it as it >> would be printed (which usually means in lower case), surrounding it >> with curved single quotes (=E2=80=98..=E2=80=99). > > =E2=80=98checkdoc=E2=80=99 treats this case as valid. > > Recently, though, it seems like bytecomp.el=E2=80=99s > =E2=80=98byte-compile-docstring-style-warn=E2=80=99 function was recently= modified by > 2701cd59b521989530a7eb7489540c64177e0f69 which mistakenly flags this > usage as incorrect. The =E2=80=98..=E2=80=99 convention in doc strings was introduced in 2015, = but never really took off -- even after seven years, there were only a dozen usages in-tree, so it seemed time to revert back to the previous convention (which is to use `...', which is then converted to =E2=80=98...= =E2=80=99 on display). The problem with =E2=80=98..=E2=80=99 is that nobody still knows= how to type it, and if you're working on a display that can't display those characters, the help texts are all messed up. (Which isn't the case when using `...'.) I forgot to update the documentation here, though, so I've now done that. Perhaps it's a bit early to issue a compilation warning for this, though, since it's probably found in the wild here and there, so I've now disabled that in Emacs 29. --=20 (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 03 07:09:42 2022 Received: (at control) by debbugs.gnu.org; 3 Jun 2022 11:09:43 +0000 Received: from localhost ([127.0.0.1]:55413 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nx5BW-0005de-PJ for submit@debbugs.gnu.org; Fri, 03 Jun 2022 07:09:42 -0400 Received: from quimby.gnus.org ([95.216.78.240]:34430) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nx5BU-0005dQ-KM for control@debbugs.gnu.org; Fri, 03 Jun 2022 07:09:41 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=8av9uVL2Tb09czQU/8RBHTLI8lp+bzm5jEbCf9xByR8=; b=S6A5biMe0J7wZ0eBSVVNsLI1/l pe86eHRavbNr1nClQ39nEvPOWJBoJ9BAHxnaspSuT+HxWVTbvCmXWWlKU8I6EcO1yV5G5ESRXiVTz kkaMV/cznH2VfVpm14SbQSZqRd2R115TmWt0qLHZ1H68A7LiVUmOz5xj1Wd94VHTbm6k=; Received: from [84.212.220.105] (helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nx5BM-0007Zw-Qs for control@debbugs.gnu.org; Fri, 03 Jun 2022 13:09:34 +0200 Date: Fri, 03 Jun 2022 13:09:30 +0200 Message-Id: <87wndy9f6d.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #55780 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: close 55780 29.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) close 55780 29.1 quit From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 03 21:32:15 2022 Received: (at 55780) by debbugs.gnu.org; 4 Jun 2022 01:32:15 +0000 Received: from localhost ([127.0.0.1]:57275 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxIeF-0004UO-3p for submit@debbugs.gnu.org; Fri, 03 Jun 2022 21:32:15 -0400 Received: from new3-smtp.messagingengine.com ([66.111.4.229]:41999) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxIe9-0004U8-Se for 55780@debbugs.gnu.org; Fri, 03 Jun 2022 21:32:13 -0400 Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailnew.nyi.internal (Postfix) with ESMTP id CFE8C58065D; Fri, 3 Jun 2022 21:32:03 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute5.internal (MEProxy); Fri, 03 Jun 2022 21:32:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eliza.sh; h=cc :cc:content-transfer-encoding:content-type:date:date:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:sender:subject:subject:to:to; s=fm1; t=1654306323; x= 1654309923; bh=1IBj2I5JHGG6IBmRogot0C/xYxmn78jf74+cV1Rgzp4=; b=T 8XICmuSEVR9qjFOgY2sgTBcZjs5/F/mAAMq8tb1NtLIl0vg1Uvw4RIAX7CnN8Mq+ ogK5RkphcGpXD5CjDTtKEEyyGzUpsAjlAaZ4orzN2rNSyqdWFp+Rn6MFJb2yHR9i eoP6S0Ot02xhpH0jwZn5QTuVRD6JRW8rs9KIK6bVtax1Z93YkvHd7p/E58N/JZ7X KlOL/TPIMI0Ty2hNiLEL50+qEffy1dYv9Jwouq6+TFbN9DKol788pqLVlYJpVkfN 8XgTlTAiWT0GYM+gM57ocaOMoNTXjEj6KzotDYY73JVJMnw1ymCQeD0wyNfin9BJ VBCTJ4C7y8XNw0PAtbG+g== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:sender:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1654306323; x= 1654309923; bh=1IBj2I5JHGG6IBmRogot0C/xYxmn78jf74+cV1Rgzp4=; b=h JgXcBVlhwcU7svU016yxjCJfbXRhvhaASL1yi9YUf2u1sz6IawmHk0KiV9x/nGfc KPpBgbtHMNlxuK+ZDXTWqDTwvK64ciZ33OJD9oVm7RXvOJDIg/8CIfZ90UpD3PfU LoL3qmZzQ9SjKg34nAStmdx0oQLz54zENZ2i3U2IQC4VRK7yQydKwUyMEnr8lI21 H0vWfrWxOtQhfeO0OHVykzgepbEXWRzbs9ciFI/+X5gXE+x/Khq1RF5BfQiMO9yf XILYHwAMlf7wTwUAVVEe3E2tuvo5ougAsCdkgcIUS3uD/GDirLoBXuiT5RdxgAYL 6cWtWA0H54e36WEojjCWw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrleejgdeghecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpefhvfevufgjfhffkfggtgfgsehtqhertddttdejnecuhfhrohhmpefglhhiiigr ucggvghlrghsqhhuvgiiuceovghlihiirgesvghlihiirgdrshhhqeenucggtffrrghtth gvrhhnpedvfeegfeektefggedvvedvuddtvedtvdetuedvfeeijeejgeekveefhfegudev jeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegvlh hiiigrsegvlhhiiigrrdhshh X-ME-Proxy: Feedback-ID: i87c446d8:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Fri, 3 Jun 2022 21:32:03 -0400 (EDT) From: Eliza Velasquez To: Lars Ingebrigtsen Subject: Re: bug#55780: 29.0.50; byte-compile-docstring-style-warn warns against valid usages of curved quotes In-Reply-To: <87y1ye9f8c.fsf@gnus.org> References: <87h752d33a.fsf@eliza.sh> <87y1ye9f8c.fsf@gnus.org> Date: Fri, 03 Jun 2022 18:32:01 -0700 Message-ID: <87pmjpxlgu.fsf@eliza.sh> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 55780 Cc: 55780@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) On Fri, Jun 03 2022 at 13:08 +02, Lars Ingebrigtsen wrote: > Eliza Velasquez writes: > >> The elisp manual states in "(elisp)Documentation Tips" >> >>> When a documentation string refers to a Lisp symbol, write it as it >>> would be printed (which usually means in lower case), surrounding it >>> with curved single quotes (=E2=80=98..=E2=80=99). >> >> =E2=80=98checkdoc=E2=80=99 treats this case as valid. >> >> Recently, though, it seems like bytecomp.el=E2=80=99s >> =E2=80=98byte-compile-docstring-style-warn=E2=80=99 function was recentl= y modified by >> 2701cd59b521989530a7eb7489540c64177e0f69 which mistakenly flags this >> usage as incorrect. > > The =E2=80=98..=E2=80=99 convention in doc strings was introduced in 2015= , but never > really took off -- even after seven years, there were only a dozen > usages in-tree, so it seemed time to revert back to the previous > convention (which is to use `...', which is then converted to =E2=80=98..= .=E2=80=99 on > display). The problem with =E2=80=98..=E2=80=99 is that nobody still kno= ws how to type > it, and if you're working on a display that can't display those > characters, the help texts are all messed up. (Which isn't the case > when using `...'.) > > I forgot to update the documentation here, though, so I've now done > that. Perhaps it's a bit early to issue a compilation warning for this, > though, since it's probably found in the wild here and there, so I've > now disabled that in Emacs 29. Thank you for the clarification and quick fix. Perhaps the documentation should breifly mention that at one point in time, =E2=80=98...=E2=80=99 was= recommended? That could save on future confusion of people who find usages of the curly format in third party packages (as this was the first place I had ever seen the curly format in the wild). --=20 Eliza From debbugs-submit-bounces@debbugs.gnu.org Sat Jun 04 07:30:25 2022 Received: (at 55780) by debbugs.gnu.org; 4 Jun 2022 11:30:25 +0000 Received: from localhost ([127.0.0.1]:57728 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxRz7-0004ar-ER for submit@debbugs.gnu.org; Sat, 04 Jun 2022 07:30:25 -0400 Received: from quimby.gnus.org ([95.216.78.240]:44916) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxRz6-0004Sd-AL for 55780@debbugs.gnu.org; Sat, 04 Jun 2022 07:30:24 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Transfer-Encoding:Content-Type:MIME-Version:Message-ID :In-Reply-To:Date:References:Subject:Cc:To:From:Sender:Reply-To: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=NCk4S/aFxn7DQPLwxNDot/LVcY1y7DYbXE9eW9q55zU=; b=CWw11RpfmQffi9rI+zbUs6VxDN zSw+Y37qnpEeMVhB0aKsS/rANDKgF4jdXZZmfpz0DyptKebiACleOlcARmT/Bz+2zJifCiW8iPkfg m6FCIwjKvcRKiCkLUnlDD3yAZwQytziYUxZ7EohRewyO8uJhbZ1JpjfFMaWUzgXUW6x4=; Received: from [84.212.220.105] (helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nxRyx-000363-5d; Sat, 04 Jun 2022 13:30:17 +0200 From: Lars Ingebrigtsen To: Eliza Velasquez Subject: Re: bug#55780: 29.0.50; byte-compile-docstring-style-warn warns against valid usages of curved quotes References: <87h752d33a.fsf@eliza.sh> <87y1ye9f8c.fsf@gnus.org> <87pmjpxlgu.fsf@eliza.sh> Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAABGdBTUEAALGPC/xhBQAAACBj SFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAJ1BMVEVlMyKAPhUgOGkX N3U8VUmNUyabaU+2kmrFqowDAwMUKh1WgIP////7CihXAAAAAWJLR0QMgbNRYwAAAAd0SU1FB+YG BAsWC4v0s3YAAAGkSURBVDjLndFNa9swGAdwpTQpyckuK70v/QT1sZcwRLa4F3cgp8cQbGn0Psns XGIfRwmlj3sxxWPY59KN6stVsvNay4ftD8JGPz2PJRl1bKtj17HUOHBWQahj2dtYO2BtVqt0jutp 7KATgq66tu1blo3CrneIP+IzNRw0FSScEvLtO2Ek9MMPtEqoIYniJBZRohPNAxpocdBpLJJpzPl1 LOJEREFA5zUcxWpdEtcFNAmCupeDelwwzvmUCSYEYV9Vr/GY4iGCtCxBRz3V29PmHFCWRQWgoTRB ug/rTv8F7h7orUCaZTNI8QbOV5B11e0MoGxU/PQZn6nCpduAiHsD0M12IS8yX3BP7yF3dwEXqEdp dcoc74GLBllY7XiJP20hxy+/vLBbVaS7gPEo8ynpGwAjRsP++1Y5vpQzxmarK77bAMZSPvviBhpw KaX0qQHUvOxRzwjFiJAGqE6T+5sBMsAEvkyKsgHyFSCZADQB4JGbQBU8LH4YQC1eLm7NAJ/b4HfQ An9dA+hb/dMG48IA1f+BFoAGDFvgQrbC8B8r1h8vDPAGknPX9K4yzwoAAAAldEVYdGRhdGU6Y3Jl YXRlADIwMjItMDYtMDRUMTE6MjI6MTErMDA6MDAd/LLDAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIy LTA2LTA0VDExOjIyOjExKzAwOjAwbKEKfwAAAABJRU5ErkJggg== X-Now-Playing: Vinicius =?utf-8?Q?Cantu=C3=A1ria's_=5FTucum=C3=A3=5F=3A?= "Vivo Isolado do Mundo" Date: Sat, 04 Jun 2022 13:30:14 +0200 In-Reply-To: <87pmjpxlgu.fsf@eliza.sh> (Eliza Velasquez's message of "Fri, 03 Jun 2022 18:32:01 -0700") Message-ID: <87ee04acop.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Eliza Velasquez writes: > Thank you for the clarification and quick fix. Perhaps the documentation > should breifly mention that at one point in time, ‘...’ was recommended? > That could save on future confusion of peopl [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 55780 Cc: 55780@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Eliza Velasquez writes: > Thank you for the clarification and quick fix. Perhaps the documentation > should breifly mention that at one point in time, =E2=80=98...=E2=80=99 w= as recommended? > That could save on future confusion of people who find usages of the > curly format in third party packages (as this was the first place I had > ever seen the curly format in the wild). Good idea -- I've now added a note about this. --=20 (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sat Jun 04 08:22:00 2022 Received: (at submit) by debbugs.gnu.org; 4 Jun 2022 12:22:00 +0000 Received: from localhost ([127.0.0.1]:57837 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxSn2-0003fG-K3 for submit@debbugs.gnu.org; Sat, 04 Jun 2022 08:22:00 -0400 Received: from lists.gnu.org ([209.51.188.17]:51566) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxSmx-0003f5-Lf for submit@debbugs.gnu.org; Sat, 04 Jun 2022 08:21:59 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35868) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nxSmx-0002gl-Gd for bug-gnu-emacs@gnu.org; Sat, 04 Jun 2022 08:21:55 -0400 Received: from mout.kundenserver.de ([217.72.192.74]:37551) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nxSmu-0002Qw-PC for bug-gnu-emacs@gnu.org; Sat, 04 Jun 2022 08:21:55 -0400 Received: from [192.168.178.54] ([89.247.171.234]) by mrelayeu.kundenserver.de (mreue106 [212.227.15.183]) with ESMTPSA (Nemesis) id 1MJEtx-1oBxUz3n2Z-00KkPD for ; Sat, 04 Jun 2022 14:21:50 +0200 Content-Type: multipart/alternative; boundary="------------O0p80j0JHE4bqwOm8ooxT50z" Message-ID: <4ee4cf39-5155-e841-10a7-31de3998803f@easy-emacs.de> Date: Sat, 4 Jun 2022 14:21:50 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.9.1 Subject: Re: bug#55780: 29.0.50; byte-compile-docstring-style-warn warns against valid usages of curved quotes Content-Language: en-US To: bug-gnu-emacs@gnu.org References: <87h752d33a.fsf@eliza.sh> <87y1ye9f8c.fsf@gnus.org> <87pmjpxlgu.fsf@eliza.sh> <87ee04acop.fsf@gnus.org> From: =?UTF-8?Q?Andreas_R=c3=b6hler?= In-Reply-To: <87ee04acop.fsf@gnus.org> X-Provags-ID: V03:K1:r7V1mLeepibFw2BeFRxpBFzz8Bsyp8ZREsUkExew8bi/akDcrGS lbeAuRrmJfGIB6R/H4u91tGp2dNtSvsF0eI00RVMQl+f3I/1Z7+l/D+sxLKpGJTmFYUeHIT I9xl6wsVuVyTVA/UveN7pxaAGr3Kc6pdwl10x1ATKTrN1VMHvaTXcU/TcxSvo8eB55R+kiV rsZfvvZoBejuvIRIRXPAA== X-Spam-Flag: NO X-UI-Out-Filterresults: notjunk:1;V03:K0:JzXcquY6A54=:6UE4ivKoHz/9NALJTNc9qp 1ORmUOilu/eKEElgGUTA8huyt2C9H0euTNQmexUlUkbc4AqFEjmCvvU8wqv0jy/xl2n7/Etzk Tt9jKM6AomJAa/HZT9BaYO+4biXgTapRjwkOjqugki2k23ZhAl6tqDi+ImzUT27pEVVyK+Lbk GBKPO5gP/1gdzhH0c5h8r0nvlcgqnp6UtcIiveYtfdrMtXPmN66jbuCL4AQSM6928i4e4UVBx bR0uWgtK1CCE6Y42jXUvpp0Vj20NpxMPQ+t2OeN59fjl+Kjp7wTb8+wCGOc7/HsDcsyRbwvhH 117quO2GGb3Q+0w4fDq7nojtqMasL/etqcoMp1aFBD7Kzr8siywOeev6Gtc5O1EpjR26n8KAe d7kz2wqDZfMIqLINbcqC1bhvVT8ddCY3fiRgsQ+lun+NryrpM6H27MSEw7XBxGlRO0OJ7RwDk xk2Qv1/r8QN7Z0yqa5A1X0mGq+Y34tMPZ3f7qW6GY37pekpDoXIzvre1RQUYdsZF2i2jddXsS sunuH+6+LUqM4EAZkk5BQgs/YoBDsmODtwstSrQmzwYppi2cH6zpleqVSFVjCo+gE1QobnQjG UTdKRmEiLEvbJ54DSvYpPcAiyee/iFknNrQHAGUL3yEpfBMz4WN1Y8N54xR9FKLBeBvuNu/hd j0i0mL/mh+n8b+AMsuCmKv0yGeRD/FFMPsNwyukNlMhFOqXimcCLDuWS6XhoKiD/ezfY4GdrK 8hrN6Q+PoAq2annom3rmrNcvld/5OZ/13Smb24UPA9ycJOwrw8kB/icDthk= Received-SPF: none client-ip=217.72.192.74; envelope-from=andreas.roehler@easy-emacs.de; helo=mout.kundenserver.de X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, HTML_MESSAGE=0.001, NICE_REPLY_A=-0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) This is a multi-part message in MIME format. --------------O0p80j0JHE4bqwOm8ooxT50z Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Am 04.06.22 um 13:30 schrieb Lars Ingebrigtsen: > Eliza Velasquez writes: > >> Thank you for the clarification and quick fix. Perhaps the documentation >> should breifly mention that at one point in time, ‘...’ was recommended? >> That could save on future confusion of people who find usages of the >> curly format in third party packages (as this was the first place I had >> ever seen the curly format in the wild). > Good idea -- I've now added a note about this. > BTW is there a name for the now new old style - backtick-quoted-symbol? --------------O0p80j0JHE4bqwOm8ooxT50z Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 8bit


Am 04.06.22 um 13:30 schrieb Lars Ingebrigtsen:
Eliza Velasquez <eliza@eliza.sh> writes:


Thank you for the clarification and quick fix. Perhaps the documentation
should breifly mention that at one point in time, ‘...’ was recommended?
That could save on future confusion of people who find usages of the
curly format in third party packages (as this was the first place I had
ever seen the curly format in the wild).

Good idea -- I've now added a note about this.


BTW is there a name for the now new old style - backtick-quoted-symbol?

--------------O0p80j0JHE4bqwOm8ooxT50z-- From debbugs-submit-bounces@debbugs.gnu.org Sat Jun 04 09:15:26 2022 Received: (at 55780) by debbugs.gnu.org; 4 Jun 2022 13:15:26 +0000 Received: from localhost ([127.0.0.1]:57890 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxTck-00078z-DG for submit@debbugs.gnu.org; Sat, 04 Jun 2022 09:15:26 -0400 Received: from quimby.gnus.org ([95.216.78.240]:46072) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nxTci-00078m-No for 55780@debbugs.gnu.org; Sat, 04 Jun 2022 09:15:25 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Transfer-Encoding:Content-Type:MIME-Version:Message-ID :In-Reply-To:Date:References:Subject:Cc:To:From:Sender:Reply-To: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=mCICJvoPG9p0DrwL+UWvKEfy+W30M4z+L3NRMm70LIo=; b=BuX4Mimtp3D93xt4gecZO6pxSL eMXuD2pe1S6vCzZq3WHtPUc2wnviLfgs7q5uz06VqrwgbwzMWbPZ9lGSWjJDj/kzxaU7mg8ujQOL3 rGQ20l1mv21ryvBRxa0n7qq9svqA0bIPczVVWeFXzkMVk2A4Y0dqdnLKhuNWvN78Py5I=; Received: from [84.212.220.105] (helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nxTca-00054p-8O; Sat, 04 Jun 2022 15:15:18 +0200 From: Lars Ingebrigtsen To: Andreas =?utf-8?Q?R=C3=B6hler?= Subject: Re: bug#55780: 29.0.50; byte-compile-docstring-style-warn warns against valid usages of curved quotes References: <87h752d33a.fsf@eliza.sh> <87y1ye9f8c.fsf@gnus.org> <87pmjpxlgu.fsf@eliza.sh> <87ee04acop.fsf@gnus.org> <4ee4cf39-5155-e841-10a7-31de3998803f@easy-emacs.de> Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAABGdBTUEAALGPC/xhBQAAACBj SFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAElBMVEUPDxInHCONbKxO KEOiOy3///9uRwijAAAAAWJLR0QF+G/pxwAAAAd0SU1FB+YGBAw1FyQTjt0AAAGlSURBVDjLpZNh mqMwCIbh6R4AxAOsZA4gkAO0mvufaUk6M9raf8uPqLx8BAkB+G9DZiY6vpl/QaIDYLEkmA40PoOb aiG4/e1axFMqdFUCfN9wWmCO+A07FF6wHXJkW79fdaGGcNryJ0QXvCP4+gmswG7v4KaZCFivCg+T 2q4AoC5Sd71uPredUK4AYvrKDpVrpy0bslzjYX508OFoNkbxxwfQcvnzAcwje7sWuw3XdH/zCzde 8zznB9tJ5CAzZb8ni7oTUJ8RxhXZgTM55TnDfO/eCBZfOY+TmxsHO0sfD9UOTRaE1vwrYtOwaoxf zVjUpoVBS4R6aEQsnL0Jm8oAHl5105yrnsSTh1rk+Eno0zL+Vlt0VckoiAGiuJqI1j3qpsWLQd84 N8j+lmAte6L82hp0l46lKGW0L2WEgfZUuw8Vieoj/zHzOvQ6m0VUcqMMshyw4iFQIr3ELBRMWRAT S+nXKPhpQsYkcUwj/9j7UOPTO4alL3CSjEf22T4oXi7kGfQrzG/kW5ANfSXS0mysO13AHn2NFwkP V9Sk9lIA15OCjuL+AZFuUILiwA2mAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDIyLTA2LTA0VDEyOjUz OjIzKzAwOjAwf9+2egAAACV0RVh0ZGF0ZTptb2RpZnkAMjAyMi0wNi0wNFQxMjo1MzoyMyswMDow MA6CDsYAAAAASUVORK5CYII= X-Now-Playing: 1CD (2022) - 05 Sea Sapphire's _Illusion_: "(Circle Of Whispers)" Date: Sat, 04 Jun 2022 15:15:15 +0200 In-Reply-To: <4ee4cf39-5155-e841-10a7-31de3998803f@easy-emacs.de> ("Andreas =?utf-8?Q?R=C3=B6hler=22's?= message of "Sat, 4 Jun 2022 14:21:50 +0200") Message-ID: <87zgis604c.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Andreas Röhler writes: > BTW is there a name for the now new old style - backtick-quoted-symbol? I think we sometimes call them "fancy quotes"? Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 55780 Cc: 55780@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Andreas R=C3=B6hler writes: > BTW is there a name for the now new old style - backtick-quoted-symbol? I think we sometimes call them "fancy quotes"? --=20 (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From unknown Sat Sep 13 09:20:29 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 03 Jul 2022 11:24:06 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator