From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?utf-8?B?Sm/Do28gVMOhdm9yYQ==?= Newsgroups: gmane.emacs.devel Subject: Re: docstring has wrong usage of unescaped single quotes (use \= or different quoting) Date: Fri, 22 Jul 2022 16:23:48 +0100 Message-ID: <87a691npbv.fsf@gmail.com> References: <87fsitphry.fsf@gmail.com> <87mtd1nsn5.fsf@gmail.com> <87o7xh8b76.fsf@gnus.org> 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="37657"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: Antoine Kalmbach , Phil Sainty , emacs-devel@gnu.org To: Lars Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Jul 22 17:23:15 2022 Return-path: Envelope-to: ged-emacs-devel@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 1oEuUl-0009as-Ok for ged-emacs-devel@m.gmane-mx.org; Fri, 22 Jul 2022 17:23:15 +0200 Original-Received: from localhost ([::1]:37924 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oEuUk-00064F-Qu for ged-emacs-devel@m.gmane-mx.org; Fri, 22 Jul 2022 11:23:14 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:41390) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oEuU9-0005Mo-Re for emacs-devel@gnu.org; Fri, 22 Jul 2022 11:22:37 -0400 Original-Received: from mail-wr1-x434.google.com ([2a00:1450:4864:20::434]:40778) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oEuU7-0005kP-Ps for emacs-devel@gnu.org; Fri, 22 Jul 2022 11:22:37 -0400 Original-Received: by mail-wr1-x434.google.com with SMTP id m17so6671204wrw.7 for ; Fri, 22 Jul 2022 08:22:35 -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=WI8o51RMa7Pu58oRvMdCjPAB25Ri5yfJydDhbg3mSXc=; b=NUg5yaDhvJ0t3hrbVsk7RCFiTYyNwz7Nmx96H+jVel1b+xB8oRNZTYo28j1AjBQQLi LhtbZOgU1K/2aluym7t2qEdZ9jcqiiAICPO84mvJscZDHIDPWTGG8Ka8u+HsiHvSuqIq 9hudMoG0ijj1CWHVYfIwv4D69op+QavFGzxLHygwyf6/RAR6cHcGQK9FfbZUB1Vm582X KBlfqpiaGaR7WlQretsld7G9JHHSv1qGupaipn4fdqdAZDyiweMFnly9r53LTUeMqzqS IPtMFWZeF27FoxvyWVu/feGWTTKuaPUKqytqxdzpq/5bGMT8aP52l6da1pDG0g2AMQ3m uGjw== 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=WI8o51RMa7Pu58oRvMdCjPAB25Ri5yfJydDhbg3mSXc=; b=yP2bdyq6zHw10EJ+H6ymHxDMf7iSwMvhRHD1bn5rncbdDVCpPSy1zBdEHObxxv+1Oa AhF0DLJIco52gm0Pkw/CuSru46h/0v80itin5aEpXtSjubJ4Po72lXuOR/mt8QC/DQ5i STjSrVa9Tzss97NfO3+dux531FoLZqDLQfXEM0BYUo0N6NebnCbhL9wQR5wo4/jvP7cs xI2ntnD3IiihWgFZEfgt+X76KQNIvYnyVP3V8OMl3zgTjAfuu3/onR1d6BFyKK+S4ZvA lZOaWzvkzX0nRL/RJVu+9EY2g4dROwhi7ZAX4MedWB57rnjJFf6/S3Pz/cINFKju8xnJ XCZg== X-Gm-Message-State: AJIora/7/Dd3MVvHWAOmzp6TsBHzau1aDZ66c+FJUpKwYE7O7JCbVwha 56edVQ8JqBI8jGs2vnFoWP93hQYeSPE= X-Google-Smtp-Source: AGRyM1u6q33GQO8DeIAjMAcfws6W3iXJ2/O95nayLcSalrCnW61AiULMqTWyP9S77F3g0QDJEeMGCA== X-Received: by 2002:adf:fd8b:0:b0:21d:6913:84ef with SMTP id d11-20020adffd8b000000b0021d691384efmr282761wrr.525.1658503353458; Fri, 22 Jul 2022 08:22:33 -0700 (PDT) Original-Received: from krug ([87.196.72.209]) by smtp.gmail.com with ESMTPSA id l10-20020a7bc34a000000b003a30f84a9aasm5237644wmj.26.2022.07.22.08.22.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 22 Jul 2022 08:22:33 -0700 (PDT) In-Reply-To: <87o7xh8b76.fsf@gnus.org> (Lars Ingebrigtsen's message of "Fri, 22 Jul 2022 16:38:05 +0200") Received-SPF: pass client-ip=2a00:1450:4864:20::434; envelope-from=joaotavora@gmail.com; helo=mail-wr1-x434.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:292453 Archived-At: Lars Ingebrigtsen writes: > Jo=C3=A3o T=C3=A1vora writes: > >> But, IMHO, introducing such a new warning that has little to do with >> byte-compilation is a drag on people working with existing packages and >> looking for byte-compilation issues. > > We've been using byte compilation warnings for ages to make people > actually fix things that aren't, strictly speaking, necessary for > getting something to byte compile. For instance, deprecation warnings > and warnings about not using save-excursion+set-buffer. Presumably these warnings tell me something about the forward-compatiblity, performance, or otherwise functional aspects of my program. I do not count the documentation there. It's not that I don't pay attention to it, but I don't necessarily do simultaneously when making my program functionally correct. This is why we one has different checkers, and why different checkers check different things. In the byte-compilation check, this is a hack. Else we may just as well add spell-checking to the byte-compiler. >> Maybe there is a flag to turn off >> or demote this warning, and maybe that flag could be used in >> elisp-flymake-byte-compile. > > See `byte-compile-warning-types'. Thanks. Jo=C3=A3o