From: "Drew Adams" <drew.adams@oracle.com>
To: "'Eli Zaretskii'" <eliz@gnu.org>
Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org
Subject: RE: use and doc of function symbol properties [was: bug#11381: 23.3; isearch-search-and-update issue?]
Date: Mon, 28 May 2012 11:26:35 -0700 [thread overview]
Message-ID: <AAE7775371CE4A2C9FD967B7D803BCBF@us.oracle.com> (raw)
In-Reply-To: <83ehq419bn.fsf@gnu.org>
> > Can you be more specific about what is missing from the
> > Commentary in delsel.el?
>
> It basically doesn't explain anything apart of the fact that the
> property can have several values. The exact effect of each value is
> left unclear to the degree of obfuscation.
The effect of each value is described, though perhaps imperfectly and not to
your liking.
Again, what specifically do you feel is missing? Just repeating "obfuscation"
does not help. Please specify the information that you would add.
> And the names of the values are similarly non-specific.
The names do not stand alone without their descriptions. Even so, I think that
`yank' and `kill' are pretty clear even without reading their descriptions.
`supersede' is not so obvious, but its description seems clear.
"non-nil" should be "anything else non-nil". And we should say that this is the
usual case.
FWIW, in my version of delsel.el I changed the wording a tiny bit, to improve it
slightly:
;; The property can have one of these values:
;;
;; `yank' - For commands that do a yank. Ensures that the region
;; about to be deleted is not yanked.
;;
;; `supersede' - Delete the active region and ignore the current
;; command: the command just deletes the region.
;;
;; `kill' - `kill-region' is used on the selection, rather than
;; `delete-region'. Text selected with the mouse is
;; typically yankable anyway.
;;
;; anything else non-nil - Deletes the active region prior to
;; executing the command, which inserts replacement
;; text. This is the usual case.
I'm not saying the existing descriptions should not be changed. I'm asking you
what changes you have in mind.
> What is needed is a clear description what each value does,
For instance? What is missing, in your opinion?
> and it should be part of the doc string. Right now, this info is only
> available by reading the code.
Agreed.
next prev parent reply other threads:[~2012-05-28 18:26 UTC|newest]
Thread overview: 32+ messages / expand[flat|nested] mbox.gz Atom feed top
2012-04-29 22:31 bug#11381: 23.3; isearch-search-and-update issue? Andy Grover
2012-04-30 0:27 ` Juri Linkov
2012-05-01 9:03 ` Juri Linkov
2012-05-01 13:08 ` Stefan Monnier
2012-05-01 15:17 ` Juri Linkov
2012-05-15 21:35 ` Juri Linkov
2012-05-16 2:35 ` Stefan Monnier
2012-05-17 0:08 ` Juri Linkov
2012-05-20 0:15 ` Juri Linkov
2012-05-21 1:36 ` Stefan Monnier
2012-05-21 2:23 ` Stefan Monnier
2012-05-27 9:43 ` Juri Linkov
2012-05-28 4:48 ` Stefan Monnier
2012-05-28 8:55 ` Juri Linkov
2012-05-28 14:08 ` Stefan Monnier
2012-05-29 9:49 ` Juri Linkov
2012-05-29 13:34 ` Stefan Monnier
2012-05-27 9:35 ` Juri Linkov
2012-05-28 4:23 ` Stefan Monnier
2012-05-28 15:44 ` Eli Zaretskii
2012-05-28 17:34 ` bug#11381: use and doc of function symbol properties [was: bug#11381: 23.3; isearch-search-and-update issue?] Drew Adams
2012-05-28 17:34 ` Drew Adams
2012-05-28 17:53 ` Eli Zaretskii
2012-05-28 18:26 ` Drew Adams [this message]
2012-05-28 20:43 ` Eli Zaretskii
2012-05-30 0:10 ` Drew Adams
2012-06-02 16:47 ` Eli Zaretskii
2012-06-02 16:57 ` Drew Adams
2012-06-02 17:52 ` Drew Adams
2012-05-28 19:34 ` bug#11381: 23.3; isearch-search-and-update issue? Stefan Monnier
2012-05-29 0:27 ` Juri Linkov
2012-05-29 1:26 ` Stefan Monnier
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=AAE7775371CE4A2C9FD967B7D803BCBF@us.oracle.com \
--to=drew.adams@oracle.com \
--cc=eliz@gnu.org \
--cc=emacs-devel@gnu.org \
--cc=monnier@iro.umontreal.ca \
/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.