Next: defvar and asterisk, Up: defvar [Contents][Index]
You can see the current value of a variable, any variable, by using the
describe-variable function, which is usually invoked by typing
C-h v. If you type C-h v and then kill-ring (followed by
RET) when prompted, you will see what is in your current kill
ring—this may be quite a lot! Conversely, if you have been doing nothing
this Emacs session except read this document, you may have nothing in it.
Also, you will see the documentation for kill-ring:
Documentation: List of killed text sequences. Since the kill ring is supposed to interact nicely with cut-and-paste facilities offered by window systems, use of this variable should
interact nicely with `interprogram-cut-function' and `interprogram-paste-function'. The functions `kill-new', `kill-append', and `current-kill' are supposed to implement this interaction; you may want to use them instead of manipulating the kill ring directly.
The kill ring is defined by a defvar in the following way:
(defvar kill-ring nil "List of killed text sequences. …")
In this variable definition, the variable is given an initial value of
nil, which makes sense, since if you have saved nothing, you want
nothing back if you give a yank command. The documentation string is
written just like the documentation string of a defun. As with the
documentation string of the defun, the first line of the
documentation should be a complete sentence, since some commands, like
apropos, print only the first line of documentation. Succeeding
lines should not be indented; otherwise they look odd when you use C-h
v (describe-variable).
Next: defvar and asterisk, Up: defvar [Contents][Index]