1
% File src/library/utils/man/rcompgen.Rd
2
% Part of the R package, http://www.R-project.org
3
% Copyright 2008 R Core Development Team
4
% Distributed under GPL 2 or later
37
42
\item{\code{ops}:}{activates completion after the \code{$} and
38
43
\code{@} operators}
40
\item{\code{ns}:}{controls namespace related completions}
45
\item{\code{ns}:}{controls name space related completions}
42
47
\item{\code{args}:}{enables completion of function arguments}
125
130
\code{[}, \code{$}, etc \emph{do not} inhibit evaluation).
128
\item{\bold{Completion inside namespaces}:}{
133
\item{\bold{Completion inside name spaces}:}{
129
134
When the \code{ns} setting is turned on, completion inside
130
namespaces is attempted when a token is preceded by the \code{::}
135
name spaces is attempted when a token is preceded by the \code{::}
131
136
or \code{:::} operators. Additionally, the basic completion
132
mechanism is extended to include attached namespaces, or more
137
mechanism is extended to include attached name spaces, or more
133
138
precisely, \code{foopkg::} becomes a valid completion of
134
139
\code{foo} if the return value of \code{\link{search}()} includes
135
140
the string \code{"package:foopkg"}.
137
The completion of package namespaces applies only to attached
142
The completion of package name spaces applies only to attached
138
143
packages, i.e. if \code{MASS} is not attached (whether or not it
139
144
is loaded), \code{MAS} will not complete to \code{MASS::}.
140
However, attempted completion \emph{inside} an apparent namespace
141
will attempt to load the namespace if it is not already loaded,
145
However, attempted completion \emph{inside} an apparent name space
146
will attempt to load the name space if it is not already loaded,
142
147
e.g. trying to complete on \code{MASS::fr} will load \code{MASS}
143
148
(but not necessarily attach it) even if it is not already loaded.
178
183
of completion are also appropriate whenever argument completion
179
184
is. Since there are usually many many more visible objects than
180
185
formal arguments of any particular function, possible argument
181
completions are often buried in a bunch of other possibilites.
186
completions are often buried in a bunch of other possibilities.
182
187
However, recall that basic completion is suppressed for blank
183
188
tokens. This can be useful to list possible arguments of a
184
189
function. For example, trying to complete \code{seq([TAB]} and