| Line 111... |
Line 111... |
| 111 |
\code{findMatches}, this argument defaults to the current setting. }
|
111 |
\code{findMatches}, this argument defaults to the current setting. }
|
| 112 |
|
112 |
|
| 113 |
\item{quotes}{ Logical flag. Enables completion in \R code when inside
|
113 |
\item{quotes}{ Logical flag. Enables completion in \R code when inside
|
| 114 |
quotes. This normally leads to filename completion, but can be
|
114 |
quotes. This normally leads to filename completion, but can be
|
| 115 |
otherwise depending on context (for example, when the open quote is
|
115 |
otherwise depending on context (for example, when the open quote is
|
| 116 |
preceded by \code{?}), help completion is invoked. Setting this to
|
116 |
preceded by \samp{?}), help completion is invoked. Setting this to
|
| 117 |
\code{FALSE} relegates completion to the underlying completion
|
117 |
\code{FALSE} relegates completion to the underlying completion
|
| 118 |
front-end, which may do its own processing (for example,
|
118 |
front-end, which may do its own processing (for example,
|
| 119 |
\code{readline} on Unix-alikes will do filename completion). }
|
119 |
\code{readline} on Unix-alikes will do filename completion). }
|
| 120 |
|
120 |
|
| 121 |
\item{files}{ Logical flag. Deprecated. Use \code{quotes} instead. }
|
121 |
\item{files}{ Logical flag. Deprecated. Use \code{quotes} instead. }
|
| Line 178... |
Line 178... |
| 178 |
\item{\bold{Completion inside namespaces}:}{
|
178 |
\item{\bold{Completion inside namespaces}:}{
|
| 179 |
When the \code{ns} setting is turned on, completion inside
|
179 |
When the \code{ns} setting is turned on, completion inside
|
| 180 |
namespaces is attempted when a token is preceded by the \code{::}
|
180 |
namespaces is attempted when a token is preceded by the \code{::}
|
| 181 |
or \code{:::} operators. Additionally, the basic completion
|
181 |
or \code{:::} operators. Additionally, the basic completion
|
| 182 |
mechanism is extended to include all loaded namespaces, i.e.,
|
182 |
mechanism is extended to include all loaded namespaces, i.e.,
|
| 183 |
\code{foopkg::} becomes a valid completion of \code{foo} if
|
183 |
\samp{foopkg::} becomes a valid completion of \samp{foo} if
|
| 184 |
\code{"foopkg"} is a loaded namespace.
|
184 |
\code{"foopkg"} is a loaded namespace.
|
| 185 |
|
185 |
|
| 186 |
The completion of package namespaces applies only to already
|
186 |
The completion of package namespaces applies only to already
|
| 187 |
loaded namespaces, i.e.\sspace{}if \pkg{MASS} is not loaded,
|
187 |
loaded namespaces, i.e.\sspace{}if \pkg{MASS} is not loaded,
|
| 188 |
\code{MAS} will not complete to \code{MASS::}. However, attempted
|
188 |
\samp{MAS} will not complete to \samp{MASS::}. However, attempted
|
| 189 |
completion \emph{inside} an apparent namespace will attempt to
|
189 |
completion \emph{inside} an apparent namespace will attempt to
|
| 190 |
load the namespace if it is not already loaded,
|
190 |
load the namespace if it is not already loaded,
|
| 191 |
e.g.\sspace{}trying to complete on \code{MASS::fr} will load
|
191 |
e.g.\sspace{}trying to complete on \samp{MASS::fr} will load
|
| 192 |
\pkg{MASS} if it is not already loaded.
|
192 |
\pkg{MASS} if it is not already loaded.
|
| 193 |
}
|
193 |
}
|
| 194 |
|
194 |
|
| 195 |
\item{\bold{Completion for help items}:}{
|
195 |
\item{\bold{Completion for help items}:}{
|
| 196 |
When the \code{help} setting is turned on, completion on help
|
196 |
When the \code{help} setting is turned on, completion on help
|
| Line 235... |
Line 235... |
| 235 |
is. Since there are usually many many more visible objects than
|
235 |
is. Since there are usually many many more visible objects than
|
| 236 |
formal arguments of any particular function, possible argument
|
236 |
formal arguments of any particular function, possible argument
|
| 237 |
completions are often buried in a bunch of other possibilities.
|
237 |
completions are often buried in a bunch of other possibilities.
|
| 238 |
However, recall that basic completion is suppressed for blank
|
238 |
However, recall that basic completion is suppressed for blank
|
| 239 |
tokens. This can be useful to list possible arguments of a
|
239 |
tokens. This can be useful to list possible arguments of a
|
| 240 |
function. For example, trying to complete \code{seq([TAB]} and
|
240 |
function. For example, trying to complete \samp{seq([TAB]} and
|
| 241 |
\code{seq(from = 1, [TAB])} will both list only the arguments of
|
241 |
\samp{seq(from = 1, [TAB])} will both list only the arguments of
|
| 242 |
\code{seq} (or any of its methods), whereas trying to complete
|
242 |
\code{seq} (or any of its methods), whereas trying to complete
|
| 243 |
\code{seq(length[TAB]} will list both the \code{length.out}
|
243 |
\samp{seq(length[TAB]} will list both the \code{length.out}
|
| 244 |
argument and the \code{length(} function as possible completions.
|
244 |
argument and the \samp{length(} function as possible completions.
|
| 245 |
Note that no attempt is made to remove arguments already supplied,
|
245 |
Note that no attempt is made to remove arguments already supplied,
|
| 246 |
as that would incur a further speed penalty.
|
246 |
as that would incur a further speed penalty.
|
| 247 |
}
|
247 |
}
|
| 248 |
|
248 |
|
| 249 |
\item{\bold{Special functions}:}{
|
249 |
\item{\bold{Special functions}:}{
|