(x-select-text): Add a doc string.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 50f1d503ac87671467c13e028ffb3e577c596675..43a62f824b72177557ddc1b7088ebfcf212a56fb 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,19 @@
+2009-07-24  Eli Zaretskii  <eliz@gnu.org>
+
+       * term/pc-win.el (x-select-text): Add a doc string.
+
+       * select.el (x-set-selection): Doc fix.
+
+       * w32-fns.el (x-get-selection, x-set-selection): Add doc strings.
+
+       * term/ns-win.el (x-colors): Doc fix.
+
+       * term/common-win.el (x-colors): Doc fix.
+
+       * term/x-win.el (x-select-enable-clipboard): Doc fix.
+
+       * term/pc-win.el (x-select-enable-clipboard, x-colors): Doc fix.
+
 2009-07-24  Kenichi Handa  <handa@m17n.org>
 
        * international/characters.el: Fix setting of category ?C, ?|, ?K,

diff --git a/lisp/term/pc-win.el b/lisp/term/pc-win.el
index 39bf5f1725410bddf1fd962993bc0c6d2ffb6e78..6e295c63d4abbb8c1108c76724bb87d6ae9c6605 100644 (file)
--- a/lisp/term/pc-win.el
+++ b/lisp/term/pc-win.el
@@ -210,6 +210,19 @@ set by Emacs is not accessible to other programs on Windows.\)"
   :group 'killing)
 
 (defun x-select-text (text &optional push)
+  "Select TEXT, a string, according to the window system.
+
+On X, put TEXT in the primary X selection.  For backward
+compatibility with older X applications, set the value of X cut
+buffer 0 as well, and if the optional argument PUSH is non-nil,
+rotate the cut buffers.  If `x-select-enable-clipboard' is
+non-nil, copy the text to the X clipboard as well.
+
+On Windows, make TEXT the current selection.  If
+`x-select-enable-clipboard' is non-nil, copy the text to the
+clipboard as well.  The argument PUSH is ignored.
+
+On Nextstep, put TEXT in the pasteboard; PUSH is ignored."
   (if x-select-enable-clipboard
       (w16-set-clipboard-data text))
   (setq x-last-selected-text text))