From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: =?utf-8?B?xaB0xJtww6FuIE7Em21lYw==?= Newsgroups: gmane.emacs.devel Subject: Re: Reliable after-change-functions (via: Using incremental parsing in Emacs) Date: Tue, 31 Mar 2020 15:36:21 +0200 Message-ID: <87tv24lk8a.fsf@gmail.com> References: <83o8sf3r7i.fsf@gnu.org> <2E218879-0F24-4A20-B210-263C8D0BEEA4@gmail.com> <87o8sdn0ot.fsf@gmail.com> <09E90C25-6119-44D4-85F2-A9CC4196FFE4@gmail.com> <83a73x3bh1.fsf@gnu.org> <87y2rhkwhk.fsf@gmail.com> <83zhbw1x7f.fsf@gnu.org> 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="32432"; 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) Cc: casouri@gmail.com, akrl@sdf.org, monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Mar 31 15:37:17 2020 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 1jJH4u-0008Jj-2n for ged-emacs-devel@m.gmane-mx.org; Tue, 31 Mar 2020 15:37:16 +0200 Original-Received: from localhost ([::1]:38232 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jJH4t-0007W2-05 for ged-emacs-devel@m.gmane-mx.org; Tue, 31 Mar 2020 09:37:15 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43936) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jJH3f-0005qL-2x for emacs-devel@gnu.org; Tue, 31 Mar 2020 09:35:59 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jJH3d-0003uS-U9 for emacs-devel@gnu.org; Tue, 31 Mar 2020 09:35:58 -0400 Original-Received: from mail-lf1-x144.google.com ([2a00:1450:4864:20::144]:39295) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1jJH3b-0003sy-TU; Tue, 31 Mar 2020 09:35:56 -0400 Original-Received: by mail-lf1-x144.google.com with SMTP id h6so11546575lfp.6; Tue, 31 Mar 2020 06:35:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-transfer-encoding; bh=0gIGu1Lym5Z2ThcHg3DfbOms18kzHg24i6gkxePMR+U=; b=YCMnEjiYszfyTfwmL83zUrO4VIuIacsy0umY0tkN16VcZkD2zYMpZOi0xk+tdd/uEe jlByeg/BpJUnmS5HP6QhSlnBbgf+PeRmz1pqEm7X1554e4lsITfd0hp2EweFetIxVzbg K4J6vxkxjgdE/XZwUn6rsv052C6wTQhmUVnhOLbNcHTE9CfzXF2FQo1k9yX+amlbzxyH ZK8EBVR75bBPNFDS8zNlEvTpQjsUr1lz82Rd6GHzVvzYhZZjTaYpBFq5kDbelqT6hE7r qAjmt6xXVo0z1Q/BRCRD4mKhM9nUb6Hl2l7/796ZEmJ7hp6ov1olUTpwqWpR8oawRGwk +sGA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references :user-agent:date:message-id:mime-version:content-transfer-encoding; bh=0gIGu1Lym5Z2ThcHg3DfbOms18kzHg24i6gkxePMR+U=; b=NMO0T7RGF41hbYzjjZpO9u6n4MaXWpM3Xe9juAz/obBvJhyzVrZMmTzXbUkGr096Oi 2yPq8bRKuqtUpM2FmOCEinlJUxEDG7plLxReU6uC9llZb0rA7z3Bi0GQ0FlgJvaGgsJi 40xeHae0xHVaH+YFCPI8qsOgXaBPp5ce3Ic61J98lygC2kl7vL5R67hlfOqUfoBUxoEN OCmW7m8H50xHa5IVWQE05UN65Z3Hcc9X7ckdrLqelofr2enVipagx+P9O+DjsydE4FiG 7SfzxDHU+8thREhyNI5pwwFPTprfDoEBjeXJOq9XxwNT+vupsN96kIpmmy5CrIWg/qoS czAQ== X-Gm-Message-State: AGi0PubDIzpcF5BgaddT201rIGdMTrTHjeuWfdiuuyOi78SpNTPnVzIZ mbOM9UAUOMpqVgx5wQmQp7mOEe0S X-Google-Smtp-Source: APiQypIlmxD9mR8Y6PlgARQVi+s076TilYcoOkkQ47vvnt3wbOkpPbWrDbbPskJ2sZ0iNR2A5FfTug== X-Received: by 2002:a19:6746:: with SMTP id e6mr11322906lfj.43.1585661754229; Tue, 31 Mar 2020 06:35:54 -0700 (PDT) Original-Received: from localhost ([185.112.167.47]) by smtp.gmail.com with ESMTPSA id n17sm8712773ljc.76.2020.03.31.06.35.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 31 Mar 2020 06:35:53 -0700 (PDT) In-Reply-To: <83zhbw1x7f.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::144 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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:246095 Archived-At: On Tue, 31 Mar 2020 16:16:20 +0300 Eli Zaretskii wrote: >> I think the explanation in (info "(elisp) Change Hooks") is quite good, >> but the doc string had better clarify the usage as well. >>=20 >> How about the attached patch? > > Thanks, I think this is too wordy for a doc string. I think it should > be enough to mention the two variables ("See also ...") and maybe add > a link to the ELisp manual section you mention. In that case, could we add the "should" part (or something similar) to the manual (in addition to the doc string reference you describe)? It is true that careful reading of the manual and the relevant doc strings as they are now could suffice to make an informed decision on when `inhibit-modification-hooks' is (in)appropriate, but I think having some kind of explicit heads-up or dissuation regarding the likely misuse would be better. --=20 =C5=A0t=C4=9Bp=C3=A1n