comparison man/autotype.texi @ 88155:d7ddb3e565de

sync with trunk

88154:8ce476d3ba36

\input texinfo
@c This is an annex of the Emacs manual.
@c Copyright (C) 1994, 1995, 2002 Free Software Foundation, Inc.
@c Author: [e-mail], fax [phone]
@setfilename ../info/autotype
@c @node Autotypist, Picture, Abbrevs, Top
@c @chapter Features for Automatic Typing
@settitle Features for Automatic Typing
@c  @cindex text
@c  @cindex selfinserting text
@c  @cindex autotypist

@copying
Copyright @copyright{} 1994, 1995, 1999 Free Software Foundation, Inc.

@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation; with the
Invariant Sections being ``The GNU Manifesto'', ``Distribution'' and
``GNU GENERAL PUBLIC LICENSE'', with the Front-Cover texts being ``A GNU
Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
license is included in the section entitled ``GNU Free Documentation

define an abbreviation (@pxref{(emacs)Defining Abbrevs}) that will expand
(@pxref{(emacs)Expanding Abbrevs}) into the skeleton.

  Say you want @samp{ifst} to be an abbreviation for the C language if
statement.  You will tell Emacs that @samp{ifst} expands to the empty string
and then calls the skeleton command.  In Emacs-lisp you can say something like
@code{(define-abbrev c-mode-abbrev-table "ifst" "" 'c-if)}.  Or you can edit
the output from @kbd{M-x list-abbrevs} to make it look like this:

@example
(c-mode-abbrev-table)

return value resulting from the interactor.  Each subskeleton has its local
copy of this variable.
@item @code{v1}, @code{v2}
Skeleton-local user variables.
@item @code{'@var{expression}}
Evaluate following lisp expression for its side-effect, but prevent it from
being interpreted as a skeleton element.
@item @var{skeleton}
Subskeletons are inserted recursively, not once, but as often as the user
enters something at the subskeletons interactor.  Thus there must be a
@code{str} in the subskeleton.  They can also be used non-interactively, when

@findex define-auto-insert
  In Lisp (@pxref{(emacs)Init File}) you can use the function
@code{define-auto-insert} to add to or modify
@code{auto-insert-alist}.  See its documentation with @kbd{C-h f
auto-insert-alist}.

@vindex auto-insert
  The variable @code{auto-insert} says what to do when @code{auto-insert} is
called non-interactively, e.g. when a newly found file is empty (see above):
@table @asis

them when this is called with a prefix argument.  If a header referring to a
wrong version of the GNU General Public License (@pxref{(emacs)Copying}) is found,
that is updated too.

  An interesting application for this function is to have it be called
automatically every time a file is saved.  This is accomplished by putting
@code{(add-hook 'write-file-functions 'copyright-update)} into your @file{~/.emacs}
file (@pxref{(emacs)Init File}).

@vindex copyright-query
  The variable @code{copyright-query} controls whether to update the
copyright or whether to ask about it.  When this is @code{nil} updating is
only done with @kbd{M-x copyright-update}.  When this is @code{function}
you are queried whenever @code{copyright-update} is called as a function,
such as in the @code{write-file-functions} feature mentioned above.  Otherwise
you are always queried.



@node Executables

@node Timestamps
@chapter Maintaining Timestamps in Modified Files
@cindex timestamps

@findex time-stamp
@vindex write-file-functions
The @code{time-stamp} command can be used to update automatically a
template in a file with a new time stamp every time you save the file.
Customize the hook @code{write-file-functions} to add the function
@code{time-stamp} to arrange this.

@vindex time-stamp-active
@vindex time-stamp-format
@vindex time-stamp-start
The time stamp is updated only if the customizable variable

buffer at point.  Some can be simple strings, while others can control
formatting or define special points of interest in the inserted text.
@kbd{M-x tempo-backward-mark} and @kbd{M-x tempo-forward-mark} can be
used to jump between such points.

More flexible templates can be created by including lisp symbols, which
will be evaluated as variables, or lists, which will be evaluated
as lisp expressions.  Automatic completion of specified tags to expanded
templates can be provided.

@findex tempo-define-template
See the documentation for @code{tempo-define-template} for the different
items that can be used to define a tempo template with a command for

@printindex vr

@setchapternewpage odd
@contents
@bye

88155:d7ddb3e565de

\input texinfo
@c This is an annex of the Emacs manual.
@c Copyright (C) 1994, 1995, 2002, 2003, 2004,
@c   2005 Free Software Foundation, Inc.
@c Author: [e-mail], fax [phone]
@setfilename ../info/autotype
@c @node Autotypist, Picture, Abbrevs, Top
@c @chapter Features for Automatic Typing
@settitle Features for Automatic Typing
@c  @cindex text
@c  @cindex selfinserting text
@c  @cindex autotypist

@copying
Copyright @copyright{} 1994, 1995, 1999, 2002, 2003, 2004,
   2005 Free Software Foundation, Inc.

@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with the
Invariant Sections being ``The GNU Manifesto'', ``Distribution'' and
``GNU GENERAL PUBLIC LICENSE'', with the Front-Cover texts being ``A GNU
Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
license is included in the section entitled ``GNU Free Documentation

define an abbreviation (@pxref{(emacs)Defining Abbrevs}) that will expand
(@pxref{(emacs)Expanding Abbrevs}) into the skeleton.

  Say you want @samp{ifst} to be an abbreviation for the C language if
statement.  You will tell Emacs that @samp{ifst} expands to the empty string
and then calls the skeleton command.  In Emacs Lisp you can say something like
@code{(define-abbrev c-mode-abbrev-table "ifst" "" 'c-if)}.  Or you can edit
the output from @kbd{M-x list-abbrevs} to make it look like this:

@example
(c-mode-abbrev-table)

return value resulting from the interactor.  Each subskeleton has its local
copy of this variable.
@item @code{v1}, @code{v2}
Skeleton-local user variables.
@item @code{'@var{expression}}
Evaluate following Lisp expression for its side-effect, but prevent it from
being interpreted as a skeleton element.
@item @var{skeleton}
Subskeletons are inserted recursively, not once, but as often as the user
enters something at the subskeletons interactor.  Thus there must be a
@code{str} in the subskeleton.  They can also be used non-interactively, when

@findex define-auto-insert
  In Lisp (@pxref{(emacs)Init File}) you can use the function
@code{define-auto-insert} to add to or modify
@code{auto-insert-alist}.  See its documentation with @kbd{C-h f
define-auto-insert}.

@vindex auto-insert
  The variable @code{auto-insert} says what to do when @code{auto-insert} is
called non-interactively, e.g. when a newly found file is empty (see above):
@table @asis

them when this is called with a prefix argument.  If a header referring to a
wrong version of the GNU General Public License (@pxref{(emacs)Copying}) is found,
that is updated too.

  An interesting application for this function is to have it be called
automatically every time a file is saved.  This is accomplished by
putting @code{(add-hook 'before-save-hook 'copyright-update)} into
your @file{~/.emacs} file (@pxref{(emacs)Init File}).  Alternative,
you can do @kbd{M-x customize-variable @key{RET} before-save-hook
@key{RET}}.  @code{copyright-update} is conveniently listed as an
option in the customization buffer.

@vindex copyright-query
  The variable @code{copyright-query} controls whether to update the
copyright or whether to ask about it.  When this is @code{nil} updating is
only done with @kbd{M-x copyright-update}.  When this is @code{function}
you are queried whenever @code{copyright-update} is called as a function,
such as in the @code{before-save-hook} feature mentioned above.  Otherwise
you are always queried.



@node Executables

@node Timestamps
@chapter Maintaining Timestamps in Modified Files
@cindex timestamps

@findex time-stamp
@vindex before-save-hook
The @code{time-stamp} command can be used to update automatically a
template in a file with a new time stamp every time you save the file.
Customize the hook @code{before-save-hook} to add the function
@code{time-stamp} to arrange this.  It you use Custom to do this,
then @code{time-stamp} is conveniently listed as an option in the
customization buffer.

@vindex time-stamp-active
@vindex time-stamp-format
@vindex time-stamp-start
The time stamp is updated only if the customizable variable

buffer at point.  Some can be simple strings, while others can control
formatting or define special points of interest in the inserted text.
@kbd{M-x tempo-backward-mark} and @kbd{M-x tempo-forward-mark} can be
used to jump between such points.

More flexible templates can be created by including Lisp symbols, which
will be evaluated as variables, or lists, which will be evaluated
as Lisp expressions.  Automatic completion of specified tags to expanded
templates can be provided.

@findex tempo-define-template
See the documentation for @code{tempo-define-template} for the different
items that can be used to define a tempo template with a command for

@printindex vr

@setchapternewpage odd
@contents
@bye

@ignore
   arch-tag: 54001b27-5ef8-4a9d-a199-905d650fafba
@end ignore