Misc small lispref fixes.
* windows.texi (Displaying Buffers): pop-to-buffer is not a command. * text.texi (Parsing HTML): Update for function name changes. * syntax.texi (Syntax Flags): Small fix. * keymaps.texi (Active Keymaps): Typo fix. (Changing Key Bindings): Grammar fix. * frames.texi (Minibuffers and Frames): Grammar fix. (Window System Selections): x-select-enable-clipboard now defaults to t. * customize.texi (Common Keywords): * display.texi (Abstract Display): * modes.texi (Auto-Indentation): * nonascii.texi (Converting Representations): Typo fixes. * control.texi (Examples of Catch): Call it "goto" not "go to".
This commit is contained in:
parent
d573f59acf
commit
35a30759f3
11 changed files with 53 additions and 24 deletions
|
@ -1,3 +1,24 @@
|
|||
2011-05-19 Nix <nix@esperi.org.uk>
|
||||
|
||||
* windows.texi (Displaying Buffers): pop-to-buffer is not a command.
|
||||
|
||||
* text.texi (Parsing HTML): Update for function name changes.
|
||||
|
||||
* syntax.texi (Syntax Flags): Small fix.
|
||||
|
||||
* keymaps.texi (Active Keymaps): Typo fix.
|
||||
(Changing Key Bindings): Grammar fix.
|
||||
|
||||
* frames.texi (Minibuffers and Frames): Grammar fix.
|
||||
(Window System Selections): x-select-enable-clipboard now defaults to t.
|
||||
|
||||
* customize.texi (Common Keywords):
|
||||
* display.texi (Abstract Display):
|
||||
* modes.texi (Auto-Indentation):
|
||||
* nonascii.texi (Converting Representations): Typo fixes.
|
||||
|
||||
* control.texi (Examples of Catch): Call it "goto" not "go to".
|
||||
|
||||
2011-05-14 Eli Zaretskii <eliz@gnu.org>
|
||||
|
||||
* nonascii.texi (Character Properties): Fix inconsistencies with
|
||||
|
|
|
@ -623,7 +623,7 @@ error is signaled with data @code{(@var{tag} @var{value})}.
|
|||
@subsection Examples of @code{catch} and @code{throw}
|
||||
|
||||
One way to use @code{catch} and @code{throw} is to exit from a doubly
|
||||
nested loop. (In most languages, this would be done with a ``go to.'')
|
||||
nested loop. (In most languages, this would be done with a ``goto.'')
|
||||
Here we compute @code{(foo @var{i} @var{j})} for @var{i} and @var{j}
|
||||
varying from 0 to 9:
|
||||
|
||||
|
|
|
@ -174,7 +174,7 @@ For example, the MH-E package updates this alist with the following:
|
|||
|
||||
The value of @var{package} needs to be unique and it needs to match
|
||||
the @var{package} value appearing in the @code{:package-version}
|
||||
keyword. Since the user might see the value in a error message, a good
|
||||
keyword. Since the user might see the value in an error message, a good
|
||||
choice is the official name of the package, such as MH-E or Gnus.
|
||||
@end defvar
|
||||
|
||||
|
|
|
@ -5201,7 +5201,7 @@ element value into the current buffer.
|
|||
Typically, you define an ewoc with @code{ewoc-create}, and then pass
|
||||
the resulting ewoc structure to other functions in the Ewoc package to
|
||||
build nodes within it, and display it in the buffer. Once it is
|
||||
displayed in the buffer, other functions determine the correspondance
|
||||
displayed in the buffer, other functions determine the correspondence
|
||||
between buffer positions and nodes, move point from one node's textual
|
||||
representation to another, and so forth. @xref{Abstract Display
|
||||
Functions}.
|
||||
|
|
|
@ -1368,7 +1368,7 @@ minibuffer-window}).
|
|||
|
||||
However, you can also create a frame with no minibuffer. Such a frame
|
||||
must use the minibuffer window of some other frame. When you create the
|
||||
frame, you can specify explicitly the minibuffer window to use (in some
|
||||
frame, you can explicitly specify the minibuffer window to use (in some
|
||||
other frame). If you don't, then the minibuffer is found in the frame
|
||||
which is the value of the variable @code{default-minibuffer-frame}. Its
|
||||
value should be a frame that does have a minibuffer.
|
||||
|
@ -2018,8 +2018,8 @@ clipboard as empty.
|
|||
If this is non-@code{nil}, the Emacs yank functions consult the
|
||||
clipboard before the primary selection, and the kill functions store in
|
||||
the clipboard as well as the primary selection. Otherwise they do not
|
||||
access the clipboard at all. The default is @code{nil} on most systems,
|
||||
but @code{t} on MS-Windows.
|
||||
access the clipboard at all. The default is @code{t} on systems with
|
||||
clipboards.
|
||||
@end defopt
|
||||
|
||||
@node Drag and Drop
|
||||
|
|
|
@ -686,7 +686,7 @@ bindings, as in @code{lookup-key} (@pxref{Functions for Key Lookup}).
|
|||
|
||||
When commands are remapped (@pxref{Remapping Commands}),
|
||||
@code{key-binding} normally processes command remappings so as to
|
||||
returns the remapped command that will actually be executed. However,
|
||||
return the remapped command that will actually be executed. However,
|
||||
if @var{no-remap} is non-@code{nil}, @code{key-binding} ignores
|
||||
remappings and returns the binding directly specified for @var{key}.
|
||||
|
||||
|
@ -1239,7 +1239,7 @@ local map, that usually affects all buffers using the same major mode.
|
|||
The @code{global-set-key} and @code{local-set-key} functions are
|
||||
convenient interfaces for these operations (@pxref{Key Binding
|
||||
Commands}). You can also use @code{define-key}, a more general
|
||||
function; then you must specify explicitly the map to change.
|
||||
function; then you must explicitly specify the map to change.
|
||||
|
||||
When choosing the key sequences for Lisp programs to rebind, please
|
||||
follow the Emacs conventions for use of various keys (@pxref{Key
|
||||
|
|
|
@ -3256,7 +3256,7 @@ reasonably fast.
|
|||
@end defvar
|
||||
|
||||
@node Auto-Indentation
|
||||
@section Auto-indention of code
|
||||
@section Auto-indentation of code
|
||||
|
||||
For programming languages, an important feature of a major mode is to
|
||||
provide automatic indentation. This is controlled in Emacs by
|
||||
|
|
|
@ -201,7 +201,7 @@ characters.
|
|||
@defun byte-to-string byte
|
||||
@cindex byte to string
|
||||
This function returns a unibyte string containing a single byte of
|
||||
character data, @var{character}. It signals a error if
|
||||
character data, @var{character}. It signals an error if
|
||||
@var{character} is not an integer between 0 and 255.
|
||||
@end defun
|
||||
|
||||
|
|
|
@ -374,7 +374,7 @@ character, @samp{/}, does not have the @samp{b} flag.
|
|||
|
||||
@item @samp{*/}
|
||||
This is a comment-end sequence for ``b'' style because the first
|
||||
character, @samp{*}, does have the @samp{b} flag.
|
||||
character, @samp{*}, has the @samp{b} flag.
|
||||
|
||||
@item newline
|
||||
This is a comment-end sequence for ``a'' style, because the newline
|
||||
|
|
|
@ -4099,17 +4099,16 @@ coding instead.
|
|||
@node Parsing HTML
|
||||
@section Parsing HTML
|
||||
@cindex parsing html
|
||||
@cindex parsing xml
|
||||
|
||||
Emacs provides an interface to the @code{libxml2} library via two
|
||||
functions: @code{html-parse-buffer} and @code{xml-parse-buffer}. The
|
||||
HTML function will parse ``real world'' HTML and try to return a
|
||||
sensible parse tree, while the XML function is somewhat stricter about
|
||||
syntax.
|
||||
@defun libxml-parse-html-region start end &optional base-url
|
||||
This function provides HTML parsing via the @code{libxml2} library.
|
||||
It parses ``real world'' HTML and tries to return a sensible parse tree
|
||||
regardless.
|
||||
|
||||
They both take a two optional parameter. The first is a buffer, and
|
||||
the second is a base URL to be used to expand relative URLs in the
|
||||
document, if any.
|
||||
In addition to @var{start} and @var{end} (specifying the start and end
|
||||
of the region to act on), it takes an optional parameter,
|
||||
@var{base-url}, which is used to expand relative URLs in the document,
|
||||
if any.
|
||||
|
||||
Here's an example demonstrating the structure of the parsed data you
|
||||
get out. Given this HTML document:
|
||||
|
@ -4138,12 +4137,21 @@ values.
|
|||
|
||||
Attributes are coded the same way as child nodes, but with @samp{:} as
|
||||
the first character.
|
||||
@end defun
|
||||
|
||||
@cindex parsing xml
|
||||
@defun libxml-parse-xml-region start end &optional base-url
|
||||
|
||||
This is much the same as @code{libxml-parse-html-region} above, but
|
||||
operates on XML instead of HTML, and is correspondingly stricter about
|
||||
syntax.
|
||||
@end defun
|
||||
|
||||
@node Atomic Changes
|
||||
@section Atomic Change Groups
|
||||
@cindex atomic changes
|
||||
|
||||
In data base terminology, an @dfn{atomic} change is an indivisible
|
||||
In database terminology, an @dfn{atomic} change is an indivisible
|
||||
change---it can succeed entirely or it can fail entirely, but it
|
||||
cannot partly succeed. A Lisp program can make a series of changes to
|
||||
one or several buffers as an @dfn{atomic change group}, meaning that
|
||||
|
|
|
@ -826,8 +826,8 @@ This function updates the buffer list just like @code{switch-to-buffer}
|
|||
unless @var{norecord} is non-@code{nil}.
|
||||
@end deffn
|
||||
|
||||
@deffn Command pop-to-buffer buffer-or-name &optional other-window norecord
|
||||
This command makes @var{buffer-or-name} the current buffer and switches
|
||||
@defun pop-to-buffer buffer-or-name &optional other-window norecord
|
||||
This function makes @var{buffer-or-name} the current buffer and switches
|
||||
to it in some window, preferably not the window previously selected.
|
||||
The ``popped-to'' window becomes the selected window. Its frame is
|
||||
given the X server's focus, if possible; see @ref{Input Focus}. The
|
||||
|
@ -866,7 +866,7 @@ All the variables that affect @code{display-buffer} affect
|
|||
|
||||
This function updates the buffer list just like @code{switch-to-buffer}
|
||||
unless @var{norecord} is non-@code{nil}.
|
||||
@end deffn
|
||||
@end defun
|
||||
|
||||
@deffn Command replace-buffer-in-windows &optional buffer-or-name
|
||||
This function replaces @var{buffer-or-name} in all windows displaying
|
||||
|
|
Loading…
Add table
Reference in a new issue