From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#30393: 24.4; cperl-mode: indentation failure - Documentation enhancements Date: Thu, 19 Apr 2018 10:52:41 +0300 Message-ID: <83zi1zzl86.fsf@gnu.org> References: <20180210112654.GA4537@ACM> <20180211103610.GA4515@ACM> <20180212183800.GA5601@ACM> <20180305084255.GA4786@ACM> <83zi3msdms.fsf@gnu.org> <20180408105257.GA5350@ACM> <83vad0xlwu.fsf@gnu.org> <20180416192137.GA5637@ACM> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1524124275 10273 195.159.176.226 (19 Apr 2018 07:51:15 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 19 Apr 2018 07:51:15 +0000 (UTC) Cc: dgutov@yandex.ru, 30393@debbugs.gnu.org, monnier@IRO.UMontreal.CA, npostavs@users.sourceforge.net To: Alan Mackenzie Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Apr 19 09:51:10 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f94LW-0002YR-Fb for geb-bug-gnu-emacs@m.gmane.org; Thu, 19 Apr 2018 09:51:10 +0200 Original-Received: from localhost ([::1]:57320 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f94Nb-0004yp-Fm for geb-bug-gnu-emacs@m.gmane.org; Thu, 19 Apr 2018 03:53:19 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43328) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f94NK-0004x1-SD for bug-gnu-emacs@gnu.org; Thu, 19 Apr 2018 03:53:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f94NJ-00032y-W0 for bug-gnu-emacs@gnu.org; Thu, 19 Apr 2018 03:53:02 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:52160) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1f94NJ-00032g-S1 for bug-gnu-emacs@gnu.org; Thu, 19 Apr 2018 03:53:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1f94NJ-0003Oz-IS for bug-gnu-emacs@gnu.org; Thu, 19 Apr 2018 03:53:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 19 Apr 2018 07:53:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 30393 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 30393-submit@debbugs.gnu.org id=B30393.152412437613066 (code B ref 30393); Thu, 19 Apr 2018 07:53:01 +0000 Original-Received: (at 30393) by debbugs.gnu.org; 19 Apr 2018 07:52:56 +0000 Original-Received: from localhost ([127.0.0.1]:60057 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f94NE-0003Og-9h for submit@debbugs.gnu.org; Thu, 19 Apr 2018 03:52:56 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:52189) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f94ND-0003OT-3I for 30393@debbugs.gnu.org; Thu, 19 Apr 2018 03:52:55 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f94N7-0002oU-30 for 30393@debbugs.gnu.org; Thu, 19 Apr 2018 03:52:50 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:60138) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f94Mo-0002cH-Ih; Thu, 19 Apr 2018 03:52:30 -0400 Original-Received: from [176.228.60.248] (port=1897 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1f94Mn-0000xg-Pc; Thu, 19 Apr 2018 03:52:30 -0400 In-reply-to: <20180416192137.GA5637@ACM> (message from Alan Mackenzie on Mon, 16 Apr 2018 19:21:37 +0000) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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: 208.118.235.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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:145604 Archived-At: > Date: Mon, 16 Apr 2018 19:21:37 +0000 > Cc: monnier@IRO.UMontreal.CA, 30393@debbugs.gnu.org, dgutov@yandex.ru, > npostavs@users.sourceforge.net > From: Alan Mackenzie > > However, I propose the following documentation changes to go with my > patch to the code, these changes clarifying some of the limitations > inherent to syntax-ppss, and indicating how my enhancements will work. OK. I have a minor stylistic comment about the documentation changes: > +As an alternative to setting @code{syntax-table} text properties > +directly, you can use @code{syntax-propertize-function} (see below). > +Most major modes supplied with Emacs which use these text properties > +use this method for applying them. We strongly recommended you to use > +just one of these methods in any Emacs Lisp program, and not to mix > +them in the same buffer.@footnote{@code{syntax-propertize-function} > +can operate at unpredictable times, and may erase explicitly applied > +@code{syntax-table} properties.} @footnote should begin before the period that ends a sentence to which the footnote applies. I believe the usual typographic convention is to show footnotes as this: bla bla bla¹. rather than as this: yak yak yak.¹ If you agree, this should be fixed in more than one place in your patch. Another minor comment is to please consider whether the description you add warrant some new index entries, so that it would be easier to find this stuff when one is specifically looking for it. I tend to think at least some index entries would be useful. Thanks.