diff options
| author | Stefan Monnier | 2002-02-12 19:33:46 +0000 |
|---|---|---|
| committer | Stefan Monnier | 2002-02-12 19:33:46 +0000 |
| commit | 89cda0c5e9df20e7caebd110891e93957c7e6b4a (patch) | |
| tree | 6360bb8a1d1c222c4ce0726f1e50b4421fdf4a2d | |
| parent | 9a770d8d3356a72a4b66b256cc629ea97951306c (diff) | |
| download | emacs-89cda0c5e9df20e7caebd110891e93957c7e6b4a.tar.gz emacs-89cda0c5e9df20e7caebd110891e93957c7e6b4a.zip | |
*** empty log message ***
| -rw-r--r-- | lispref/modes.texi | 30 | ||||
| -rw-r--r-- | lispref/variables.texi | 4 | ||||
| -rw-r--r-- | man/pcl-cvs.texi | 23 |
3 files changed, 23 insertions, 34 deletions
diff --git a/lispref/modes.texi b/lispref/modes.texi index 8a6978ebacf..299595341f8 100644 --- a/lispref/modes.texi +++ b/lispref/modes.texi | |||
| @@ -2206,8 +2206,9 @@ then the value is a list of functions, but it is abnormal in that either | |||
| 2206 | these functions are called with arguments or their values are used in | 2206 | these functions are called with arguments or their values are used in |
| 2207 | some way. You can use @code{add-hook} to add a function to the list, | 2207 | some way. You can use @code{add-hook} to add a function to the list, |
| 2208 | but you must take care in writing the function. (A few of these | 2208 | but you must take care in writing the function. (A few of these |
| 2209 | variables are actually normal hooks which were named before we | 2209 | variables, notably those ending in @samp{-hooks}, are actually |
| 2210 | established the convention of using @samp{-hook} for them.) | 2210 | normal hooks which were named before we established the convention of |
| 2211 | using @samp{-hook} for them.) | ||
| 2211 | 2212 | ||
| 2212 | If the variable's name ends in @samp{-function}, then its value | 2213 | If the variable's name ends in @samp{-function}, then its value |
| 2213 | is just a single function, not a list of functions. | 2214 | is just a single function, not a list of functions. |
| @@ -2290,9 +2291,8 @@ executed first (barring another @code{add-hook} call). If the optional | |||
| 2290 | argument @var{append} is non-@code{nil}, the new hook function goes at | 2291 | argument @var{append} is non-@code{nil}, the new hook function goes at |
| 2291 | the end of the hook list and will be executed last. | 2292 | the end of the hook list and will be executed last. |
| 2292 | 2293 | ||
| 2293 | If @var{local} is non-@code{nil}, that says to make the new hook | 2294 | If @var{local} is non-@code{nil}, that says to add @var{function} |
| 2294 | function buffer-local in the current buffer and automatically calls | 2295 | to the buffer-local hook list instead of to the global hook list. |
| 2295 | @code{make-local-hook} to make the hook itself buffer-local. | ||
| 2296 | @end defun | 2296 | @end defun |
| 2297 | 2297 | ||
| 2298 | @defun remove-hook hook function &optional local | 2298 | @defun remove-hook hook function &optional local |
| @@ -2300,24 +2300,4 @@ This function removes @var{function} from the hook variable @var{hook}. | |||
| 2300 | 2300 | ||
| 2301 | If @var{local} is non-@code{nil}, that says to remove @var{function} | 2301 | If @var{local} is non-@code{nil}, that says to remove @var{function} |
| 2302 | from the buffer-local hook list instead of from the global hook list. | 2302 | from the buffer-local hook list instead of from the global hook list. |
| 2303 | If the hook variable itself is not buffer-local, then the value of | ||
| 2304 | @var{local} makes no difference. | ||
| 2305 | @end defun | ||
| 2306 | |||
| 2307 | @defun make-local-hook hook | ||
| 2308 | This function makes the hook variable @code{hook} buffer-local in the | ||
| 2309 | current buffer. When a hook variable is buffer-local, it can have | ||
| 2310 | buffer-local and global hook functions, and @code{run-hooks} runs all of | ||
| 2311 | them. | ||
| 2312 | |||
| 2313 | This function works by adding @code{t} as an element of the buffer-local | ||
| 2314 | value. That serves as a flag to use the hook functions listed in the default | ||
| 2315 | value of the hook variable, as well as those listed in the buffer-local value. | ||
| 2316 | Since @code{run-hooks} understands this flag, @code{make-local-hook} | ||
| 2317 | works with all normal hooks. It works for only some non-normal | ||
| 2318 | hooks---those whose callers have been updated to understand this meaning | ||
| 2319 | of @code{t}. | ||
| 2320 | |||
| 2321 | Do not use @code{make-local-variable} directly for hook variables; it is | ||
| 2322 | not sufficient. | ||
| 2323 | @end defun | 2303 | @end defun |
diff --git a/lispref/variables.texi b/lispref/variables.texi index 5d19cbefd0e..df816f85b68 100644 --- a/lispref/variables.texi +++ b/lispref/variables.texi | |||
| @@ -1291,7 +1291,9 @@ variables cannot have buffer-local bindings as well. @xref{Multiple | |||
| 1291 | Displays}. | 1291 | Displays}. |
| 1292 | 1292 | ||
| 1293 | @strong{Note:} Do not use @code{make-local-variable} for a hook | 1293 | @strong{Note:} Do not use @code{make-local-variable} for a hook |
| 1294 | variable. Instead, use @code{make-local-hook}. @xref{Hooks}. | 1294 | variable. The hook variables are automatically made buffer-local |
| 1295 | as needed if you use the @var{local} argument to @code{add-hook} or | ||
| 1296 | @code{remove-hook}. | ||
| 1295 | @end deffn | 1297 | @end deffn |
| 1296 | 1298 | ||
| 1297 | @deffn Command make-variable-buffer-local variable | 1299 | @deffn Command make-variable-buffer-local variable |
diff --git a/man/pcl-cvs.texi b/man/pcl-cvs.texi index 6f53ac0fc2c..4acbd9331f0 100644 --- a/man/pcl-cvs.texi +++ b/man/pcl-cvs.texi | |||
| @@ -1,6 +1,6 @@ | |||
| 1 | \input texinfo @c -*-texinfo-*- | 1 | \input texinfo @c -*-texinfo-*- |
| 2 | 2 | ||
| 3 | @c "@(#)$Name: $:$Id: pcl-cvs.texi,v 1.11 2001/02/13 00:00:30 fx Exp $" | 3 | @c "@(#)$Name: $:$Id: pcl-cvs.texi,v 1.12 2001/02/23 12:50:41 gerd Exp $" |
| 4 | 4 | ||
| 5 | @c Documentation for the GNU Emacs CVS mode. | 5 | @c Documentation for the GNU Emacs CVS mode. |
| 6 | @c Copyright (C) 1991,92,93,94,95,96,97,98,99,2000, 2001 Free Software Foundation, Inc. | 6 | @c Copyright (C) 1991,92,93,94,95,96,97,98,99,2000, 2001 Free Software Foundation, Inc. |
| @@ -23,15 +23,17 @@ | |||
| 23 | 23 | ||
| 24 | @c %**start of header | 24 | @c %**start of header |
| 25 | @setfilename ../info/pcl-cvs | 25 | @setfilename ../info/pcl-cvs |
| 26 | @settitle PCL-CVS--Emacs Front-End to CVS | 26 | @settitle PCL-CVS -- Emacs Front-End to CVS |
| 27 | @c %**end of header | 27 | @c %**end of header |
| 28 | 28 | ||
| 29 | @c | ||
| 30 | |||
| 29 | @dircategory Emacs | 31 | @dircategory Emacs |
| 30 | @direntry | 32 | @direntry |
| 31 | * PCL-CVS: (pcl-cvs). Emacs front-end to CVS. | 33 | * PCL-CVS: (pcl-cvs). Emacs front-end to CVS. |
| 32 | @end direntry | 34 | @end direntry |
| 33 | @setchapternewpage on | 35 | @setchapternewpage on |
| 34 | 36 | ||
| 35 | @ifinfo | 37 | @ifinfo |
| 36 | Copyright @copyright{} 1991,92,93,94,95,96,97,98,99,2000 Free Software Foundation, Inc. | 38 | Copyright @copyright{} 1991,92,93,94,95,96,97,98,99,2000 Free Software Foundation, Inc. |
| 37 | 39 | ||
| @@ -777,6 +779,7 @@ This key moves one file backward, towards the beginning of the buffer | |||
| 777 | @kindex ESC DEL@r{--unmark all files} | 779 | @kindex ESC DEL@r{--unmark all files} |
| 778 | @kindex DEL@r{--unmark previous file} | 780 | @kindex DEL@r{--unmark previous file} |
| 779 | @kindex %@r{--mark files matching regexp} | 781 | @kindex %@r{--mark files matching regexp} |
| 782 | @kindex S@r{--mark files in a particular state} | ||
| 780 | @kindex T@r{--toggle marks} | 783 | @kindex T@r{--toggle marks} |
| 781 | @findex cvs-mode-mark | 784 | @findex cvs-mode-mark |
| 782 | @findex cvs-mode-unmark | 785 | @findex cvs-mode-unmark |
| @@ -784,6 +787,7 @@ This key moves one file backward, towards the beginning of the buffer | |||
| 784 | @findex cvs-mode-unmark-all-files | 787 | @findex cvs-mode-unmark-all-files |
| 785 | @findex cvs-mode-unmark-up | 788 | @findex cvs-mode-unmark-up |
| 786 | @findex cvs-mode-mark-matching-files | 789 | @findex cvs-mode-mark-matching-files |
| 790 | @findex cvs-mode-mark-on-state | ||
| 787 | @findex cvs-mode-toggle-marks | 791 | @findex cvs-mode-toggle-marks |
| 788 | 792 | ||
| 789 | PCL-CVS works on a set of @dfn{selected files} (@pxref{Selected files}). | 793 | PCL-CVS works on a set of @dfn{selected files} (@pxref{Selected files}). |
| @@ -810,11 +814,15 @@ Unmark @emph{all} files (@code{cvs-mode-unmark-all-files}). | |||
| 810 | Unmark the file on the previous line, and move point to that line | 814 | Unmark the file on the previous line, and move point to that line |
| 811 | (@code{cvs-mode-unmark-up}). | 815 | (@code{cvs-mode-unmark-up}). |
| 812 | 816 | ||
| 813 | @item @key{%} | 817 | @item % |
| 814 | Mark all files matching a regular expression | 818 | Mark all files matching a regular expression |
| 815 | (@code{cvs-mode-mark-matching-files}). | 819 | (@code{cvs-mode-mark-matching-files}). |
| 816 | 820 | ||
| 817 | @item @key{T} | 821 | @item S |
| 822 | Mark all files in a particular state, such as ``Modified'' or | ||
| 823 | ``Removed''. (@code{cvs-mode-mark-on-state}). | ||
| 824 | |||
| 825 | @item T | ||
| 818 | Toggle use of marks for the next command (@code{cvs-mode-toggle-marks}). | 826 | Toggle use of marks for the next command (@code{cvs-mode-toggle-marks}). |
| 819 | @end table | 827 | @end table |
| 820 | 828 | ||
| @@ -1435,8 +1443,7 @@ If you have ideas for improvements, or if you have written some | |||
| 1435 | extensions to this package, we would like to hear from you. We hope that | 1443 | extensions to this package, we would like to hear from you. We hope that |
| 1436 | you find this package useful! | 1444 | you find this package useful! |
| 1437 | 1445 | ||
| 1438 | Below is a partial list of currently known problems with PCL-CVS version | 1446 | Below is a partial list of currently known problems with PCL-CVS. |
| 1439 | 2.0. | ||
| 1440 | 1447 | ||
| 1441 | @table @asis | 1448 | @table @asis |
| 1442 | @item Unexpected output from CVS | 1449 | @item Unexpected output from CVS |
| @@ -1444,7 +1451,7 @@ Unexpected output from CVS may confuse PCL-CVS. It will create | |||
| 1444 | warning messages in the @samp{*cvs*} buffer alerting you to any parse errors. | 1451 | warning messages in the @samp{*cvs*} buffer alerting you to any parse errors. |
| 1445 | If you get these messages, please send a bug report to the email | 1452 | If you get these messages, please send a bug report to the email |
| 1446 | addresses listed above. Include the contents of the @samp{*cvs*} buffer, the | 1453 | addresses listed above. Include the contents of the @samp{*cvs*} buffer, the |
| 1447 | output of the CVS process (which should be found in the @samp{*cvs-tmp*} | 1454 | output of the CVS process (which should be found in the @samp{ *cvs-tmp*} |
| 1448 | buffer), and the versions of Emacs, PCL-CVS and CVS you are using. | 1455 | buffer), and the versions of Emacs, PCL-CVS and CVS you are using. |
| 1449 | @end table | 1456 | @end table |
| 1450 | 1457 | ||