Re: doc string for `yank' should mention paste

2006-03-14 Thread Thien-Thi Nguyen
Eli Zaretskii [EMAIL PROTECTED] writes:

  From: Drew Adams [EMAIL PROTECTED]
  
  You're right, Eli. Once created, however,
  it normally exists forever, no?
 
 Yes, AFAIK.

well, at least until the next (set-mark nil).

thi



___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


RE: doc string for `yank' should mention paste

2006-03-13 Thread Drew Adams
 A detail: The region exists always.

No, it doesn't.  When a buffer is created, at first it has no mark, so
there's no region.  (Try e.g. C-x C-x in a freshly created buffer,
and you will see an error message saying there's no region.)  You must
set the mark once to define the region.

You're right, Eli. Once created, however, it normally exists forever, no?

Anyway, as I say, this detail can be ignored here.

It *might* be worth pointing it out as a difference in terminology
somewhere - a selection is indeed thought of as something that is created
each time you select text. The language used to talk about the region is a
bit different.




___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


Re: doc string for `yank' should mention paste

2006-03-13 Thread Eli Zaretskii
 From: Drew Adams [EMAIL PROTECTED]
 Date: Mon, 13 Mar 2006 08:02:14 -0800
 
  A detail: The region exists always.
 
 No, it doesn't.  When a buffer is created, at first it has no mark, so
 there's no region.  (Try e.g. C-x C-x in a freshly created buffer,
 and you will see an error message saying there's no region.)  You must
 set the mark once to define the region.
 
 You're right, Eli. Once created, however, it normally exists forever, no?

Yes, AFAIK.

 It *might* be worth pointing it out as a difference in terminology
 somewhere - a selection is indeed thought of as something that is created
 each time you select text. The language used to talk about the region is a
 bit different.

Right.


___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


Re: doc string for `yank' should mention paste

2006-03-12 Thread Richard Stallman
Similarly, some basic operations on the region should mention the term
selection as being synonymous with region. `M-x apropos-documentation
region', then search for `selection' finds nothing.

How about this?

*** simple.el   11 Mar 2006 19:19:15 -0500  1.794
--- simple.el   12 Mar 2006 19:57:42 -0500  
***
*** 3196,3201 
--- 3196,3204 
  \\[universal-argument] \\[set-mark-command], unconditionally
  set mark where point is.
  
+ Setting the mark also creates a \region\, which is the Emacs
+ equivalent of what is called a \selection\ in some other editors.
+ 
  Novice Emacs Lisp programmers often try to use the mark for the wrong
  purposes.  See the documentation of `set-mark' for more information.
(interactive P)


___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


RE: doc string for `yank' should mention paste

2006-03-12 Thread Drew Adams
Similarly, some basic operations on the region should
mention the term selection as being synonymous with
region. `M-x apropos-documentation
region', then search for `selection' finds nothing.

How about this?

+ Setting the mark also creates a \region\, which is the Emacs
+ equivalent of what is called a \selection\ in some other editors.

Perfect. Thanks.

(A detail: The region exists always. Setting the mark just redefines its
boundary; it doesn't really create a region. This is one difference in
terminology, which perhaps needs to be pointed out at some point, so people
will understand language like the region. Selecting text creates a
selection, and it redefines the region to be that selection (the selected
text).)



___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


Re: doc string for `yank' should mention paste

2006-03-12 Thread Eli Zaretskii
 From: Drew Adams [EMAIL PROTECTED]
 Date: Sun, 12 Mar 2006 17:51:49 -0800
 
 A detail: The region exists always.

No, it doesn't.  When a buffer is created, at first it has no mark, so
there's no region.  (Try e.g. C-x C-x in a freshly created buffer,
and you will see an error message saying there's no region.)  You must
set the mark once to define the region.


___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


Re: doc string for `yank' should mention paste

2006-03-07 Thread Kim F. Storm
Drew Adams [EMAIL PROTECTED] writes:

 The doc string for `yank' should mention the commonly understood
 paste operation as a (rough) synonym. Yanking is more than pasting,
 but at a first approximation they are the same thing. Users
 should be able to find `yank' when they do `M-x
 apropos-documentation paste'.

 Similarly, the doc for `kill-region' should mention cut and the doc for
 `kill-ring-save' should mention copy.

 We should provide a bridge between the vocabulary that many people are used
 to and the features and vocabulary of Emacs. We make this vocabulary effort
 in the Edit menu (but without bridging to the Emacs jargon); we should also
 do so in the doc strings of our basic commands that are similar to commands
 used in other apps.


Did you actually try to do M-x apropos RET paste RET ?

The apropos command has a list of aliases, e.g. paste = yank.

It works for apropos-documentation as well.
I
The list doesn't include selection = region, but I will add that.

-- 
Kim F. Storm [EMAIL PROTECTED] http://www.cua.dk



___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


RE: doc string for `yank' should mention paste

2006-03-07 Thread Drew Adams
The doc string for `yank' should mention the commonly understood
paste operation as a (rough) synonym. Yanking is more
than pasting,
but at a first approximation they are the same thing. Users
should be able to find `yank' when they do `M-x
apropos-documentation paste'.

Similarly, the doc for `kill-region' should mention cut and
the doc for `kill-ring-save' should mention copy.

We should provide a bridge between the vocabulary that many
people are used to and the features and vocabulary of Emacs. We
make this vocabulary effort in the Edit menu (but without
bridging to the Emacs jargon); we should also do so in the doc
strings of our basic commands that are similar to commands used
in other apps.

Similarly, some basic operations on the region should mention the term
selection as being synonymous with region. `M-x apropos-documentation
region', then search for `selection' finds nothing.

These are the only terms that really need bridging: region, kill, yank,
kill-ring-save. They are the ones pointed out in the jargon-translation
table at http://www.emacswiki.org/cgi-bin/wiki/CategoryGlossary. The others
there are frame and key-sequence, but I don't think it makes sense to bridge
those via doc strings.



___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


RE: doc string for `yank' should mention paste

2006-03-07 Thread Drew Adams
Did you actually try to do M-x apropos RET paste RET ?

Yes.

The apropos command has a list of aliases, e.g. paste = yank.

Yes, that is helpful.

It works for apropos-documentation as well.

But when you scan through the 1600-line *Apropos* buffer (for `apropos-doc
yank'), and you come to `yank', and you read its doc string, you do not see
the word `paste'. There is nothing that says that `yank' performs pasting
(in my 6/2005 snapshot on MS Windows, at least).

Finding it and showing it doesn't point out that this is it: command
`yank' is what you are used to calling `paste'.

The list doesn't include selection = region, but I will add that.

Thanks.



___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


Re: doc string for `yank' should mention paste

2006-03-07 Thread Richard Stallman
The doc string for `yank' should mention the commonly understood
paste operation as a (rough) synonym. Yanking is more than pasting,

Thanks.


___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


RE: doc string for `yank' should mention paste

2006-03-06 Thread Drew Adams
The doc string for `yank' should mention the commonly understood
paste operation as a (rough) synonym. Yanking is more than pasting,
but at a first approximation they are the same thing. Users
should be able to find `yank' when they do `M-x
apropos-documentation paste'.

Similarly, the doc for `kill-region' should mention cut and the doc for
`kill-ring-save' should mention copy.

We should provide a bridge between the vocabulary that many people are used
to and the features and vocabulary of Emacs. We make this vocabulary effort
in the Edit menu (but without bridging to the Emacs jargon); we should also
do so in the doc strings of our basic commands that are similar to commands
used in other apps.



___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug