From: "Drew Adams" <drew.adams@oracle.com>
To: 12810@debbugs.gnu.org
Subject: bug#12810: 24.2.50; doc string of `syntax-propertize-function'
Date: Mon, 5 Nov 2012 15:08:30 -0800 [thread overview]
Message-ID: <5BBCE110ED4B4C4FA30D048358E09251@us.oracle.com> (raw)
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'
next reply other threads:[~2012-11-05 23:08 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2012-11-05 23:08 Drew Adams [this message]
2012-11-17 7:34 ` bug#12810: 24.2.50; doc string of `syntax-propertize-function' Chong Yidong
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=5BBCE110ED4B4C4FA30D048358E09251@us.oracle.com \
--to=drew.adams@oracle.com \
--cc=12810@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.