\input texinfo
@c %**start of header
-@setfilename ../../info/srecode
+@setfilename ../../info/srecode.info
@set TITLE SRecoder Manual
@set AUTHOR Eric M. Ludlam
@settitle @value{TITLE}
+@documentencoding UTF-8
@c Merge all indexes into a single index for now.
@c We can always separate them later into two or more as needed.
@c %**end of header
@copying
-Copyright @copyright{} 2007--2013 Free Software Foundation, Inc.
+Copyright @copyright{} 2007--2015 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.3 or
any later version published by the Free Software Foundation; with no
-Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
+Invariant Sections, 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 License''.
@dircategory Emacs misc features
@direntry
-* SRecode: (srecode). Template code generator.
+* SRecode: (srecode). Semantic template code generator.
@end direntry
@titlepage
@center @titlefont{SRecode}
@vskip 0pt plus 1 fill
@center by @value{AUTHOR}
+@page
+@vskip 0pt plus 1filll
+@insertcopying
@end titlepage
@macro semantic{}
Some arguments are major-mode specific, such as the @code{:el} or
@code{:cpp} arguments.
-@refill
@section Template Insertion Context
A context can be provided for templates in a file. This helps
A context can be automatically derived as well based on the parsing
state from @i{Semantic}. @inforef{Top, Semantic Manual, semantic}.
-@refill
@section Applications
Commands that do a particular user task which involves also writing
between editable fields in the template.
Once the cursor moves out of the are inserted by the template, all the
-fields are cancelled.
+fields are canceled.
@b{NOTE}: Some conveniences in templates, such as completion, or
character restrictions are lost when using field editing mode.
(if that section is not 'visible') or the section is shown one time
for each dictionary added to that symbol.
@xref{Developing Template Functions}.
-@refill
Macros prefixed with ``>'' will include another template. Include
macros would look like this:
@node Contexts
@section Context
-Each template belongs to a context. When promting for a template by
+Each template belongs to a context. When prompting for a template by
name, such as with @kbd{C-c / /}, the name is prefixed by the current
context. If there is no context, it defaults to @code{declaration}.
@subsubsection Argument :indent
-Supplies the @code{INDENT} macro. When @code{INDENT} is non-nil, then
+Supplies the @code{INDENT} macro. When @code{INDENT} is non-@code{nil}, then
each line is individually indented with
@code{indent-according-to-mode} during macro processing.
@code{mouse-drag-region}, then the @code{REGION} section will be
enabled.
-In addition, @code{REGIONTEXT} will be set the the text in the region,
+In addition, @code{REGIONTEXT} will be set to the text in the region,
and that region of text will be ``killed'' from the current buffer.
If standard-output is NOT the current buffer, then the region will not
@defun srecode-insert-fcn template dictionary &optional stream
@anchor{srecode-insert-fcn}
Insert @var{template} using @var{dictionary} into @var{stream}.
-If @var{stream} is nil, then use the current buffer.
+If @var{stream} is @code{nil}, then use the current buffer.
@end defun
@node Template Naming Conventions