Mercurial > emacs
annotate man/autotype.texi @ 77428:c1d43f2a6032
(EMACS): This change was reverted, so delete this entry.
author | Glenn Morris <rgm@gnu.org> |
---|---|
date | Sun, 22 Apr 2007 20:18:30 +0000 |
parents | 88224dc74061 |
children | 02b9a9aa5b0c e6fdae9180d4 |
rev | line source |
---|---|
26151 | 1 \input texinfo |
2 @c This is an annex of the Emacs manual. | |
75249
4ad431d8e164
Update copyright for years from Emacs 21 to present (mainly adding
Glenn Morris <rgm@gnu.org>
parents:
69681
diff
changeset
|
3 @c Copyright (C) 1994, 1995, 2001, 2002, 2003, 2004, |
4ad431d8e164
Update copyright for years from Emacs 21 to present (mainly adding
Glenn Morris <rgm@gnu.org>
parents:
69681
diff
changeset
|
4 @c 2005, 2006, 2007 Free Software Foundation, Inc. |
25848 | 5 @c Author: Daniel.Pfeiffer@Informatik.START.dbp.de, fax (+49 69) 7588-2389 |
26151 | 6 @setfilename ../info/autotype |
7 @c @node Autotypist, Picture, Abbrevs, Top | |
8 @c @chapter Features for Automatic Typing | |
9 @settitle Features for Automatic Typing | |
10 @c @cindex text | |
11 @c @cindex selfinserting text | |
12 @c @cindex autotypist | |
25848 | 13 |
47737
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
14 @copying |
75249
4ad431d8e164
Update copyright for years from Emacs 21 to present (mainly adding
Glenn Morris <rgm@gnu.org>
parents:
69681
diff
changeset
|
15 Copyright @copyright{} 1994, 1995, 1999, 2001, 2002, 2003, 2004, |
4ad431d8e164
Update copyright for years from Emacs 21 to present (mainly adding
Glenn Morris <rgm@gnu.org>
parents:
69681
diff
changeset
|
16 2005, 2006, 2007 Free Software Foundation, Inc. |
32315 | 17 |
47737
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
18 @quotation |
32315 | 19 Permission is granted to copy, distribute and/or modify this document |
65555
69b3598a61c5
Update all manuals to specify GFDL version 1.2.
Romain Francoise <romain@orebokech.com>
parents:
64890
diff
changeset
|
20 under the terms of the GNU Free Documentation License, Version 1.2 or |
32315 | 21 any later version published by the Free Software Foundation; with the |
22 Invariant Sections being ``The GNU Manifesto'', ``Distribution'' and | |
23 ``GNU GENERAL PUBLIC LICENSE'', with the Front-Cover texts being ``A GNU | |
24 Manual'', and with the Back-Cover Texts as in (a) below. A copy of the | |
25 license is included in the section entitled ``GNU Free Documentation | |
26 License'' in the Emacs manual. | |
26151 | 27 |
32315 | 28 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify |
29 this GNU Manual, like GNU software. Copies published by the Free | |
30 Software Foundation raise funds for GNU development.'' | |
31 | |
32 This document is part of a collection distributed under the GNU Free | |
33 Documentation License. If you want to distribute this document | |
34 separately from the collection, you can do so by adding a copy of the | |
35 license to the document, as described in section 6 of the license. | |
47737
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
36 @end quotation |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
37 @end copying |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
38 |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
39 @dircategory Emacs |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
40 @direntry |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
41 * Autotype: (autotype). Convenient features for text that you enter frequently |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
42 in Emacs. |
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
43 @end direntry |
26151 | 44 |
45 @titlepage | |
46 @sp 10 | |
47 | |
48 @center @titlefont{Autotyping} | |
49 @sp 2 | |
50 @center @subtitlefont{Convenient features for text that you enter | |
51 frequently in Emacs} | |
52 @sp 2 | |
53 @center Daniel Pfeiffer | |
54 @center additions by Dave Love | |
55 | |
56 @page | |
57 @vskip 0pt plus 1filll | |
47737
0a70200bde27
use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents:
46918
diff
changeset
|
58 @insertcopying |
26151 | 59 @end titlepage |
60 | |
61 @node Top | |
62 @top Autotyping | |
63 | |
25848 | 64 Under certain circumstances you will find yourself typing similar things |
65 over and over again. This is especially true of form letters and programming | |
66 language constructs. Project-specific header comments, flow-control | |
67 constructs or magic numbers are essentially the same every time. Emacs has | |
26151 | 68 various features for doing tedious and repetitive typing chores for you |
69 in addition to the Abbrev features (@pxref{(emacs)Abbrevs}). | |
25848 | 70 |
71 One solution is using skeletons, flexible rules that say what to | |
72 insert, and how to do it. Various programming language modes offer some | |
73 ready-to-use skeletons, and you can adapt them to suit your needs or | |
74 taste, or define new ones. | |
75 | |
76 Another feature is automatic insertion of what you want into empty files, | |
77 depending on the file-name or the mode as appropriate. You can have a file or | |
78 a skeleton inserted, or you can call a function. Then there is the | |
79 possibility to have Un*x interpreter scripts automatically take on a magic | |
80 number and be executable as soon as they are saved. Or you can have a | |
26151 | 81 copyright notice's year updated, if necessary, every time you save a |
82 file. Similarly for time stamps in the file. | |
83 | |
84 URLs can be inserted based on a word at point. Flexible templates can | |
85 be defined for inserting and navigating between text more generally. A | |
86 sort of meta-expansion facility can be used to try a set of alternative | |
87 completions and expansions of text at point. | |
25848 | 88 |
89 @menu | |
90 * Using Skeletons:: How to insert a skeleton into your text. | |
91 * Wrapping Skeletons:: Putting existing text within a skeleton. | |
92 * Skeletons as Abbrevs:: An alternative for issuing skeleton commands. | |
93 * Skeleton Language:: Making skeleton commands insert what you want. | |
26151 | 94 * Inserting Pairs:: Typing one character and getting another |
95 after point. | |
25848 | 96 * Autoinserting:: Filling up empty files as soon as you visit them. |
97 * Copyrights:: Inserting and updating copyrights. | |
98 * Executables:: Turning interpreter scripts into executables. | |
26151 | 99 * Timestamps:: Updating dates and times in modified files. |
100 * QuickURL:: Inserting URLs based on text at point. | |
101 * Tempo:: Flexible template insertion. | |
102 * Hippie Expand:: Expansion of text trying various methods. | |
103 | |
77235 | 104 * GNU Free Documentation License:: The license for this documentation. |
26151 | 105 * Concept Index:: |
106 * Command Index:: | |
107 * Variable Index:: | |
25848 | 108 @end menu |
109 | |
110 | |
111 | |
112 @node Using Skeletons | |
26151 | 113 @chapter Using Skeletons |
25848 | 114 @cindex skeletons |
115 @cindex using skeletons | |
116 | |
117 When you want Emacs to insert a form letter or a typical construct of the | |
118 programming language you are using, skeletons are a means of accomplishing | |
119 this. Normally skeletons each have a command of their own, that, when called, | |
120 will insert the skeleton. These commands can be issued in the usual ways | |
26463 | 121 (@pxref{(emacs)Commands}). Modes that offer various skeletons will often |
26151 | 122 bind these to key-sequences on the @kbd{C-c} prefix, as well as having |
123 an @cite{Insert} menu and maybe even predefined abbrevs for them | |
26463 | 124 (@pxref{Skeletons as Abbrevs}). |
25848 | 125 |
126 The simplest kind of skeleton will simply insert some text indented | |
127 according to the major mode and leave the cursor at a likely place in the | |
128 middle. Interactive skeletons may prompt you for a string that will be part | |
129 of the inserted text. | |
130 | |
131 Skeletons may ask for input several times. They even have a looping | |
132 mechanism in which you will be asked for input as long as you are willing to | |
133 furnish it. An example would be multiple ``else if'' conditions. You can | |
36506 | 134 recognize this situation by a prompt ending in @key{RET}, @kbd{C-g} |
135 or @kbd{C-h}. This | |
25848 | 136 means that entering an empty string will simply assume that you are finished. |
137 Typing quit on the other hand terminates the loop but also the rest of the | |
138 skeleton, e.g. an ``else'' clause is skipped. Only a syntactically necessary | |
139 termination still gets inserted. | |
140 | |
141 | |
142 | |
143 @node Wrapping Skeletons | |
26151 | 144 @chapter Wrapping Skeletons Around Existing Text |
25848 | 145 @cindex wrapping skeletons |
146 | |
147 Often you will find yourself with some code that for whatever reason | |
148 suddenly becomes conditional. Or you have written a bit of text and want to | |
149 put it in the middle of a form letter. Skeletons provide a means for | |
150 accomplishing this, and can even, in the case of programming languages, | |
151 reindent the wrapped code for you. | |
152 | |
153 Skeleton commands take an optional numeric prefix argument | |
26463 | 154 (@pxref{(emacs)Arguments}). This is interpreted in two different ways depending |
25848 | 155 on whether the prefix is positive, i.e. forwards oriented or negative, |
156 i.e. backwards oriented. | |
157 | |
26151 | 158 A positive prefix means to wrap the skeleton around that many |
159 following words. This is accomplished by putting the words there where | |
26463 | 160 the point is normally left after that skeleton is inserted (@pxref{Using |
161 Skeletons}). The point (@pxref{(emacs)Point}) is left at the next | |
26151 | 162 interesting spot in the skeleton instead. |
25848 | 163 |
164 A negative prefix means to do something similar with that many precedingly | |
26463 | 165 marked interregions (@pxref{(emacs)Mark}). In the simplest case, if you type |
25848 | 166 @kbd{M--} just before issuing the skeleton command, that will wrap the |
167 skeleton around the current region, just like a positive argument would have | |
168 wrapped it around a number of words. | |
169 | |
170 Smaller negative arguments will wrap that many interregions into successive | |
171 interesting spots within the skeleton, again leaving the point at the next one. | |
172 We speak about interregions rather than regions here, because we treat them in | |
173 the order they appear in the buffer, which coincides with successive regions | |
174 only if they were marked in order. | |
175 | |
176 That is, if you marked in alphabetical order the points A B C [] (where [] | |
177 represents the point) and call a skeleton command with @kbd{M-- 3}, you will | |
178 wrap the text from A to B into the first interesting spot of the skeleton, the | |
179 text from B to C into the next one, the text from C to the point into the | |
180 third one, and leave the point in the fourth one. If there are less marks in | |
181 the buffer, or if the skeleton defines less interesting points, the surplus is | |
182 ignored. | |
183 | |
184 If, on the other hand, you marked in alphabetical order the points [] A C B, | |
185 and call a skeleton command with @kbd{M-- 3}, you will wrap the text from | |
186 point to A, then the text from A to C and finally the text from C to B. This | |
187 is done because the regions overlap and Emacs would be helplessly lost if it | |
188 tried to follow the order in which you marked these points. | |
189 | |
190 | |
191 | |
192 @node Skeletons as Abbrevs | |
26151 | 193 @chapter Skeletons as Abbrev Expansions |
25848 | 194 @cindex skeletons as abbrevs |
195 | |
39268 | 196 Rather than use a key binding for every skeleton command, you can also |
26463 | 197 define an abbreviation (@pxref{(emacs)Defining Abbrevs}) that will expand |
198 (@pxref{(emacs)Expanding Abbrevs}) into the skeleton. | |
25848 | 199 |
200 Say you want @samp{ifst} to be an abbreviation for the C language if | |
201 statement. You will tell Emacs that @samp{ifst} expands to the empty string | |
55201 | 202 and then calls the skeleton command. In Emacs Lisp you can say something like |
25848 | 203 @code{(define-abbrev c-mode-abbrev-table "ifst" "" 'c-if)}. Or you can edit |
204 the output from @kbd{M-x list-abbrevs} to make it look like this: | |
205 | |
206 @example | |
207 (c-mode-abbrev-table) | |
208 "if" 0 "" c-if | |
209 @end example | |
210 | |
211 @noindent | |
212 (Some blank lines of no semantic significance, and other abbrev tables, | |
213 have been omitted.) | |
214 | |
215 | |
216 | |
217 @node Skeleton Language | |
26151 | 218 @chapter Skeleton Language |
25848 | 219 @cindex skeleton language |
220 | |
221 @findex skeleton-insert | |
222 Skeletons are an shorthand extension to the Lisp language, where various | |
223 atoms directly perform either actions on the current buffer or rudimentary | |
224 flow control mechanisms. Skeletons are interpreted by the function | |
225 @code{skeleton-insert}. | |
226 | |
227 A skeleton is a list starting with an interactor, which is usually a | |
228 prompt-string, or @code{nil} when not needed, but can also be a Lisp | |
229 expression for complex read functions or for returning some calculated value. | |
230 The rest of the list are any number of elements as described in the following | |
231 table: | |
232 | |
36506 | 233 @table @asis |
234 @item @code{"@var{string}"}, @code{?@var{c}}, @code{?\@var{c}} | |
25848 | 235 @vindex skeleton-transformation |
236 Insert string or character. Literal strings and characters are passed through | |
237 @code{skeleton-transformation} when that is non-@code{nil}. | |
36506 | 238 @item @code{?\n} |
239 @c ??? something seems very wrong here. | |
25848 | 240 Insert a newline and align under current line. Use newline character |
241 @code{?\n} to prevent alignment. | |
36506 | 242 @item @code{_} |
25848 | 243 Interesting point. When wrapping skeletons around successive regions, they are |
244 put at these places. Point is left at first @code{_} where nothing is wrapped. | |
36506 | 245 @item @code{>} |
25848 | 246 Indent line according to major mode. When following element is @code{_}, and |
247 there is a interregion that will be wrapped here, indent that interregion. | |
36506 | 248 @item @code{&} |
25848 | 249 Logical and. Iff preceding element moved point, i.e. usually inserted |
250 something, do following element. | |
36506 | 251 @item @code{|} |
25848 | 252 Logical xor. Iff preceding element didn't move point, i.e. usually inserted |
253 nothing, do following element. | |
36506 | 254 @item @code{-@var{number}} |
25848 | 255 Delete preceding number characters. Depends on value of |
256 @code{skeleton-untabify}. | |
36506 | 257 @item @code{()} or @code{nil} |
25848 | 258 Ignored. |
36506 | 259 @item @var{lisp-expression} |
25848 | 260 Evaluated, and the return value is again interpreted as a skeleton element. |
36506 | 261 @item @code{str} |
25848 | 262 A special variable that, when evaluated the first time, usually prompts |
263 for input according to the skeleton's interactor. It is then set to the | |
264 return value resulting from the interactor. Each subskeleton has its local | |
265 copy of this variable. | |
36506 | 266 @item @code{v1}, @code{v2} |
25848 | 267 Skeleton-local user variables. |
36506 | 268 @item @code{'@var{expression}} |
55201 | 269 Evaluate following Lisp expression for its side-effect, but prevent it from |
25848 | 270 being interpreted as a skeleton element. |
36506 | 271 @item @var{skeleton} |
25848 | 272 Subskeletons are inserted recursively, not once, but as often as the user |
273 enters something at the subskeletons interactor. Thus there must be a | |
274 @code{str} in the subskeleton. They can also be used non-interactively, when | |
275 prompt is a lisp-expression that returns successive list-elements. | |
36506 | 276 @item @code{resume:} |
277 Ignored. Execution resumes here if the user quits during skeleton | |
25848 | 278 interpretation. |
36506 | 279 @item @code{quit} |
25848 | 280 A constant which is non-@code{nil} when the @code{resume:} section was entered |
281 because the user quit. | |
282 @end table | |
283 | |
284 @findex skeleton-further-elements | |
285 Some modes also use other skeleton elements they themselves defined. For | |
286 example in shell script mode's skeletons you will find @code{<} which does a | |
36506 | 287 rigid indentation backwards, or in CC mode's skeletons you find the |
25848 | 288 self-inserting elements @code{@{} and @code{@}}. These are defined by the |
289 buffer-local variable @code{skeleton-further-elements} which is a list of | |
290 variables bound while interpreting a skeleton. | |
291 | |
292 @findex define-skeleton | |
293 The macro @code{define-skeleton} defines a command for interpreting a | |
294 skeleton. The first argument is the command name, the second is a | |
295 documentation string, and the rest is an interactor and any number of skeleton | |
296 elements together forming a skeleton. This skeleton is assigned to a variable | |
297 of the same name as the command and can thus be overridden from your | |
26463 | 298 @file{~/.emacs} file (@pxref{(emacs)Init File}). |
25848 | 299 |
300 | |
301 | |
302 @node Inserting Pairs | |
26151 | 303 @chapter Inserting Matching Pairs of Characters |
25848 | 304 @cindex inserting pairs |
305 @cindex pairs | |
306 | |
307 Various characters usually appear in pairs. When, for example, you insert | |
308 an open parenthesis, no matter whether you are programming or writing prose, | |
309 you will surely enter a closing one later. By entering both at the same time | |
310 and leaving the cursor inbetween, Emacs can guarantee you that such | |
311 parentheses are always balanced. And if you have a non-qwerty keyboard, where | |
312 typing some of the stranger programming language symbols makes you bend your | |
313 fingers backwards, this can be quite relieving too. | |
314 | |
29480
3f09d2029838
(Inserting Pairs): Add the missing `skeleton-' prefix to vars and funs.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26463
diff
changeset
|
315 @findex skeleton-pair-insert-maybe |
3f09d2029838
(Inserting Pairs): Add the missing `skeleton-' prefix to vars and funs.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26463
diff
changeset
|
316 @vindex skeleton-pair |
36506 | 317 This is done by binding the first key (@pxref{(emacs)Rebinding}) of |
318 the pair to @code{skeleton-pair-insert-maybe} instead of | |
319 @code{self-insert-command}. The ``maybe'' comes from the fact that | |
38017
32f10000ac35
Don't use the British spelling of "behaviour".
Eli Zaretskii <eliz@gnu.org>
parents:
36506
diff
changeset
|
320 this at-first surprising behavior is initially turned off. To enable |
36506 | 321 it, you must set @code{skeleton-pair} to some non-@code{nil} value. |
322 And even then, a positive argument (@pxref{(emacs)Arguments}) will | |
323 make this key behave like a self-inserting key | |
324 (@pxref{(emacs)Inserting Text}). | |
25848 | 325 |
29480
3f09d2029838
(Inserting Pairs): Add the missing `skeleton-' prefix to vars and funs.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26463
diff
changeset
|
326 @vindex skeleton-pair-on-word |
25848 | 327 While this breaks with the stated intention of always balancing pairs, it |
328 turns out that one often doesn't want pairing to occur, when the following | |
329 character is part of a word. If you want pairing to occur even then, set | |
29480
3f09d2029838
(Inserting Pairs): Add the missing `skeleton-' prefix to vars and funs.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26463
diff
changeset
|
330 @code{skeleton-pair-on-word} to some non-@code{nil} value. |
25848 | 331 |
29480
3f09d2029838
(Inserting Pairs): Add the missing `skeleton-' prefix to vars and funs.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
26463
diff
changeset
|
332 @vindex skeleton-pair-alist |
36506 | 333 Pairing is possible for all visible characters. By default the |
334 parenthesis @samp{(}, the square bracket @samp{[}, the brace | |
335 @samp{@{}, the pointed bracket @samp{<} and the backquote @samp{`} all | |
336 pair with the symmetrical character. All other characters pair | |
38017
32f10000ac35
Don't use the British spelling of "behaviour".
Eli Zaretskii <eliz@gnu.org>
parents:
36506
diff
changeset
|
337 themselves. This behavior can be modified by the variable |
36506 | 338 @code{skeleton-pair-alist}. This is in fact an alist of skeletons |
339 (@pxref{Skeleton Language}), with the first part of each sublist | |
340 matching the typed character. This is the position of the interactor, | |
341 but since pairs don't need the @code{str} element, this is ignored. | |
25848 | 342 |
36506 | 343 Some modes have bound the command @code{skeleton-pair-insert-maybe} |
344 to relevant keys. These modes also configure the pairs as | |
345 appropriate. For example, when typing english prose, you'd expect the | |
346 backquote (@samp{`}) to pair with the quote (@samp{'}), while in Shell | |
347 script mode it must pair to itself. They can also inhibit pairing in | |
348 certain contexts. For example an escaped character stands for itself. | |
25848 | 349 |
350 | |
351 | |
352 @node Autoinserting | |
26151 | 353 @chapter Autoinserting Text in Empty Files |
25848 | 354 @cindex autoinserting |
355 | |
356 @findex auto-insert | |
357 @kbd{M-x auto-insert} will put some predefined text at the beginning of | |
358 the buffer. The main application for this function, as its name suggests, | |
359 is to have it be called automatically every time an empty, and only an | |
360 empty file is visited. This is accomplished by putting @code{(add-hook | |
45979
87962bf716e3
*** empty log message ***
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
39268
diff
changeset
|
361 'find-file-hook 'auto-insert)} into your @file{~/.emacs} file |
26463 | 362 (@pxref{(emacs)Init File}). |
25848 | 363 |
364 @vindex auto-insert-alist | |
365 What gets inserted, if anything, is determined by the variable | |
36506 | 366 @code{auto-insert-alist}. The @sc{car}s of this list are each either |
367 a mode name, making an element applicable when a buffer is in that | |
368 mode. Or they can be a string, which is a regexp matched against the | |
369 buffer's file name. In that way different kinds of files that have | |
370 the same mode in Emacs can be distinguished. The @sc{car}s may also | |
371 be cons cells consisting of mode name or regexp as above and an | |
372 additional descriptive string. | |
25848 | 373 |
36506 | 374 When a matching element is found, the @sc{cdr} says what to do. It may |
25848 | 375 be a string, which is a file name, whose contents are to be inserted, if |
376 that file is found in the directory @code{auto-insert-directory} or under a | |
26463 | 377 absolute file name. Or it can be a skeleton (@pxref{Skeleton Language}) to |
25848 | 378 be inserted. |
379 | |
380 It can also be a function, which allows doing various things. The function | |
26463 | 381 can simply insert some text, indeed, it can be skeleton command (@pxref{Using |
25848 | 382 Skeletons}). It can be a lambda function which will for example conditionally |
383 call another function. Or it can even reset the mode for the buffer. If you | |
384 want to perform several such actions in order, you use a vector, i.e. several | |
36506 | 385 of the above elements between square brackets (@samp{[@r{@dots{}}]}). |
25848 | 386 |
387 By default C and C++ headers insert a definition of a symbol derived from | |
388 the filename to prevent multiple inclusions. C and C++ sources insert an | |
389 include of the header. Makefiles insert the file makefile.inc if it exists. | |
390 | |
391 TeX and bibTeX mode files insert the file tex-insert.tex if it exists, while | |
36330
a16d8ed56e9c
(Autoinserting): Remove doubled `insert'.
Gerd Moellmann <gerd@gnu.org>
parents:
32315
diff
changeset
|
392 LaTeX mode files insert a typical @code{\documentclass} frame. Html |
25848 | 393 files insert a skeleton with the usual frame. |
394 | |
36506 | 395 Ada mode files call the Ada header skeleton command. Emacs lisp |
396 source files insert the usual header, with a copyright of your | |
397 environment variable @env{$ORGANIZATION} or else the FSF, and prompt | |
398 for valid keywords describing the contents. Files in a @file{bin} | |
46918
82d113655734
Minor spelling and grammar corrections.
Paul Eggert <eggert@twinsun.com>
parents:
45979
diff
changeset
|
399 directory for which Emacs could determine no specialized mode |
36506 | 400 (@pxref{(emacs)Choosing Modes}) are set to Shell script mode. |
25848 | 401 |
402 @findex define-auto-insert | |
36506 | 403 In Lisp (@pxref{(emacs)Init File}) you can use the function |
404 @code{define-auto-insert} to add to or modify | |
405 @code{auto-insert-alist}. See its documentation with @kbd{C-h f | |
59588
5ff790f43164
(Autoinserting): Fix small error.
Richard M. Stallman <rms@gnu.org>
parents:
56097
diff
changeset
|
406 define-auto-insert}. |
25848 | 407 |
408 @vindex auto-insert | |
409 The variable @code{auto-insert} says what to do when @code{auto-insert} is | |
410 called non-interactively, e.g. when a newly found file is empty (see above): | |
36506 | 411 @table @asis |
412 @item @code{nil} | |
25848 | 413 Do nothing. |
36506 | 414 @item @code{t} |
25848 | 415 Insert something if possible, i.e. there is a matching entry in |
416 @code{auto-insert-alist}. | |
417 @item other | |
418 Insert something if possible, but mark as unmodified. | |
419 @end table | |
420 | |
421 @vindex auto-insert-query | |
422 The variable @code{auto-insert-query} controls whether to ask about | |
36506 | 423 inserting something. When this is @code{nil}, inserting is only done with |
424 @kbd{M-x auto-insert}. When this is @code{function}, you are queried | |
25848 | 425 whenever @code{auto-insert} is called as a function, such as when Emacs |
426 visits an empty file and you have set the above-mentioned hook. Otherwise | |
427 you are alway queried. | |
428 | |
429 @vindex auto-insert-prompt | |
430 When querying, the variable @code{auto-insert-prompt}'s value is used as a | |
36506 | 431 prompt for a y-or-n-type question. If this includes a @samp{%s} construct, |
25848 | 432 that is replaced by what caused the insertion rule to be chosen. This is |
433 either a descriptive text, the mode-name of the buffer or the regular | |
434 expression that matched the filename. | |
435 | |
436 | |
437 | |
438 @node Copyrights | |
26151 | 439 @chapter Inserting and Updating Copyrights |
25848 | 440 @cindex copyrights |
441 | |
442 @findex copyright | |
443 @kbd{M-x copyright} is a skeleton inserting command, that adds a copyright | |
444 notice at the point. The ``by'' part is taken from your environment variable | |
36506 | 445 @env{$ORGANIZATION} or if that isn't set you are prompted for it. If the |
26463 | 446 buffer has a comment syntax (@pxref{(emacs)Comments}), this is inserted as a comment. |
25848 | 447 |
448 @findex copyright-update | |
449 @vindex copyright-limit | |
450 @vindex copyright-current-year | |
451 @kbd{M-x copyright-update} looks for a copyright notice in the first | |
452 @code{copyright-limit} characters of the buffer and updates it when necessary. | |
453 The current year (variable @code{copyright-current-year}) is added to the | |
454 existing ones, in the same format as the preceding year, i.e. 1994, '94 or 94. | |
455 If a dash-separated year list up to last year is found, that is extended to | |
456 current year, else the year is added separated by a comma. Or it replaces | |
457 them when this is called with a prefix argument. If a header referring to a | |
26463 | 458 wrong version of the GNU General Public License (@pxref{(emacs)Copying}) is found, |
25848 | 459 that is updated too. |
460 | |
461 An interesting application for this function is to have it be called | |
56097
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
462 automatically every time a file is saved. This is accomplished by |
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
463 putting @code{(add-hook 'before-save-hook 'copyright-update)} into |
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
464 your @file{~/.emacs} file (@pxref{(emacs)Init File}). Alternative, |
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
465 you can do @kbd{M-x customize-variable @key{RET} before-save-hook |
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
466 @key{RET}}. @code{copyright-update} is conveniently listed as an |
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
467 option in the customization buffer. |
25848 | 468 |
469 @vindex copyright-query | |
470 The variable @code{copyright-query} controls whether to update the | |
471 copyright or whether to ask about it. When this is @code{nil} updating is | |
36506 | 472 only done with @kbd{M-x copyright-update}. When this is @code{function} |
25848 | 473 you are queried whenever @code{copyright-update} is called as a function, |
56097
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
474 such as in the @code{before-save-hook} feature mentioned above. Otherwise |
25848 | 475 you are always queried. |
476 | |
477 | |
478 | |
479 @node Executables | |
26151 | 480 @chapter Making Interpreter Scripts Executable |
25848 | 481 @cindex executables |
482 | |
483 @vindex executable-prefix | |
484 @vindex executable-chmod | |
36506 | 485 Various interpreter modes such as Shell script mode or AWK mode will |
486 automatically insert or update the buffer's magic number, a special | |
487 comment on the first line that makes the @code{exec} systemcall know | |
488 how to execute the script. To this end the script is automatically | |
489 made executable upon saving, with @code{executable-chmod} as argument | |
490 to the system @code{chmod} command. The magic number is prefixed by | |
491 the value of @code{executable-prefix}. | |
25848 | 492 |
493 @vindex executable-magicless-file-regexp | |
26151 | 494 Any file whose name matches @code{executable-magicless-file-regexp} is not |
25848 | 495 furnished with a magic number, nor is it made executable. This is mainly |
496 intended for resource files, which are only meant to be read in. | |
497 | |
498 @vindex executable-insert | |
499 The variable @code{executable-insert} says what to do when | |
500 @code{executable-set-magic} is called non-interactively, e.g. when file has no | |
501 or the wrong magic number: | |
36506 | 502 @table @asis |
503 @item @code{nil} | |
25848 | 504 Do nothing. |
36506 | 505 @item @code{t} |
25848 | 506 Insert or update magic number. |
507 @item other | |
508 Insert or update magic number, but mark as unmodified. | |
509 @end table | |
510 | |
511 @findex executable-set-magic | |
512 @vindex executable-query | |
513 The variable @code{executable-query} controls whether to ask about | |
514 inserting or updating the magic number. When this is @code{nil} updating | |
515 is only done with @kbd{M-x executable-set-magic}. When this is | |
36506 | 516 @code{function} you are queried whenever @code{executable-set-magic} is |
25848 | 517 called as a function, such as when Emacs puts a buffer in Shell script |
518 mode. Otherwise you are alway queried. | |
519 | |
520 @findex executable-self-display | |
521 @kbd{M-x executable-self-display} adds a magic number to the buffer, which | |
522 will turn it into a self displaying text file, when called as a Un*x command. | |
523 The ``interpreter'' used is @code{executable-self-display} with argument | |
36506 | 524 @samp{+2}. |
26151 | 525 |
526 @node Timestamps | |
527 @chapter Maintaining Timestamps in Modified Files | |
528 @cindex timestamps | |
529 | |
530 @findex time-stamp | |
56097
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
531 @vindex before-save-hook |
26151 | 532 The @code{time-stamp} command can be used to update automatically a |
533 template in a file with a new time stamp every time you save the file. | |
56097
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
534 Customize the hook @code{before-save-hook} to add the function |
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
535 @code{time-stamp} to arrange this. It you use Custom to do this, |
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
536 then @code{time-stamp} is conveniently listed as an option in the |
b5382c383798
(Copyrights, Timestamps): Recommend `before-save-hook' instead of
Luc Teirlinck <teirllm@auburn.edu>
parents:
55201
diff
changeset
|
537 customization buffer. |
26151 | 538 |
539 @vindex time-stamp-active | |
540 @vindex time-stamp-format | |
541 @vindex time-stamp-start | |
542 The time stamp is updated only if the customizable variable | |
543 @code{time-stamp-active} is on, which it is by default; the command | |
544 @code{time-stamp-toggle-active} can be used to toggle it. The format of | |
545 the time stamp is set by the customizable variable | |
546 @code{time-stamp-format}. | |
547 | |
548 @vindex time-stamp-line-limit | |
549 @vindex time-stamp-end | |
550 @vindex time-stamp-count | |
551 @vindex time-stamp-inserts-lines | |
552 The variables @code{time-stamp-line-limit}, @code{time-stamp-start}, | |
553 @code{time-stamp-end}, @code{time-stamp-count}, and | |
554 @code{time-stamp-inserts-lines} control finding the template. Do not | |
555 change these in your init file or you will be incompatible with other | |
556 people's files. If you must change them, do so only in the local | |
557 variables section of the file itself. | |
558 | |
559 Normally the template must appear in the first 8 lines of a file and | |
560 look like one of the following: | |
561 | |
562 @example | |
563 Time-stamp: <> | |
564 Time-stamp: " " | |
565 @end example | |
566 | |
567 The time stamp is written between the brackets or quotes: | |
568 | |
569 @example | |
570 Time-stamp: <1998-02-18 10:20:51 gildea> | |
571 @end example | |
572 | |
573 @node QuickURL | |
574 @chapter QuickURL: Inserting URLs Based on Text at Point | |
575 | |
576 @vindex quickurl-url-file | |
577 @findex quickurl | |
578 @cindex URLs | |
579 @kbd{M-x quickurl} can be used to insert a URL into a buffer based on | |
580 the text at point. The URLs are stored in an external file defined by | |
581 the variable @code{quickurl-url-file} as a list of either cons cells of | |
582 the form @code{(@var{key} . @var{URL})} or | |
583 lists of the form @code{(@var{key} @var{URL} @var{comment})}. These | |
584 specify that @kbd{M-x quickurl} should insert @var{URL} if the word | |
585 @var{key} is at point, for example: | |
586 | |
587 @example | |
588 (("FSF" "http://www.fsf.org/" "The Free Software Foundation") | |
589 ("emacs" . "http://www.emacs.org/") | |
590 ("hagbard" "http://www.hagbard.demon.co.uk" "Hagbard's World")) | |
591 @end example | |
592 | |
593 @findex quickurl-add-url | |
594 @findex quickurl-list | |
595 @kbd{M-x quickurl-add-url} can be used to add a new @var{key}/@var{URL} | |
596 pair. @kbd{M-x quickurl-list} provides interactive editing of the URL | |
597 list. | |
598 | |
599 @node Tempo | |
600 @chapter Tempo: Flexible Template Insertion | |
601 | |
602 @cindex templates | |
603 The Tempo package provides a simple way to define powerful templates, or | |
604 macros, if you wish. It is mainly intended for, but not limited to, | |
30870 | 605 programmers to be used for creating shortcuts for editing |
26151 | 606 certain kinds of documents. |
607 | |
608 @findex tempo-backward-mark | |
609 @findex tempo-forward-mark | |
610 A template is defined as a list of items to be inserted in the current | |
611 buffer at point. Some can be simple strings, while others can control | |
612 formatting or define special points of interest in the inserted text. | |
613 @kbd{M-x tempo-backward-mark} and @kbd{M-x tempo-forward-mark} can be | |
614 used to jump between such points. | |
615 | |
55201 | 616 More flexible templates can be created by including Lisp symbols, which |
36330
a16d8ed56e9c
(Autoinserting): Remove doubled `insert'.
Gerd Moellmann <gerd@gnu.org>
parents:
32315
diff
changeset
|
617 will be evaluated as variables, or lists, which will be evaluated |
55201 | 618 as Lisp expressions. Automatic completion of specified tags to expanded |
26151 | 619 templates can be provided. |
620 | |
621 @findex tempo-define-template | |
622 See the documentation for @code{tempo-define-template} for the different | |
623 items that can be used to define a tempo template with a command for | |
624 inserting it. | |
625 | |
626 See the commentary in @file{tempo.el} for more information on using the | |
627 Tempo package. | |
628 | |
629 @node Hippie Expand | |
630 @chapter `Hippie' Expansion | |
631 | |
632 @findex hippie-expand | |
633 @kindex M-/ | |
634 @vindex hippie-expand-try-functions-list | |
635 @kbd{M-x hippie-expand} is a single command providing a variety of | |
636 completions and expansions. Called repeatedly, it tries all possible | |
637 completions in succession. | |
638 | |
639 Which ones to try, and in which order, is determined by the contents of | |
640 the customizable option @code{hippie-expand-try-functions-list}. Much | |
38017
32f10000ac35
Don't use the British spelling of "behaviour".
Eli Zaretskii <eliz@gnu.org>
parents:
36506
diff
changeset
|
641 customization of the expansion behavior can be made by changing the |
26151 | 642 order of, removing, or inserting new functions in this list. Given a |
643 positive numeric argument, @kbd{M-x hippie-expand} jumps directly that | |
644 number of functions forward in this list. Given some other argument (a | |
645 negative argument or just @kbd{C-u}) it undoes the tried completion. | |
646 | |
647 See the commentary in @file{hippie-exp.el} for more information on the | |
648 possibilities. | |
649 | |
650 Typically you would bind @code{hippie-expand} to @kbd{M-/} with | |
651 @code{dabbrev-expand}, the standard binding of @kbd{M-/}, providing one | |
652 of the expansion possibilities. | |
653 | |
77235 | 654 @node GNU Free Documentation License |
655 @appendix GNU Free Documentation License | |
656 @include doclicense.texi | |
26151 | 657 |
658 @node Concept Index | |
659 @unnumbered Concept Index | |
660 @printindex cp | |
661 | |
662 @node Command Index | |
663 @unnumbered Command Index | |
664 @printindex fn | |
665 | |
666 @node Variable Index | |
667 @unnumbered Variable Index | |
668 @printindex vr | |
669 | |
29713 | 670 @setchapternewpage odd |
26151 | 671 @contents |
672 @bye | |
52401 | 673 |
674 @ignore | |
675 arch-tag: 54001b27-5ef8-4a9d-a199-905d650fafba | |
676 @end ignore |