Commit 76f1a3c3 authored by Glenn Morris's avatar Glenn Morris

Remove remaining @refills from doc/*/*.texi files

parent bc4aaa31
2013-10-23 Glenn Morris <rgm@gnu.org>
* files.texi, glossary.texi, killing.texi, search.texi, sending.texi:
Nuke @refill.
* Makefile.in (install-dvi, install-html, install-pdf)
(install-ps, uninstall-dvi, uninstall-html, uninstall-ps)
(uninstall-pdf): Quote entities that might contain whitespace.
......
......@@ -1089,7 +1089,7 @@ of data with the command @kbd{M-x recover-file @key{RET} @var{file}
restores the contents from its auto-save file @file{#@var{file}#}.
You can then save with @kbd{C-x C-s} to put the recovered text into
@var{file} itself. For example, to recover file @file{foo.c} from its
auto-save file @file{#foo.c#}, do:@refill
auto-save file @file{#foo.c#}, do:
@example
M-x recover-file @key{RET} foo.c @key{RET}
......
......@@ -256,7 +256,7 @@ abbreviation for a name into the entire name. Completion is done for
minibuffer (q.v.@:) arguments when the set of possible valid inputs
is known; for example, on command names, buffer names, and
file names. Completion usually occurs when @key{TAB}, @key{SPC} or
@key{RET} is typed. @xref{Completion}.@refill
@key{RET} is typed. @xref{Completion}.
@anchor{Glossary---Continuation Line}
@item Continuation Line
......
......@@ -423,7 +423,7 @@ ring. But you can force it to append by first typing the command
tells the following command, if it is a kill command, to append the text
it kills to the last killed text, instead of starting a new entry. With
@kbd{C-M-w}, you can kill several separated pieces of text and
accumulate them to be yanked back in one place.@refill
accumulate them to be yanked back in one place.
A kill command following @kbd{M-w} (@code{kill-ring-save}) does not
append to the text that @kbd{M-w} copied into the kill ring.
......
......@@ -668,7 +668,7 @@ it possible to match the rest of the pattern. For example, in matching
tries to match all three @samp{a}s; but the rest of the pattern is
@samp{ar} and there is only @samp{r} left to match, so this try fails.
The next alternative is for @samp{a*} to match only two @samp{a}s.
With this choice, the rest of the regexp matches successfully.@refill
With this choice, the rest of the regexp matches successfully.
@item @kbd{+}
is a postfix operator, similar to @samp{*} except that it must match
......@@ -830,11 +830,11 @@ either @var{a} matches it or @var{b} matches it. It works by trying to
match @var{a}, and if that fails, by trying to match @var{b}.
Thus, @samp{foo\|bar} matches either @samp{foo} or @samp{bar}
but no other string.@refill
but no other string.
@samp{\|} applies to the largest possible surrounding expressions. Only a
surrounding @samp{\( @dots{} \)} grouping can limit the grouping power of
@samp{\|}.@refill
@samp{\|}.
Full backtracking capability exists to handle multiple uses of @samp{\|}.
......@@ -850,7 +850,7 @@ Thus, @samp{\(foo\|bar\)x} matches either @samp{foox} or @samp{barx}.
To enclose a complicated expression for the postfix operators @samp{*},
@samp{+} and @samp{?} to operate on. Thus, @samp{ba\(na\)*} matches
@samp{bananana}, etc., with any (zero or more) number of @samp{na}
strings.@refill
strings.
@item
To record a matched substring for future reference.
......@@ -912,7 +912,7 @@ matches the empty string, but only at point.
matches the empty string, but only at the beginning or
end of a word. Thus, @samp{\bfoo\b} matches any occurrence of
@samp{foo} as a separate word. @samp{\bballs?\b} matches
@samp{ball} or @samp{balls} as a separate word.@refill
@samp{ball} or @samp{balls} as a separate word.
@samp{\b} matches at the beginning or end of the buffer
regardless of what text appears next to it.
......@@ -1005,7 +1005,7 @@ searching through, if you specify the text in lower case. Thus, if
you specify searching for @samp{foo}, then @samp{Foo} and @samp{foo}
also match. Regexps, and in particular character sets, behave
likewise: @samp{[ab]} matches @samp{a} or @samp{A} or @samp{b} or
@samp{B}.@refill
@samp{B}.
An upper-case letter anywhere in the incremental search string makes
the search case-sensitive. Thus, searching for @samp{Foo} does not find
......
......@@ -256,7 +256,7 @@ This means that @var{nick} should expand into @var{fulladdresses},
where @var{fulladdresses} can be either a single address, or multiple
addresses separated with spaces. For instance, to make @code{maingnu}
stand for @code{gnu@@gnu.org} plus a local address of your own, put in
this line:@refill
this line:
@example
alias maingnu gnu@@gnu.org local-gnu
......
2013-10-23 Glenn Morris <rgm@gnu.org>
* eval.texi, files.texi, intro.texi, objects.texi, searching.texi:
Nuke @refill.
* Makefile.in (install-dvi, install-html, install-pdf)
(install-ps, uninstall-dvi, uninstall-html, uninstall-ps)
(uninstall-pdf): Quote entities that might contain whitespace.
2013-10-19 Xue Fuqiao <xfq.free@gmail.com>
* display.texi (Face Attributes): Add indexes for the ‘:box’ face attribute.
* display.texi (Face Attributes): Add indexes for the ‘:box’
face attribute.
2013-10-18 Xue Fuqiao <xfq.free@gmail.com>
......
......@@ -523,7 +523,7 @@ GNU Emacs Lisp and Common Lisp. @code{setq}, @code{if}, and
doesn't exist in Common Lisp. @code{throw} is a special form in
Common Lisp (because it must be able to throw multiple values), but it
is a function in Emacs Lisp (which doesn't have multiple
values).@refill
values).
@end quotation
@node Autoloading
......
......@@ -2378,7 +2378,7 @@ buffer's default directory is prepended to @var{directory}, if
In the following example, suppose that @file{~rms/lewis} is the current
default directory, and has five files whose names begin with @samp{f}:
@file{foo}, @file{file~}, @file{file.c}, @file{file.c.~1~}, and
@file{file.c.~2~}.@refill
@file{file.c.~2~}.
@example
@group
......@@ -2409,7 +2409,7 @@ function returns @code{t}. The function returns @code{nil} if directory
In the following example, suppose that the current default directory
has five files whose names begin with @samp{f}: @file{foo},
@file{file~}, @file{file.c}, @file{file.c.~1~}, and
@file{file.c.~2~}.@refill
@file{file.c.~2~}.
@example
@group
......@@ -2438,7 +2438,7 @@ has five files whose names begin with @samp{f}: @file{foo},
@code{file-name-completion} usually ignores file names that end in any
string in this list. It does not ignore them when all the possible
completions end in one of these suffixes. This variable has no effect
on @code{file-name-all-completions}.@refill
on @code{file-name-all-completions}.
A typical value might look like this:
......
......@@ -456,7 +456,7 @@ described using a format like that for functions, except that there
are no arguments.
Here is a description of the imaginary @code{electric-future-map}
variable.@refill
variable.
@defvar electric-future-map
The value of this variable is a full keymap used by Electric Command
......
......@@ -1301,7 +1301,7 @@ called @dfn{subrs} or @dfn{built-in functions}. (The word ``subr'' is
derived from ``subroutine''.) Most primitive functions evaluate all
their arguments when they are called. A primitive function that does
not evaluate all its arguments is called a @dfn{special form}
(@pxref{Special Forms}).@refill
(@pxref{Special Forms}).
It does not matter to the caller of a function whether the function is
primitive. However, this does matter if you try to redefine a primitive
......
......@@ -273,12 +273,12 @@ expression is ordinary, unless a @samp{\} precedes it.
therefore @samp{f} is a regular expression that matches the string
@samp{f} and no other string. (It does @emph{not} match the string
@samp{fg}, but it does match a @emph{part} of that string.) Likewise,
@samp{o} is a regular expression that matches only @samp{o}.@refill
@samp{o} is a regular expression that matches only @samp{o}.
Any two regular expressions @var{a} and @var{b} can be concatenated. The
result is a regular expression that matches a string if @var{a} matches
some amount of the beginning of that string and @var{b} matches the rest of
the string.@refill
the string.
As a simple example, we can concatenate the regular expressions @samp{f}
and @samp{o} to get the regular expression @samp{fo}, which matches only
......@@ -304,7 +304,7 @@ expression.
is a special character that matches any single character except a newline.
Using concatenation, we can make regular expressions like @samp{a.b}, which
matches any three-character string that begins with @samp{a} and ends with
@samp{b}.@refill
@samp{b}.
@item @samp{*}
@cindex @samp{*} in regexp
......@@ -488,7 +488,7 @@ example, the regular expression that matches the @samp{\} character is
@samp{\\}. To write a Lisp string that contains the characters
@samp{\\}, Lisp syntax requires you to quote each @samp{\} with another
@samp{\}. Therefore, the read syntax for a regular expression matching
@samp{\} is @code{"\\\\"}.@refill
@samp{\} is @code{"\\\\"}.
@end table
@strong{Please note:} For historical compatibility, special characters
......@@ -496,7 +496,7 @@ are treated as ordinary ones if they are in contexts where their special
meanings make no sense. For example, @samp{*foo} treats @samp{*} as
ordinary since there is no preceding expression on which the @samp{*}
can act. It is poor practice to depend on this behavior; quote the
special character anyway, regardless of where it appears.@refill
special character anyway, regardless of where it appears.
As a @samp{\} is not special inside a character alternative, it can
never remove the special meaning of @samp{-} or @samp{]}. So you
......@@ -599,14 +599,14 @@ a table of the special @samp{\} constructs.
specifies an alternative.
Two regular expressions @var{a} and @var{b} with @samp{\|} in
between form an expression that matches anything that either @var{a} or
@var{b} matches.@refill
@var{b} matches.
Thus, @samp{foo\|bar} matches either @samp{foo} or @samp{bar}
but no other string.@refill
but no other string.
@samp{\|} applies to the largest possible surrounding expressions. Only a
surrounding @samp{\( @dots{} \)} grouping can limit the grouping power of
@samp{\|}.@refill
@samp{\|}.
If you need full backtracking capability to handle multiple uses of
@samp{\|}, use the POSIX regular expression functions (@pxref{POSIX
......@@ -785,7 +785,7 @@ matches the empty string, but only at point.
matches the empty string, but only at the beginning or
end of a word. Thus, @samp{\bfoo\b} matches any occurrence of
@samp{foo} as a separate word. @samp{\bballs?\b} matches
@samp{ball} or @samp{balls} as a separate word.@refill
@samp{ball} or @samp{balls} as a separate word.
@samp{\b} matches at the beginning or end of the buffer (or string)
regardless of what text appears next to it.
......
2013-10-23 Glenn Morris <rgm@gnu.org>
* dired-x.texi, ebrowse.texi, ede.texi, eieio.texi, eshell.texi:
* pcl-cvs.texi, sc.texi, srecode.texi, vip.texi, viper.texi:
* widget.texi: Nuke @refill.
* Makefile.in (install-dvi, install-html, install-pdf)
(install-ps, uninstall-dvi, uninstall-html, uninstall-ps)
(uninstall-pdf): Quote entities that might contain whitespace.
......
......@@ -560,7 +560,7 @@ of marked files.
@vindex dired-guess-shell-alist-default
Predefined rules for shell commands. Set this to @code{nil} to turn guessing off.
The elements of @code{dired-guess-shell-alist-user} (defined by the
user) will override these rules.@refill
user) will override these rules.
@item dired-guess-shell-alist-user
@vindex dired-guess-shell-alist-user
......@@ -568,7 +568,6 @@ If non-@code{nil}, a user-defined alist of file regexps and their suggested
commands. These rules take precedence over the predefined rules in the
variable @code{dired-guess-shell-alist-default} (to which they are prepended)
when @code{dired-do-shell-command} is run).
@refill
Each element of the alist looks like
......
......@@ -138,7 +138,7 @@ list of the pseudo-class @samp{*Globals*};
@item
Types (@code{enum}s, and @code{typedef}s defined with class
scope).@refill
scope).
@end itemize
You can switch member buffers from one list to another, or to another
......@@ -210,7 +210,7 @@ per line.
@findex --help
When invoked with option @samp{--help}, @command{ebrowse} prints a list of
available command line options.@refill
available command line options.
@menu
* Input files:: Specifying which files to parse
......@@ -478,12 +478,12 @@ name.
This command views the class declaration if the database
contains information about it. If you don't parse the entire source
you are working on, some classes will only be known to exist but the
location of their declarations and definitions will not be known.@refill
location of their declarations and definitions will not be known.
@item RET
Works like @kbd{SPC}, except that it finds the class
declaration rather than viewing it, so that it is ready for
editing.@refill
editing.
@end table
The same functionality is available from the menu opened with
......@@ -570,7 +570,7 @@ positions the cursor on the class in the class tree.
If the branch of the class tree containing the class searched for is
currently collapsed, the class itself and all its base classes are
recursively made visible. (See also @ref{Expanding and
Collapsing}.)@refill
Collapsing}.)
This function is also available from the tree buffer's context menu.
......@@ -634,7 +634,7 @@ Here is an example of a tree buffer with file names displayed.
You can expand and collapse parts of a tree to reduce the complexity of
large class hierarchies. Expanding or collapsing branches of a tree has
no impact on the functionality of other commands, like @kbd{/}. (See
also @ref{Go to Class}.)@refill
also @ref{Go to Class}.)
Collapsed branches are indicated with an ellipsis following the class
name like in the example below.
......@@ -734,7 +734,7 @@ context menu.
Classes can be marked for operations similar to the standard Emacs
commands @kbd{M-x tags-search} and @kbd{M-x tags-query-replace} (see
also @xref{Tags-like Functions}.)@refill
also @xref{Tags-like Functions}.)
@table @kbd
@cindex toggle mark
......@@ -1292,7 +1292,7 @@ When jumping to a member declaration or definition with one of
Ebrowse's commands, the position from where you performed the
jump and the position where you jumped to are recorded in a
@dfn{position stack}. There are several ways in which you can quickly
move to positions in the stack:@refill
move to positions in the stack:
@table @kbd
@cindex return to original position
......
......@@ -1564,26 +1564,22 @@ Type: @code{string} @*
Default Value: @code{"Untitled"}
The name used when generating distribution files.
@refill
@item :version
Type: @code{string} @*
Default Value: @code{"1.0"}
The version number used when distributing files.
@refill
@item :directory
Type: @code{string}
Directory this project is associated with.
@refill
@item :file
Type: @code{string}
File name where this project is stored.
@refill
@end table
......@@ -1656,35 +1652,30 @@ Make sure placeholder @var{THIS} is replaced with the real thing, and pass throu
Type: @code{list}
List of top level targets in this project.
@refill
@item :tool-cache
Type: @code{list}
List of tool cache configurations in this project.
This allows any tool to create, manage, and persist project-specific settings.
@refill
@item :web-site-url
Type: @code{string} @*
URL to this projects web site.
This is a URL to be sent to a web site for documentation.
@refill
@item :web-site-directory @*
A directory where web pages can be found by Emacs.
For remote locations use a path compatible with ange-ftp or EFS@.
You can also use TRAMP for use with rcp & scp.
@refill
@item :web-site-file @*
A file which contains the home page for this project.
This file can be relative to slot @code{web-site-directory}.
This can be a local file, use ange-ftp, EFS, or TRAMP.
@refill
@item :ftp-site
Type: @code{string} @*
......@@ -1692,7 +1683,6 @@ Type: @code{string} @*
FTP site where this project's distribution can be found.
This FTP site should be in Emacs form, as needed by @code{ange-ftp}, but can
also be of a form used by TRAMP for use with scp, or rcp.
@refill
@item :ftp-upload-site
Type: @code{string} @*
......@@ -1700,7 +1690,6 @@ Type: @code{string} @*
FTP Site to upload new distributions to.
This FTP site should be in Emacs form as needed by @code{ange-ftp}.
If this slot is @code{nil}, then use @code{ftp-site} instead.
@refill
@item :configurations
Type: @code{list} @*
......@@ -1709,19 +1698,16 @@ Default Value: @code{("debug" "release")}
List of available configuration types.
Individual target/project types can form associations between a configuration,
and target specific elements such as build variables.
@refill
@item :configuration-default @*
Default Value: @code{"debug"}
The default configuration.
@refill
@item :local-variables @*
Default Value: @code{nil}
Project local variables
@refill
@end table
......@@ -1966,7 +1952,6 @@ buffer's @code{default-directory} (not starting with a /). Directories
that are relative to the project's root should start with a /, such
as "/include", meaning the directory @code{include} off the project root
directory.
@refill
@item :system-include-path
Type: @code{list} @*
......@@ -1976,7 +1961,6 @@ The system include path for files in this project.
C files initialized in an ede-cpp-root-project have their semantic
system include path set to this value. If this is @code{nil}, then the
semantic path is not modified.
@refill
@item :spp-table
Type: @code{list} @*
......@@ -1988,7 +1972,6 @@ These macros might be passed in through the command line compiler, or
are critical symbols derived from header files. Providing header files
macro values through this slot improves accuracy and performance.
Use `:spp-files' to use these files directly.
@refill
@item :spp-files
Type: @code{list} @*
......@@ -1998,14 +1981,12 @@ C header file with Preprocessor macros for your files.
The PreProcessor symbols appearing in these files will be used while
parsing files in this project.
See @code{semantic-lex-c-preprocessor-symbol-map} for more on how this works.
@refill
@item :header-match-regexp
Type: @code{string} @*
Default Value: @code{"\\.\\(h\\(h\\|xx\\|pp\\|\\+\\+\\)?\\|H\\)$\\|\\<\\w+$"}
Regexp used to identify C/C++ header files.
@refill
@item :locate-fcn
Type: @code{(or null function)} @*
......@@ -2020,7 +2001,6 @@ The function symbol must take two arguments:
It should return the fully qualified file name passed in from NAME@. If that file does not
exist, it should return nil.
@refill
@end table
......@@ -2144,14 +2124,12 @@ The type of Makefile to generate.
Can be one of @code{'Makefile}, 'Makefile.in, or 'Makefile.am.
If this value is NOT @code{'Makefile}, then that overrides the @code{:makefile} slot
in targets.
@refill
@item :variables
Type: @code{list} @*
Default Value: @code{nil}
Variables to set in this Makefile.
@refill
@item :configuration-variables
Type: @code{list} @*
......@@ -2159,27 +2137,23 @@ Default Value: @code{("debug" (("DEBUG" . "1")))}
Makefile variables to use in different configurations.
These variables are used in the makefile when a configuration becomes active.
@refill
@item :inference-rules @*
Default Value: @code{nil}
Inference rules to add to the makefile.
@refill
@item :include-file @*
Default Value: @code{nil}
Additional files to include.
These files can contain additional rules, variables, and customizations.
@refill
@item :automatic-dependencies
Type: @code{boolean} @*
Default Value: @code{t}
Non-@code{nil} to do implement automatic dependencies in the Makefile.
@refill
@item :metasubproject
Type: @code{boolean} @*
......@@ -2190,7 +2164,6 @@ Usually, a subproject is determined by a parent project. If multiple top level
projects are grouped into a large project not maintained by EDE, then you need
to set this to non-nil. The only effect is that the @code{dist} rule will then avoid
making a tar file.
@refill
@end table
......@@ -2380,7 +2353,6 @@ Type: @code{list} @*
Default Value: @code{nil}
Variables to set in this Makefile, at top of file.
@refill
@item :additional-variables
Type: @code{(or null list)} @*
......@@ -2388,7 +2360,6 @@ Default Value: @code{nil}
Arbitrary variables needed from this project.
It is safe to leave this blank.
@refill
@item :additional-rules
Type: @code{(or null list)} @*
......@@ -2396,7 +2367,6 @@ Default Value: @code{nil}
Arbitrary rules and dependencies needed to make this target.
It is safe to leave this blank.
@refill
@item :installation-domain
Type: @code{symbol} @*
......@@ -2404,7 +2374,6 @@ Default Value: @code{user}
Installation domain specification.
The variable GNUSTEP_INSTALLATION_DOMAIN is set at this value.
@refill
@item :preamble
Type: @code{(or null list)} @*
......@@ -2412,7 +2381,6 @@ Default Value: @code{(quote ("GNUmakefile.preamble"))}
The auxiliary makefile for additional variables.
Included just before the specific target files.
@refill
@item :postamble
Type: @code{(or null list)} @*
......@@ -2420,7 +2388,6 @@ Default Value: @code{(quote ("GNUmakefile.postamble"))}
The auxiliary makefile for additional rules.
Included just after the specific target files.
@refill
@item :metasubproject
Type: @code{boolean} @*
......@@ -2431,7 +2398,6 @@ Usually, a subproject is determined by a parent project. If multiple top level
projects are grouped into a large project not maintained by EDE, then you need
to set this to non-nil. The only effect is that the @code{dist} rule will then avoid
making a tar file.
@refill
@end table
......@@ -2536,21 +2502,18 @@ Commit change to local variables in @var{PROJ}.
Type: @code{string}
Name of this target.
@refill
@item :path
Type: @code{string}
The path to the sources of this target.
Relative to the path of the project it belongs to.
@refill
@item :source
Type: @code{list} @*
Default Value: @code{nil}
Source files in this target.
@refill
@item :versionsource
Type: @code{list} @*
......@@ -2560,7 +2523,6 @@ Source files with a version string in them.
These files are checked for a version string whenever the EDE version
of the master project is changed. When strings are found, the version
previously there is updated.
@refill
@end table
......@@ -2752,14 +2714,12 @@ Retrieves the slot @code{menu} from an object of class @code{ede-target}
Type: @code{string}
Name of this target.
@refill
@item :path
Type: @code{string}
The path to the sources of this target.
Relative to the path of the project it belongs to.
@refill
@item :auxsource
Type: @code{list} @*
......@@ -2768,7 +2728,6 @@ Default Value: @code{nil}
Auxiliary source files included in this target.
Each of these is considered equivalent to a source file, but it is not
distributed, and each should have a corresponding rule to build it.
@refill
@item :compiler
Type: @code{(or null symbol)} @*
......@@ -2778,7 +2737,6 @@ The compiler to be used to compile this object.
This should be a symbol, which contains the object defining the compiler.
This enables save/restore to do so by name, permitting the sharing
of these compiler resources, and global customization thereof.
@refill
@item :linker
Type: @code{(or null symbol)} @*
......@@ -2788,7 +2746,6 @@ The linker to be used to link compiled sources for this object.
This should be a symbol, which contains the object defining the linker.
This enables save/restore to do so by name, permitting the sharing
of these linker resources, and global customization thereof.
@refill
@end table
......@@ -2950,7 +2907,6 @@ Type: @code{string} @*
Default Value: @code{"Makefile"}
File name of generated Makefile.
@refill
@item :partofall
Type: @code{boolean} @*
......@@ -2959,7 +2915,6 @@ Default Value: @code{t}
Non @code{nil} means the rule created is part of the all target.
Setting this to @code{nil} creates the rule to build this item, but does not
include it in the ALL`all:' rule.
@refill
@item :configuration-variables
Type: @code{list} @*
......@@ -2969,7 +2924,6 @@ Makefile variables appended to use in different configurations.
These variables are used in the makefile when a configuration becomes active.
Target variables are always renamed such as foo_CFLAGS, then included into
commands where the variable would usually appear.
@refill
@item :rules
Type: @code{list} @*
......@@ -2977,7 +2931,6 @@ Default Value: @code{nil}
Arbitrary rules and dependencies needed to make this target.
It is safe to leave this blank.
@refill
@end table
......@@ -3221,7 +3174,6 @@ The linker flag "-l" is automatically prepended. Do not include a "lib"
prefix, or a ".so" suffix.
Note: Currently only used for Automake projects.
@refill
@item :ldflags
Type: @code{list} @*
......@@ -3232,7 +3184,6 @@ Use ldlibs to add addition libraries. Use this to specify specific
options to the linker.