[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: doc string for `yank' should mention "paste"

From: Drew Adams
Subject: RE: doc string for `yank' should mention "paste"
Date: Mon, 6 Mar 2006 16:09:12 -0800

        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.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]