From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#12810: 24.2.50; doc string of `syntax-propertize-function' Date: Mon, 5 Nov 2012 15:08:30 -0800 Message-ID: <5BBCE110ED4B4C4FA30D048358E09251@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1352156943 5613 80.91.229.3 (5 Nov 2012 23:09:03 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 5 Nov 2012 23:09:03 +0000 (UTC) To: 12810@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Nov 06 00:09:12 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TVVn3-0001H6-Ab for geb-bug-gnu-emacs@m.gmane.org; Tue, 06 Nov 2012 00:09:09 +0100 Original-Received: from localhost ([::1]:51405 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TVVmu-0007os-AU for geb-bug-gnu-emacs@m.gmane.org; Mon, 05 Nov 2012 18:09:00 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:58854) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TVVmq-0007oc-Ob for bug-gnu-emacs@gnu.org; Mon, 05 Nov 2012 18:08:57 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TVVmp-0005mP-DT for bug-gnu-emacs@gnu.org; Mon, 05 Nov 2012 18:08:56 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:40950) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TVVmp-0005lk-9r for bug-gnu-emacs@gnu.org; Mon, 05 Nov 2012 18:08:55 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TVVpq-00006K-Jm for bug-gnu-emacs@gnu.org; Mon, 05 Nov 2012 18:12:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 05 Nov 2012 23:12:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 12810 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.1352157109368 (code B ref -1); Mon, 05 Nov 2012 23:12:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 5 Nov 2012 23:11:49 +0000 Original-Received: from localhost ([127.0.0.1]:51201 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TVVpc-00005s-RV for submit@debbugs.gnu.org; Mon, 05 Nov 2012 18:11:49 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:43315) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TVVpa-00005l-Fi for submit@debbugs.gnu.org; Mon, 05 Nov 2012 18:11:47 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TVVmX-0005ig-P6 for submit@debbugs.gnu.org; Mon, 05 Nov 2012 18:08:38 -0500 Original-Received: from lists.gnu.org ([208.118.235.17]:60910) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TVVmX-0005ic-M0 for submit@debbugs.gnu.org; Mon, 05 Nov 2012 18:08:37 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:58830) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TVVmW-0007k6-Fw for bug-gnu-emacs@gnu.org; Mon, 05 Nov 2012 18:08:37 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TVVmV-0005iQ-El for bug-gnu-emacs@gnu.org; Mon, 05 Nov 2012 18:08:36 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:26911) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TVVmV-0005iK-7g for bug-gnu-emacs@gnu.org; Mon, 05 Nov 2012 18:08:35 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by userp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id qA5N8WsA024708 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 5 Nov 2012 23:08:34 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id qA5N8WGP016038 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Mon, 5 Nov 2012 23:08:32 GMT Original-Received: from abhmt112.oracle.com (abhmt112.oracle.com [141.146.116.64]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id qA5N8Whb009913 for ; Mon, 5 Nov 2012 17:08:32 -0600 Original-Received: from dradamslap1 (/130.35.178.8) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 05 Nov 2012 15:08:32 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac27qnhjt2LBwMYvR/yrSiFxB+Unww== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:66503 Archived-At: The doc in the Elisp manual is a bit better than the doc string. Neither is very clear. 1. "Mode-specific function to apply the syntax-table properties." What on earth are "_the_ syntax properties"? Where are they documented? 2. Neither the manual nor the doc string says how the properties in question used are chosen/determined. And none of the links provided in the manual here lead to doc that says which properties are involved or how they are picked. Well, maybe (?) node `Syntactic Font Lock' provides a clue, but without making any explicit connection. That is, maybe `face' is one of the properties (or the only property?) involved, and `font-lock-syntactic-face-function' is how particular faces are picked for particular syntactic constructs. That's just a wild guess. I see no real help/explanation about this, and it is not at all clear to me what is involved. 3. In the doc string, as in the manual, say what the parameters START and END are: "the starting and ending positions of the text on which it should act". In GNU Emacs 24.2.50.1 (i386-mingw-nt5.1.2600) of 2012-10-22 on DANI-PC Bzr revision: 110618 monnier@iro.umontreal.ca-20121022132928-232zm0fecassmhfb Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -I../../libs/libxpm-3.5.8/include -I../../libs/libxpm-3.5.8/src -I../../libs/libpng-1.4.10 -I../../libs/zlib-1.2.6 -I../../libs/giflib-4.1.4-1/include -I../../libs/jpeg-6b-4/include -I../../libs/tiff-3.8.2-1/include -I../../libs/libxml2-2.7.8-w32-bin/include/libxml2 -I../../libs/gnutls-3.0.16/include -I../../libs/libiconv-1.14-2-mingw32-dev/include'