mirror of
git://git.sv.gnu.org/emacs.git
synced 2025-12-06 06:20:55 -08:00
* syntax.texi (Position Parse): Document rationale for ignored
arguments to syntax-ppss-flush-cache. * processes.texi (Input to Processes): Mark PROCESS arg to process-running-child-p as optional. (Network Options): Document NO-ERROR arg to set-network-process-option. * buffers.texi (Indirect Buffers): Mark clone-indirect-buffer as a command. * searching.texi (POSIX Regexps): Mark posix-search-forward and posix-search-backward as commands. * os.texi (Killing Emacs): Mark kill-emacs as a command. (Suspending Emacs): Mark suspend-emacs as a command. (Processor Run Time): Mark emacs-uptime and emacs-init-time as commands. (Terminal Output): Remove obsolete function baud-rate. Document TERMINAL arg for send-string-to-terminal. * nonascii.texi (Terminal I/O Encoding): Document TERMINAL arg for terminal-coding-system and set-terminal-coding-system. (Explicit Encoding): Mark DESTINATION arg of decode-coding-region as optional. (Character Sets): Document RESTRICTION arg of char-charset. (Character Codes): Mark POS argument to get-byte as optional. * minibuf.texi (Minibuffer Misc): Document ARGS arg for minibuffer-message. * files.texi (Create/Delete Dirs): Mark make-directory and delete-directory as commands. * abbrevs.texi (Abbrev Tables): Fix arglist for make-abbrev-table. * text.texi (Base 64): Mark base64-decode-string and base64-encode-string as commands. (Columns): Mark move-to-column as a command. (Mode-Specific Indent): Document RIGID arg to indent-for-tab-command. (Region Indent): Mark TO-COLUMN arg to indent-region as optional. Mark indent-code-rigidly as a command. (Substitution): Mark translate-region as a command. * frames.texi (Size and Position): Remove obsolete functions screen-height and screen-width.
This commit is contained in:
parent
ae8ba4092c
commit
106e6894f2
12 changed files with 145 additions and 141 deletions
|
|
@ -1,3 +1,53 @@
|
||||||
|
2009-05-20 Chong Yidong <cyd@stupidchicken.com>
|
||||||
|
|
||||||
|
* syntax.texi (Position Parse): Document rationale for ignored
|
||||||
|
arguments to syntax-ppss-flush-cache.
|
||||||
|
|
||||||
|
* processes.texi (Input to Processes): Mark PROCESS arg to
|
||||||
|
process-running-child-p as optional.
|
||||||
|
(Network Options): Document NO-ERROR arg to
|
||||||
|
set-network-process-option.
|
||||||
|
|
||||||
|
* buffers.texi (Indirect Buffers): Mark clone-indirect-buffer as a
|
||||||
|
command.
|
||||||
|
|
||||||
|
* searching.texi (POSIX Regexps): Mark posix-search-forward and
|
||||||
|
posix-search-backward as commands.
|
||||||
|
|
||||||
|
* os.texi (Killing Emacs): Mark kill-emacs as a command.
|
||||||
|
(Suspending Emacs): Mark suspend-emacs as a command.
|
||||||
|
(Processor Run Time): Mark emacs-uptime and emacs-init-time as
|
||||||
|
commands.
|
||||||
|
(Terminal Output): Remove obsolete function baud-rate. Document
|
||||||
|
TERMINAL arg for send-string-to-terminal.
|
||||||
|
|
||||||
|
* nonascii.texi (Terminal I/O Encoding): Document TERMINAL arg for
|
||||||
|
terminal-coding-system and set-terminal-coding-system.
|
||||||
|
(Explicit Encoding): Mark DESTINATION arg of decode-coding-region
|
||||||
|
as optional.
|
||||||
|
(Character Sets): Document RESTRICTION arg of char-charset.
|
||||||
|
(Character Codes): Mark POS argument to get-byte as optional.
|
||||||
|
|
||||||
|
* minibuf.texi (Minibuffer Misc): Document ARGS arg for
|
||||||
|
minibuffer-message.
|
||||||
|
|
||||||
|
* files.texi (Create/Delete Dirs): Mark make-directory and
|
||||||
|
delete-directory as commands.
|
||||||
|
|
||||||
|
* abbrevs.texi (Abbrev Tables): Fix arglist for make-abbrev-table.
|
||||||
|
|
||||||
|
* text.texi (Base 64): Mark base64-decode-string and
|
||||||
|
base64-encode-string as commands.
|
||||||
|
(Columns): Mark move-to-column as a command.
|
||||||
|
(Mode-Specific Indent): Document RIGID arg to
|
||||||
|
indent-for-tab-command.
|
||||||
|
(Region Indent): Mark TO-COLUMN arg to indent-region as optional.
|
||||||
|
Mark indent-code-rigidly as a command.
|
||||||
|
(Substitution): Mark translate-region as a command.
|
||||||
|
|
||||||
|
* frames.texi (Size and Position): Remove obsolete functions
|
||||||
|
screen-height and screen-width.
|
||||||
|
|
||||||
2009-05-19 Chong Yidong <cyd@stupidchicken.com>
|
2009-05-19 Chong Yidong <cyd@stupidchicken.com>
|
||||||
|
|
||||||
* windows.texi (Cyclic Window Ordering, Cyclic Window Ordering)
|
* windows.texi (Cyclic Window Ordering, Cyclic Window Ordering)
|
||||||
|
|
|
||||||
|
|
@ -82,7 +82,7 @@ override it. It is the same as @code{(default-value 'abbrev-mode)}.
|
||||||
|
|
||||||
This section describes how to create and manipulate abbrev tables.
|
This section describes how to create and manipulate abbrev tables.
|
||||||
|
|
||||||
@defun make-abbrev-table &rest props
|
@defun make-abbrev-table &optional props
|
||||||
This function creates and returns a new, empty abbrev table---an
|
This function creates and returns a new, empty abbrev table---an
|
||||||
obarray containing no symbols. It is a vector filled with zeros.
|
obarray containing no symbols. It is a vector filled with zeros.
|
||||||
@var{props} is a property list that is applied to the new table
|
@var{props} is a property list that is applied to the new table
|
||||||
|
|
|
||||||
|
|
@ -1135,7 +1135,7 @@ non-@code{nil}, the initial state is copied from the actual base
|
||||||
buffer, not from @var{base-buffer}.
|
buffer, not from @var{base-buffer}.
|
||||||
@end deffn
|
@end deffn
|
||||||
|
|
||||||
@defun clone-indirect-buffer newname display-flag &optional norecord
|
@deffn clone-indirect-buffer newname display-flag &optional norecord
|
||||||
This function creates and returns a new indirect buffer that shares
|
This function creates and returns a new indirect buffer that shares
|
||||||
the current buffer's base buffer and copies the rest of the current
|
the current buffer's base buffer and copies the rest of the current
|
||||||
buffer's attributes. (If the current buffer is not indirect, it is
|
buffer's attributes. (If the current buffer is not indirect, it is
|
||||||
|
|
@ -1145,7 +1145,7 @@ If @var{display-flag} is non-@code{nil}, that means to display the new
|
||||||
buffer by calling @code{pop-to-buffer}. If @var{norecord} is
|
buffer by calling @code{pop-to-buffer}. If @var{norecord} is
|
||||||
non-@code{nil}, that means not to put the new buffer to the front of
|
non-@code{nil}, that means not to put the new buffer to the front of
|
||||||
the buffer list.
|
the buffer list.
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@defun buffer-base-buffer &optional buffer
|
@defun buffer-base-buffer &optional buffer
|
||||||
This function returns the base buffer of @var{buffer}, which defaults
|
This function returns the base buffer of @var{buffer}, which defaults
|
||||||
|
|
|
||||||
|
|
@ -2492,24 +2492,24 @@ with @code{delete-file}. These special functions exist to create and
|
||||||
delete directories.
|
delete directories.
|
||||||
|
|
||||||
@findex mkdir
|
@findex mkdir
|
||||||
@defun make-directory dirname &optional parents
|
@deffn Command make-directory dirname &optional parents
|
||||||
This function creates a directory named @var{dirname}.
|
This command creates a directory named @var{dirname}. If
|
||||||
If @var{parents} is non-@code{nil}, as is always the case in an
|
@var{parents} is non-@code{nil}, as is always the case in an
|
||||||
interactive call, that means to create the parent directories first,
|
interactive call, that means to create the parent directories first,
|
||||||
if they don't already exist.
|
if they don't already exist.
|
||||||
|
|
||||||
@code{mkdir} is an alias for this fuction.
|
@code{mkdir} is an alias for this.
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@defun delete-directory dirname
|
@deffn Command delete-directory dirname
|
||||||
This function deletes the directory named @var{dirname}. The function
|
This command deletes the directory named @var{dirname}. The function
|
||||||
@code{delete-file} does not work for files that are directories; you
|
@code{delete-file} does not work for files that are directories; you
|
||||||
must use @code{delete-directory} for them. If the directory contains
|
must use @code{delete-directory} for them. If the directory contains
|
||||||
any files, @code{delete-directory} signals an error.
|
any files, @code{delete-directory} signals an error.
|
||||||
|
|
||||||
This function only follows symbolic links at the level of parent
|
@code{delete-directory} only follows symbolic links at the level of
|
||||||
directories.
|
parent directories.
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@node Magic File Names
|
@node Magic File Names
|
||||||
@section Making Certain File Names ``Magic''
|
@section Making Certain File Names ``Magic''
|
||||||
|
|
|
||||||
|
|
@ -968,13 +968,6 @@ lines and columns. If you don't supply @var{frame}, they use the
|
||||||
selected frame.
|
selected frame.
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@defun screen-height
|
|
||||||
@defunx screen-width
|
|
||||||
These functions are old aliases for @code{frame-height} and
|
|
||||||
@code{frame-width}. When you are using a non-window terminal, the size
|
|
||||||
of the frame is normally the same as the size of the terminal screen.
|
|
||||||
@end defun
|
|
||||||
|
|
||||||
@defun frame-pixel-height &optional frame
|
@defun frame-pixel-height &optional frame
|
||||||
@defunx frame-pixel-width &optional frame
|
@defunx frame-pixel-width &optional frame
|
||||||
These functions return the height and width of the main display area
|
These functions return the height and width of the main display area
|
||||||
|
|
|
||||||
|
|
@ -2125,10 +2125,12 @@ windows. If a float, it specifies a fraction of the height of the
|
||||||
frame. If an integer, it specifies a number of lines.
|
frame. If an integer, it specifies a number of lines.
|
||||||
@end defopt
|
@end defopt
|
||||||
|
|
||||||
@defun minibuffer-message string
|
@defun minibuffer-message string &rest args
|
||||||
This function displays @var{string} temporarily at the end of the
|
This function displays @var{string} temporarily at the end of the
|
||||||
minibuffer text, for two seconds, or until the next input event
|
minibuffer text, for two seconds, or until the next input event
|
||||||
arrives, whichever comes first.
|
arrives, whichever comes first. If @var{args} is non-@code{nil}, the
|
||||||
|
actual message is obtained by passing @var{string} and @var{args}
|
||||||
|
through @code{format}. @xref{Formatting Strings}.
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@ignore
|
@ignore
|
||||||
|
|
|
||||||
|
|
@ -328,7 +328,7 @@ codepoint can have.
|
||||||
@end example
|
@end example
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@defun get-byte pos &optional string
|
@defun get-byte &optional pos string
|
||||||
This function returns the byte at character position @var{pos} in the
|
This function returns the byte at character position @var{pos} in the
|
||||||
current buffer. If the current buffer is unibyte, this is literally
|
current buffer. If the current buffer is unibyte, this is literally
|
||||||
the byte at that position. If the buffer is multibyte, byte values of
|
the byte at that position. If the buffer is multibyte, byte values of
|
||||||
|
|
@ -573,10 +573,15 @@ returns a single character set of the highest priority.
|
||||||
This function makes @var{charsets} the highest priority character sets.
|
This function makes @var{charsets} the highest priority character sets.
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@defun char-charset character
|
@defun char-charset character &optional restriction
|
||||||
This function returns the name of the character set of highest
|
This function returns the name of the character set of highest
|
||||||
priority that @var{character} belongs to. @acronym{ASCII} characters
|
priority that @var{character} belongs to. @acronym{ASCII} characters
|
||||||
are an exception: for them, this function always returns @code{ascii}.
|
are an exception: for them, this function always returns @code{ascii}.
|
||||||
|
|
||||||
|
If @var{restriction} is non-@code{nil}, it should be a list of
|
||||||
|
charsets to search. Alternatively, it can be a coding system, in
|
||||||
|
which case the returned charset must be supported by that coding
|
||||||
|
system (@pxref{Coding Systems}).
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@defun charset-plist charset
|
@defun charset-plist charset
|
||||||
|
|
@ -1621,7 +1626,7 @@ case the function may return @var{string} itself if the encoding
|
||||||
operation is trivial. The result of encoding is a unibyte string.
|
operation is trivial. The result of encoding is a unibyte string.
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@deffn Command decode-coding-region start end coding-system destination
|
@deffn Command decode-coding-region start end coding-system &optional destination
|
||||||
This command decodes the text from @var{start} to @var{end} according
|
This command decodes the text from @var{start} to @var{end} according
|
||||||
to coding system @var{coding-system}. To make explicit decoding
|
to coding system @var{coding-system}. To make explicit decoding
|
||||||
useful, the text before decoding ought to be a sequence of byte
|
useful, the text before decoding ought to be a sequence of byte
|
||||||
|
|
@ -1706,15 +1711,20 @@ if it is @code{nil}, that means the currently selected frame's
|
||||||
terminal. @xref{Multiple Terminals}.
|
terminal. @xref{Multiple Terminals}.
|
||||||
@end deffn
|
@end deffn
|
||||||
|
|
||||||
@defun terminal-coding-system
|
@defun terminal-coding-system &optional terminal
|
||||||
This function returns the coding system that is in use for encoding
|
This function returns the coding system that is in use for encoding
|
||||||
terminal output---or @code{nil} for no encoding.
|
terminal output from @var{terminal}---or @code{nil} if the output is
|
||||||
|
not encoded. If @var{terminal} is a frame, it means that frame's
|
||||||
|
terminal; if it is @code{nil}, that means the currently selected
|
||||||
|
frame's terminal.
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@deffn Command set-terminal-coding-system coding-system
|
@deffn Command set-terminal-coding-system coding-system &optional terminal
|
||||||
This command specifies @var{coding-system} as the coding system to use
|
This command specifies @var{coding-system} as the coding system to use
|
||||||
for encoding terminal output. If @var{coding-system} is @code{nil},
|
for encoding terminal output from @var{terminal}. If
|
||||||
that means do not encode terminal output.
|
@var{coding-system} is @code{nil}, terminal output is not encoded. If
|
||||||
|
@var{terminal} is a frame, it means that frame's terminal; if it is
|
||||||
|
@code{nil}, that means the currently selected frame's terminal.
|
||||||
@end deffn
|
@end deffn
|
||||||
|
|
||||||
@node MS-DOS File Types
|
@node MS-DOS File Types
|
||||||
|
|
|
||||||
|
|
@ -539,8 +539,8 @@ common.
|
||||||
parent process normally resumes control. The low-level primitive for
|
parent process normally resumes control. The low-level primitive for
|
||||||
killing Emacs is @code{kill-emacs}.
|
killing Emacs is @code{kill-emacs}.
|
||||||
|
|
||||||
@defun kill-emacs &optional exit-data
|
@deffn Command kill-emacs &optional exit-data
|
||||||
This function exits the Emacs process and kills it.
|
This command exits the Emacs process and kills it.
|
||||||
|
|
||||||
If @var{exit-data} is an integer, then it is used as the exit status
|
If @var{exit-data} is an integer, then it is used as the exit status
|
||||||
of the Emacs process. (This is useful primarily in batch operation; see
|
of the Emacs process. (This is useful primarily in batch operation; see
|
||||||
|
|
@ -549,7 +549,7 @@ of the Emacs process. (This is useful primarily in batch operation; see
|
||||||
If @var{exit-data} is a string, its contents are stuffed into the
|
If @var{exit-data} is a string, its contents are stuffed into the
|
||||||
terminal input buffer so that the shell (or whatever program next reads
|
terminal input buffer so that the shell (or whatever program next reads
|
||||||
input) can read them.
|
input) can read them.
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
All the information in the Emacs process, aside from files that have
|
All the information in the Emacs process, aside from files that have
|
||||||
been saved, is lost when the Emacs process is killed. Because killing
|
been saved, is lost when the Emacs process is killed. Because killing
|
||||||
|
|
@ -605,7 +605,7 @@ controlling terminal is a graphical terminal.
|
||||||
systems, ``suspension'' actually creates a new shell temporarily as a
|
systems, ``suspension'' actually creates a new shell temporarily as a
|
||||||
subprocess of Emacs. Then you would exit the shell to return to Emacs.
|
subprocess of Emacs. Then you would exit the shell to return to Emacs.
|
||||||
|
|
||||||
@defun suspend-emacs &optional string
|
@deffn Command suspend-emacs &optional string
|
||||||
This function stops Emacs and returns control to the superior process.
|
This function stops Emacs and returns control to the superior process.
|
||||||
If and when the superior process resumes Emacs, @code{suspend-emacs}
|
If and when the superior process resumes Emacs, @code{suspend-emacs}
|
||||||
returns @code{nil} to its caller in Lisp.
|
returns @code{nil} to its caller in Lisp.
|
||||||
|
|
@ -676,7 +676,7 @@ lewis@@slug[24] % fg
|
||||||
Resumed!
|
Resumed!
|
||||||
@end group
|
@end group
|
||||||
@end smallexample
|
@end smallexample
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@defvar suspend-hook
|
@defvar suspend-hook
|
||||||
This variable is a normal hook that Emacs runs before suspending.
|
This variable is a normal hook that Emacs runs before suspending.
|
||||||
|
|
@ -830,7 +830,7 @@ done when Emacs starts up, the value actually used is the one saved when
|
||||||
Emacs was dumped. @xref{Building Emacs}.)
|
Emacs was dumped. @xref{Building Emacs}.)
|
||||||
@end defvar
|
@end defvar
|
||||||
|
|
||||||
@deffn Command getenv var
|
@deffn Command getenv var &optional frame
|
||||||
@cindex environment variable access
|
@cindex environment variable access
|
||||||
This function returns the value of the environment variable @var{var},
|
This function returns the value of the environment variable @var{var},
|
||||||
as a string. @var{var} should be a string. If @var{var} is undefined
|
as a string. @var{var} should be a string. If @var{var} is undefined
|
||||||
|
|
@ -1473,7 +1473,7 @@ most-positive-fixnum}).
|
||||||
Emacs provides several functions and primitives that return time,
|
Emacs provides several functions and primitives that return time,
|
||||||
both elapsed and processor time, used by the Emacs process.
|
both elapsed and processor time, used by the Emacs process.
|
||||||
|
|
||||||
@defun emacs-uptime &optional format
|
@deffn Command emacs-uptime &optional format
|
||||||
This function returns a string representing the Emacs
|
This function returns a string representing the Emacs
|
||||||
@dfn{uptime}---the elapsed wall-clock time this instance of Emacs is
|
@dfn{uptime}---the elapsed wall-clock time this instance of Emacs is
|
||||||
running. The string is formatted by @code{format-seconds} according
|
running. The string is formatted by @code{format-seconds} according
|
||||||
|
|
@ -1481,7 +1481,9 @@ to the optional argument @var{format}. For the available format
|
||||||
descriptors, see @ref{Time Parsing, format-seconds}. If @var{format}
|
descriptors, see @ref{Time Parsing, format-seconds}. If @var{format}
|
||||||
is @code{nil} or omitted, it defaults to @code{"%Y, %D, %H, %M,
|
is @code{nil} or omitted, it defaults to @code{"%Y, %D, %H, %M,
|
||||||
%z%S"}.
|
%z%S"}.
|
||||||
@end defun
|
|
||||||
|
When called interactively, it prints the uptime in the echo area.
|
||||||
|
@end deffn
|
||||||
|
|
||||||
@defun get-internal-run-time
|
@defun get-internal-run-time
|
||||||
This function returns the processor run time used by Emacs as a list
|
This function returns the processor run time used by Emacs as a list
|
||||||
|
|
@ -1508,10 +1510,11 @@ time, @code{get-internal-run-time} returns the same time as
|
||||||
@code{current-time}.
|
@code{current-time}.
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@defun emacs-init-time
|
@deffn Command emacs-init-time
|
||||||
This function returns the duration of the Emacs initialization
|
This function returns the duration of the Emacs initialization
|
||||||
(@pxref{Startup Summary}) in seconds, as a string.
|
(@pxref{Startup Summary}) in seconds, as a string. When called
|
||||||
@end defun
|
interactively, it prints the duration in the echo area.
|
||||||
|
@end deffn
|
||||||
|
|
||||||
@node Time Calculations
|
@node Time Calculations
|
||||||
@section Time Calculations
|
@section Time Calculations
|
||||||
|
|
@ -1946,15 +1949,12 @@ that Emacs and other programs can get the proper value, but others do
|
||||||
not. If Emacs has the wrong value, it makes decisions that are less
|
not. If Emacs has the wrong value, it makes decisions that are less
|
||||||
than optimal. To fix the problem, set @code{baud-rate}.
|
than optimal. To fix the problem, set @code{baud-rate}.
|
||||||
|
|
||||||
@defun baud-rate
|
@defun send-string-to-terminal string &optional terminal
|
||||||
This obsolete function returns the value of the variable
|
This function sends @var{string} to @var{terminal} without alteration.
|
||||||
@code{baud-rate}.
|
|
||||||
@end defun
|
|
||||||
|
|
||||||
@defun send-string-to-terminal string
|
|
||||||
This function sends @var{string} to the terminal without alteration.
|
|
||||||
Control characters in @var{string} have terminal-dependent effects.
|
Control characters in @var{string} have terminal-dependent effects.
|
||||||
This function operates only on text terminals.
|
This function operates only on text terminals. @var{terminal} may be
|
||||||
|
a terminal object, a frame, or @code{nil} for the selected frame's
|
||||||
|
terminal.
|
||||||
|
|
||||||
One use of this function is to define function keys on terminals that
|
One use of this function is to define function keys on terminals that
|
||||||
have downloadable function key definitions. For example, this is how (on
|
have downloadable function key definitions. For example, this is how (on
|
||||||
|
|
|
||||||
|
|
@ -979,8 +979,8 @@ The function returns @var{process}.
|
||||||
@end smallexample
|
@end smallexample
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@defun process-running-child-p process
|
@defun process-running-child-p &optional process
|
||||||
This function will tell you whether a subprocess has given control of
|
This function will tell you whether a @var{process} has given control of
|
||||||
its terminal to its own child process. The value is @code{t} if this is
|
its terminal to its own child process. The value is @code{t} if this is
|
||||||
true, or if Emacs cannot tell; it is @code{nil} if Emacs can be certain
|
true, or if Emacs cannot tell; it is @code{nil} if Emacs can be certain
|
||||||
that this is not so.
|
that this is not so.
|
||||||
|
|
@ -1074,7 +1074,6 @@ it the signal @code{SIGCONT}. This presumes that @var{process} was
|
||||||
stopped previously.
|
stopped previously.
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@c Emacs 19 feature
|
|
||||||
@defun signal-process process signal
|
@defun signal-process process signal
|
||||||
This function sends a signal to process @var{process}. The argument
|
This function sends a signal to process @var{process}. The argument
|
||||||
@var{signal} specifies which signal to send; it should be an integer.
|
@var{signal} specifies which signal to send; it should be an integer.
|
||||||
|
|
@ -2240,10 +2239,13 @@ process on the host), where it is not possible to make a new server on
|
||||||
that port.
|
that port.
|
||||||
@end table
|
@end table
|
||||||
|
|
||||||
@defun set-network-process-option process option value
|
@defun set-network-process-option process option value &optional no-error
|
||||||
This function sets or modifies a network option for network process
|
This function sets or modifies a network option for network process
|
||||||
@var{process}. See @code{make-network-process} for details of options
|
@var{process}. See @code{make-network-process} for details of options
|
||||||
@var{option} and their corresponding values @var{value}.
|
@var{option} and their corresponding values @var{value}. If
|
||||||
|
@var{no-error} is non-@code{nil}, this function returns @code{nil}
|
||||||
|
instead of signaling an error if @var{option} is not a supported
|
||||||
|
option. If the function successfully completes, it returns @code{t}.
|
||||||
|
|
||||||
The current setting of an option is available via the
|
The current setting of an option is available via the
|
||||||
@code{process-contact} function.
|
@code{process-contact} function.
|
||||||
|
|
|
||||||
|
|
@ -1182,17 +1182,17 @@ non-greedy repetition operators (@pxref{Regexp Special, non-greedy}).
|
||||||
This is because POSIX backtracking conflicts with the semantics of
|
This is because POSIX backtracking conflicts with the semantics of
|
||||||
non-greedy repetition.
|
non-greedy repetition.
|
||||||
|
|
||||||
@defun posix-search-forward regexp &optional limit noerror repeat
|
@deffn Command posix-search-forward regexp &optional limit noerror repeat
|
||||||
This is like @code{re-search-forward} except that it performs the full
|
This is like @code{re-search-forward} except that it performs the full
|
||||||
backtracking specified by the POSIX standard for regular expression
|
backtracking specified by the POSIX standard for regular expression
|
||||||
matching.
|
matching.
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@defun posix-search-backward regexp &optional limit noerror repeat
|
@deffn Command posix-search-backward regexp &optional limit noerror repeat
|
||||||
This is like @code{re-search-backward} except that it performs the full
|
This is like @code{re-search-backward} except that it performs the full
|
||||||
backtracking specified by the POSIX standard for regular expression
|
backtracking specified by the POSIX standard for regular expression
|
||||||
matching.
|
matching.
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@defun posix-looking-at regexp
|
@defun posix-looking-at regexp
|
||||||
This is like @code{looking-at} except that it performs the full
|
This is like @code{looking-at} except that it performs the full
|
||||||
|
|
|
||||||
|
|
@ -728,9 +728,12 @@ buffer is modified without obeying the hook, such as when using
|
||||||
@code{inhibit-modification-hooks}. For this reason, it is sometimes
|
@code{inhibit-modification-hooks}. For this reason, it is sometimes
|
||||||
necessary to flush the cache manually.
|
necessary to flush the cache manually.
|
||||||
|
|
||||||
@defun syntax-ppss-flush-cache beg
|
@defun syntax-ppss-flush-cache beg &rest ignored-args
|
||||||
This function flushes the cache used by @code{syntax-ppss}, starting at
|
This function flushes the cache used by @code{syntax-ppss}, starting
|
||||||
position @var{beg}.
|
at position @var{beg}. The remaining arguments, @var{ignored-args},
|
||||||
|
are ignored; this function accepts them so that it can be directly
|
||||||
|
used on hooks such as @code{before-change-functions} (@pxref{Change
|
||||||
|
Hooks}).
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
Major modes can make @code{syntax-ppss} run faster by specifying
|
Major modes can make @code{syntax-ppss} run faster by specifying
|
||||||
|
|
|
||||||
|
|
@ -2129,14 +2129,17 @@ For an example of using @code{current-column}, see the description of
|
||||||
@code{count-lines} in @ref{Text Lines}.
|
@code{count-lines} in @ref{Text Lines}.
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@defun move-to-column column &optional force
|
@deffn Command move-to-column column &optional force
|
||||||
This function moves point to @var{column} in the current line. The
|
This function moves point to @var{column} in the current line. The
|
||||||
calculation of @var{column} takes into account the widths of the
|
calculation of @var{column} takes into account the widths of the
|
||||||
displayed representations of the characters between the start of the
|
displayed representations of the characters between the start of the
|
||||||
line and point.
|
line and point.
|
||||||
|
|
||||||
If column @var{column} is beyond the end of the line, point moves to the
|
When called interactively, @var{column} is the value of prefix numeric
|
||||||
end of the line. If @var{column} is negative, point moves to the
|
argument. If @var{column} is not an integer, an error is signaled.
|
||||||
|
|
||||||
|
If column @var{column} is beyond the end of the line, point moves to
|
||||||
|
the end of the line. If @var{column} is negative, point moves to the
|
||||||
beginning of the line.
|
beginning of the line.
|
||||||
|
|
||||||
If it is impossible to move to column @var{column} because that is in
|
If it is impossible to move to column @var{column} because that is in
|
||||||
|
|
@ -2151,10 +2154,8 @@ The argument @var{force} also has an effect if the line isn't long
|
||||||
enough to reach column @var{column}; if it is @code{t}, that means to
|
enough to reach column @var{column}; if it is @code{t}, that means to
|
||||||
add whitespace at the end of the line to reach that column.
|
add whitespace at the end of the line to reach that column.
|
||||||
|
|
||||||
If @var{column} is not an integer, an error is signaled.
|
|
||||||
|
|
||||||
The return value is the column number actually moved to.
|
The return value is the column number actually moved to.
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@node Indentation
|
@node Indentation
|
||||||
@section Indentation
|
@section Indentation
|
||||||
|
|
@ -2235,15 +2236,17 @@ This command calls the function in @code{indent-line-function} to
|
||||||
indent the current line in a way appropriate for the current major mode.
|
indent the current line in a way appropriate for the current major mode.
|
||||||
@end deffn
|
@end deffn
|
||||||
|
|
||||||
@deffn Command indent-for-tab-command
|
@deffn Command indent-for-tab-command &optional rigid
|
||||||
This command calls the function in @code{indent-line-function} to indent
|
This command calls the function in @code{indent-line-function} to
|
||||||
the current line; however, if that function is
|
indent the current line; however, if that function is
|
||||||
@code{indent-to-left-margin}, @code{insert-tab} is called instead. (That
|
@code{indent-to-left-margin}, @code{insert-tab} is called instead.
|
||||||
is a trivial command that inserts a tab character.)
|
(That is a trivial command that inserts a tab character.) If
|
||||||
|
@var{rigid} is non-@code{nil}, this function also rigidly indents the
|
||||||
|
entire balanced expression that starts at the beginning of the current
|
||||||
|
line, to reflect change in indentation of the current line.
|
||||||
@end deffn
|
@end deffn
|
||||||
|
|
||||||
@deffn Command newline-and-indent
|
@deffn Command newline-and-indent
|
||||||
@comment !!SourceFile simple.el
|
|
||||||
This function inserts a newline, then indents the new line (the one
|
This function inserts a newline, then indents the new line (the one
|
||||||
following the newline just inserted) according to the major mode.
|
following the newline just inserted) according to the major mode.
|
||||||
|
|
||||||
|
|
@ -2274,7 +2277,7 @@ by @code{left-margin}.
|
||||||
This section describes commands that indent all the lines in the
|
This section describes commands that indent all the lines in the
|
||||||
region. They return unpredictable values.
|
region. They return unpredictable values.
|
||||||
|
|
||||||
@deffn Command indent-region start end to-column
|
@deffn Command indent-region start end &optional to-column
|
||||||
This command indents each nonblank line starting between @var{start}
|
This command indents each nonblank line starting between @var{start}
|
||||||
(inclusive) and @var{end} (exclusive). If @var{to-column} is
|
(inclusive) and @var{end} (exclusive). If @var{to-column} is
|
||||||
@code{nil}, @code{indent-region} indents each nonblank line by calling
|
@code{nil}, @code{indent-region} indents each nonblank line by calling
|
||||||
|
|
@ -2312,7 +2315,6 @@ a different meaning and does not use this variable.
|
||||||
@end defvar
|
@end defvar
|
||||||
|
|
||||||
@deffn Command indent-rigidly start end count
|
@deffn Command indent-rigidly start end count
|
||||||
@comment !!SourceFile indent.el
|
|
||||||
This command indents all lines starting between @var{start}
|
This command indents all lines starting between @var{start}
|
||||||
(inclusive) and @var{end} (exclusive) sideways by @var{count} columns.
|
(inclusive) and @var{end} (exclusive) sideways by @var{count} columns.
|
||||||
This ``preserves the shape'' of the affected region, moving it as a
|
This ``preserves the shape'' of the affected region, moving it as a
|
||||||
|
|
@ -2328,13 +2330,13 @@ In Mail mode, @kbd{C-c C-y} (@code{mail-yank-original}) uses
|
||||||
replied to.
|
replied to.
|
||||||
@end deffn
|
@end deffn
|
||||||
|
|
||||||
@defun indent-code-rigidly start end columns &optional nochange-regexp
|
@deffn Command indent-code-rigidly start end columns &optional nochange-regexp
|
||||||
This is like @code{indent-rigidly}, except that it doesn't alter lines
|
This is like @code{indent-rigidly}, except that it doesn't alter lines
|
||||||
that start within strings or comments.
|
that start within strings or comments.
|
||||||
|
|
||||||
In addition, it doesn't alter a line if @var{nochange-regexp} matches at
|
In addition, it doesn't alter a line if @var{nochange-regexp} matches at
|
||||||
the beginning of the line (if @var{nochange-regexp} is non-@code{nil}).
|
the beginning of the line (if @var{nochange-regexp} is non-@code{nil}).
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@node Relative Indent
|
@node Relative Indent
|
||||||
@subsection Indentation Relative to Previous Lines
|
@subsection Indentation Relative to Previous Lines
|
||||||
|
|
@ -3867,7 +3869,7 @@ ThXs Xs the contents of the buffer before.
|
||||||
@end example
|
@end example
|
||||||
@end defun
|
@end defun
|
||||||
|
|
||||||
@defun translate-region start end table
|
@deffn Command translate-region start end table
|
||||||
This function applies a translation table to the characters in the
|
This function applies a translation table to the characters in the
|
||||||
buffer between positions @var{start} and @var{end}.
|
buffer between positions @var{start} and @var{end}.
|
||||||
|
|
||||||
|
|
@ -3881,7 +3883,7 @@ The return value of @code{translate-region} is the number of
|
||||||
characters that were actually changed by the translation. This does
|
characters that were actually changed by the translation. This does
|
||||||
not count characters that were mapped into themselves in the
|
not count characters that were mapped into themselves in the
|
||||||
translation table.
|
translation table.
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@node Registers
|
@node Registers
|
||||||
@section Registers
|
@section Registers
|
||||||
|
|
@ -3956,27 +3958,6 @@ expect only certain data types. The return value is @var{value}.
|
||||||
This command displays what is contained in register @var{reg}.
|
This command displays what is contained in register @var{reg}.
|
||||||
@end deffn
|
@end deffn
|
||||||
|
|
||||||
@ignore
|
|
||||||
@deffn Command point-to-register reg
|
|
||||||
This command stores both the current location of point and the current
|
|
||||||
buffer in register @var{reg} as a marker.
|
|
||||||
@end deffn
|
|
||||||
|
|
||||||
@deffn Command jump-to-register reg
|
|
||||||
@deffnx Command register-to-point reg
|
|
||||||
@comment !!SourceFile register.el
|
|
||||||
This command restores the status recorded in register @var{reg}.
|
|
||||||
|
|
||||||
If @var{reg} contains a marker, it moves point to the position stored in
|
|
||||||
the marker. Since both the buffer and the location within the buffer
|
|
||||||
are stored by the @code{point-to-register} function, this command can
|
|
||||||
switch you to another buffer.
|
|
||||||
|
|
||||||
If @var{reg} contains a window configuration or a frame configuration.
|
|
||||||
@code{jump-to-register} restores that configuration.
|
|
||||||
@end deffn
|
|
||||||
@end ignore
|
|
||||||
|
|
||||||
@deffn Command insert-register reg &optional beforep
|
@deffn Command insert-register reg &optional beforep
|
||||||
This command inserts contents of register @var{reg} into the current
|
This command inserts contents of register @var{reg} into the current
|
||||||
buffer.
|
buffer.
|
||||||
|
|
@ -3996,43 +3977,6 @@ a rectangle (a list), currently useless things happen. This may be
|
||||||
changed in the future.
|
changed in the future.
|
||||||
@end deffn
|
@end deffn
|
||||||
|
|
||||||
@ignore
|
|
||||||
@deffn Command copy-to-register reg start end &optional delete-flag
|
|
||||||
This command copies the region from @var{start} to @var{end} into
|
|
||||||
register @var{reg}. If @var{delete-flag} is non-@code{nil}, it deletes
|
|
||||||
the region from the buffer after copying it into the register.
|
|
||||||
@end deffn
|
|
||||||
|
|
||||||
@deffn Command prepend-to-register reg start end &optional delete-flag
|
|
||||||
This command prepends the region from @var{start} to @var{end} into
|
|
||||||
register @var{reg}. If @var{delete-flag} is non-@code{nil}, it deletes
|
|
||||||
the region from the buffer after copying it to the register.
|
|
||||||
@end deffn
|
|
||||||
|
|
||||||
@deffn Command append-to-register reg start end &optional delete-flag
|
|
||||||
This command appends the region from @var{start} to @var{end} to the
|
|
||||||
text already in register @var{reg}. If @var{delete-flag} is
|
|
||||||
non-@code{nil}, it deletes the region from the buffer after copying it
|
|
||||||
to the register.
|
|
||||||
@end deffn
|
|
||||||
|
|
||||||
@deffn Command copy-rectangle-to-register reg start end &optional delete-flag
|
|
||||||
This command copies a rectangular region from @var{start} to @var{end}
|
|
||||||
into register @var{reg}. If @var{delete-flag} is non-@code{nil}, it
|
|
||||||
deletes the region from the buffer after copying it to the register.
|
|
||||||
@end deffn
|
|
||||||
|
|
||||||
@deffn Command window-configuration-to-register reg
|
|
||||||
This function stores the window configuration of the selected frame in
|
|
||||||
register @var{reg}.
|
|
||||||
@end deffn
|
|
||||||
|
|
||||||
@deffn Command frame-configuration-to-register reg
|
|
||||||
This function stores the current frame configuration in register
|
|
||||||
@var{reg}.
|
|
||||||
@end deffn
|
|
||||||
@end ignore
|
|
||||||
|
|
||||||
@node Transposition
|
@node Transposition
|
||||||
@section Transposition of Text
|
@section Transposition of Text
|
||||||
|
|
||||||
|
|
@ -4067,7 +4011,7 @@ manner.
|
||||||
}2045. This section describes the functions for
|
}2045. This section describes the functions for
|
||||||
converting to and from this code.
|
converting to and from this code.
|
||||||
|
|
||||||
@defun base64-encode-region beg end &optional no-line-break
|
@deffn Command base64-encode-region beg end &optional no-line-break
|
||||||
This function converts the region from @var{beg} to @var{end} into base
|
This function converts the region from @var{beg} to @var{end} into base
|
||||||
64 code. It returns the length of the encoded text. An error is
|
64 code. It returns the length of the encoded text. An error is
|
||||||
signaled if a character in the region is multibyte, i.e.@: in a
|
signaled if a character in the region is multibyte, i.e.@: in a
|
||||||
|
|
@ -4079,9 +4023,9 @@ Normally, this function inserts newline characters into the encoded
|
||||||
text, to avoid overlong lines. However, if the optional argument
|
text, to avoid overlong lines. However, if the optional argument
|
||||||
@var{no-line-break} is non-@code{nil}, these newlines are not added, so
|
@var{no-line-break} is non-@code{nil}, these newlines are not added, so
|
||||||
the output is just one long line.
|
the output is just one long line.
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@defun base64-encode-string string &optional no-line-break
|
@deffn Command base64-encode-string string &optional no-line-break
|
||||||
This function converts the string @var{string} into base 64 code. It
|
This function converts the string @var{string} into base 64 code. It
|
||||||
returns a string containing the encoded text. As for
|
returns a string containing the encoded text. As for
|
||||||
@code{base64-encode-region}, an error is signaled if a character in the
|
@code{base64-encode-region}, an error is signaled if a character in the
|
||||||
|
|
@ -4091,7 +4035,7 @@ Normally, this function inserts newline characters into the encoded
|
||||||
text, to avoid overlong lines. However, if the optional argument
|
text, to avoid overlong lines. However, if the optional argument
|
||||||
@var{no-line-break} is non-@code{nil}, these newlines are not added, so
|
@var{no-line-break} is non-@code{nil}, these newlines are not added, so
|
||||||
the result string is just one long line.
|
the result string is just one long line.
|
||||||
@end defun
|
@end deffn
|
||||||
|
|
||||||
@defun base64-decode-region beg end
|
@defun base64-decode-region beg end
|
||||||
This function converts the region from @var{beg} to @var{end} from base
|
This function converts the region from @var{beg} to @var{end} from base
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue