-2013-07-05 Glenn Morris <rgm@gnu.org>
++2013-07-06 Glenn Morris <rgm@gnu.org>
+
+ * emacs-lisp-intro.texi (Top):
+ Move WWW_GNU_ORG section outside @copying, update URL.
+
2013-07-03 Glenn Morris <rgm@gnu.org>
* emacs-lisp-intro.texi (edebug): Fix cross-references.
-2013-03-12 Glenn Morris <rgm@gnu.org>
+2013-06-19 Glenn Morris <rgm@gnu.org>
- * emacs-lisp-intro.texi: Add some stuff specific to www.gnu.org.
+ * Makefile.in (dist): Edit more configure variables. (Bug#14660)
+ Try to check that we do not miss any in future.
+
+2013-04-24 Eli Zaretskii <eliz@gnu.org>
+
+ * makefile.w32-in (INFO_OPTS): Add "-I$(emacsdir)" to fix last
+ commit.
+
+2013-04-24 Glenn Morris <rgm@gnu.org>
+
+ * emacs-lisp-intro.texi (emacsver.texi): Include it.
+ (copying): For non-printed versions, uses Emacs version rather
+ than that of the printed book.
+ (Complications, Lisp macro, defvar and asterisk, defcustom): Copyedits.
+ * Makefile.in (emacsdir): New variable..
+ (MAKEINFO_OPTS, ENVADD): Add $emacsdir.
+ (srcs): Add emacsver.texi.
+ (dist): Include emacsver.texi. Edit emacsdir.
+ * makefile.w32-in (emacsdir): New variable.
+ (INFO_SOURCES): Add emacsver.texi.
+ (ENVADD): Add $emacsdir (and $texinfodir).
+
+2013-04-23 Xue Fuqiao <xfq.free@gmail.com>
+
+ * emacs-lisp-intro.texi (Complications, defvar, Writing Defuns)
+ (Prevent confusion, Determining the Element, lambda): Refine the
+ doc about Lisp macros, reported by Glenn Morris.
+
+2013-04-21 Xue Fuqiao <xfq.free@gmail.com>
-2013-03-11 Glenn Morris <rgm@gnu.org>
+ * emacs-lisp-intro.texi (defcustom, defun)
+ (simplified-beginning-of-buffer, defvar, Building Robots, Review)
+ (save-excursion): `defun' and `defcustom' are now macros rather
+ than special forms. (Bug#13853)
- * Version 24.3 released.
+2013-03-16 Glenn Morris <rgm@gnu.org>
+
+ * emacs-lisp-intro.texi: Add some stuff specific to www.gnu.org.
2013-03-03 Glenn Morris <rgm@gnu.org>
(${buildinfodir}/eintr$(INFO_EXT), emacs-lisp-intro.dvi)
(emacs-lisp-intro.pdf, emacs-lisp-intro.html):
Use $srcs for dependencies.
+
+2012-12-14 Paul Eggert <eggert@cs.ucla.edu>
+
+ Fix permissions bugs with setgid directories etc. (Bug#13125)
+ * emacs-lisp-intro.texi (Files List):
+ directory-files-and-attributes now outputs t for attribute that's
+ now a placeholder.
+
+2012-12-06 Paul Eggert <eggert@cs.ucla.edu>
+
+ * doclicense.texi: Update to latest version from FSF.
+ These are just minor editorial changes.
+
+2012-11-24 Paul Eggert <eggert@cs.ucla.edu>
+
+ * doclicense.texi: Update to latest version from FSF.
+ These are just minor editorial changes.
2012-10-24 Paul Eggert <eggert@penguin.cs.ucla.edu>
@syncodeindex fn cp
@finalout
-@c ---------
+@include emacsver.texi
+
+@c ================ How to Print a Book in Various Sizes ================
+
+@c This book can be printed in any of three different sizes.
+@c Set the following @-commands appropriately.
+
+@c 7 by 9.25 inches:
+@c @smallbook
+@c @clear largebook
+
+@c 8.5 by 11 inches:
+@c @c smallbook
+@c @set largebook
+
+@c European A4 size paper:
+@c @c smallbook
+@c @afourpaper
+@c @set largebook
+
+@c (Note: if you edit the book so as to change the length of the
+@c table of contents, you may have to change the value of `pageno' below.)
+
@c <<<< For hard copy printing, this file is now
@c set for smallbook, which works for all sizes
@c of paper, and with PostScript figures >>>>
+
@set smallbook
@ifset smallbook
@smallbook
@clear largebook
@end ifset
+
+@c ================ Included Figures ================
+
+@c If you clear this, the figures will be printed as ASCII diagrams
+@c rather than PostScript/PDF.
+@c (This is not relevant to Info, since Info only handles ASCII.)
@set print-postscript-figures
-@c set largebook
@c clear print-postscript-figures
-@c ---------
@comment %**end of header
\global\hbadness=6666 % don't worry about not-too-underfull boxes
@end tex
+@c These refer to the printed book sold by the FSF.
@set edition-number 3.10
@set update-date 28 October 2009
-@ignore
- ## Summary of shell commands to create various output formats:
-
- pushd /usr/local/src/emacs/lispintro/
- ## pushd /u/intro/
-
- ## Info output
- makeinfo --paragraph-indent=0 --verbose emacs-lisp-intro.texi
-
- ## ;; (progn (when (bufferp (get-buffer "*info*")) (kill-buffer "*info*")) (info "/usr/local/src/emacs/info/eintr"))
-
- ## DVI output
- texi2dvi emacs-lisp-intro.texi
-
- ## xdvi -margins 24pt -topmargin 4pt -offsets 24pt -geometry 760x1140 -s 5 -useTeXpages -mousemode 1 emacs-lisp-intro.dvi &
-
- ## HTML output
- makeinfo --html --no-split --verbose emacs-lisp-intro.texi
-
- ## galeon emacs-lisp-intro.html
-
- ## Plain text output
- makeinfo --fill-column=70 --no-split --paragraph-indent=0 \
- --verbose --no-headers --output=emacs-lisp-intro.txt emacs-lisp-intro.texi
-
- popd
-
-# as user `root'
-# insert thumbdrive
- mtusb # mount -v -t ext3 /dev/sda /mnt
- cp -v /u/intro/emacs-lisp-intro.texi /mnt/backup/intro/emacs-lisp-intro.texi
- umtusb # umount -v /mnt
-# remove thumbdrive
-
- ## Other shell commands
-
- pushd /usr/local/src/emacs/lispintro/
- ## pushd /u/intro/
-
- ## PDF
- texi2dvi --pdf emacs-lisp-intro.texi
- # xpdf emacs-lisp-intro.pdf &
-
- ## DocBook -- note file extension
- makeinfo --docbook --no-split --paragraph-indent=0 \
- --verbose --output=emacs-lisp-intro.docbook emacs-lisp-intro.texi
-
- ## XML with a Texinfo DTD -- note file extension
- makeinfo --xml --no-split --paragraph-indent=0 \
- --verbose --output=emacs-lisp-intro.texinfoxml emacs-lisp-intro.texi
-
- ## PostScript (needs DVI)
- # gv emacs-lisp-intro.ps &
- # Create DVI if we lack it
- # texi2dvi emacs-lisp-intro.texi
- dvips emacs-lisp-intro.dvi -o emacs-lisp-intro.ps
-
- ## RTF (needs HTML)
- # Use OpenOffice to view RTF
- # Create HTML if we lack it
- # makeinfo --no-split --html emacs-lisp-intro.texi
- /usr/local/src/html2rtf.pl emacs-lisp-intro.html
-
- ## LaTeX (needs RTF)
- /usr/bin/rtf2latex emacs-lisp-intro.rtf
-
- popd
-
-@end ignore
-
-@c ================ Included Figures ================
-
-@c Set print-postscript-figures if you print PostScript figures.
-@c If you clear this, the ten figures will be printed as ASCII diagrams.
-@c (This is not relevant to Info, since Info only handles ASCII.)
-@c Your site may require editing changes to print PostScript; in this
-@c case, search for `print-postscript-figures' and make appropriate changes.
-
-@c ================ How to Create an Info file ================
-
-@c If you have `makeinfo' installed, run the following command
-
-@c makeinfo emacs-lisp-intro.texi
-
-@c or, if you want a single, large Info file, and no paragraph indents:
-@c makeinfo --no-split --paragraph-indent=0 --verbose emacs-lisp-intro.texi
-
-@c After creating the Info file, edit your Info `dir' file, if the
-@c `dircategory' section below does not enable your system to
-@c install the manual automatically.
-@c (The `dir' file is often in the `/usr/local/share/info/' directory.)
-
-@c ================ How to Create an HTML file ================
-
-@c To convert to HTML format
-@c makeinfo --html --no-split --verbose emacs-lisp-intro.texi
-
-@c ================ How to Print a Book in Various Sizes ================
-
-@c This book can be printed in any of three different sizes.
-@c In the above header, set @-commands appropriately.
-
-@c 7 by 9.25 inches:
-@c @smallbook
-@c @clear largebook
-
-@c 8.5 by 11 inches:
-@c @c smallbook
-@c @set largebook
-
-@c European A4 size paper:
-@c @c smallbook
-@c @afourpaper
-@c @set largebook
-
-@c ================ How to Typeset and Print ================
-
-@c If you do not include PostScript figures, run either of the
-@c following command sequences, or similar commands suited to your
-@c system:
-
-@c texi2dvi emacs-lisp-intro.texi
-@c lpr -d emacs-lisp-intro.dvi
-
-@c or else:
-
-@c tex emacs-lisp-intro.texi
-@c texindex emacs-lisp-intro.??
-@c tex emacs-lisp-intro.texi
-@c lpr -d emacs-lisp-intro.dvi
-
-@c If you include the PostScript figures, and you have old software,
-@c you may need to convert the .dvi file to a .ps file before
-@c printing. Run either of the following command sequences, or one
-@c similar:
-@c
-@c dvips -f < emacs-lisp-intro.dvi > emacs-lisp-intro.ps
-@c
-@c or else:
-@c
-@c postscript -p < emacs-lisp-intro.dvi > emacs-lisp-intro.ps
-@c
-
-@c (Note: if you edit the book so as to change the length of the
-@c table of contents, you may have to change the value of `pageno' below.)
-
-@c ================ End of Formatting Sections ================
-
@c For next or subsequent edition:
@c create function using with-output-to-temp-buffer
@c create a major mode, with keymaps
This is an @cite{Introduction to Programming in Emacs Lisp}, for
people who are not programmers.
@sp 1
+@iftex
Edition @value{edition-number}, @value{update-date}
- @ifset WWW_GNU_ORG
- @html
- <p>The homepage for GNU Emacs is at
- <a href="http://www.gnu.org/software/emacs/">http://www.gnu.org/software/emacs/</a>.
- <br>To view this manual in other formats, click
- <a href="/software/emacs/emacs-lisp-intro/emacs-lisp-intro.html">here</a>.
- @end html
- @end ifset
+@end iftex
+@ifnottex
+Distributed with Emacs version @value{EMACSVER}.
+@end ifnottex
@sp 1
Copyright @copyright{} 1990--1995, 1997, 2001--2013 Free Software
Foundation, Inc.
@iftex
Published by the:@*
-GNU Press, @hfill @uref{http://www.fsf.org/campaigns/gnu-press/}@*
+GNU Press, @hfill @uref{http://www.fsf.org/licensing/gnu-press/}@*
a division of the @hfill email: @email{sales@@fsf.org}@*
Free Software Foundation, Inc. @hfill Tel: +1 (617) 542-5942@*
51 Franklin Street, Fifth Floor @hfill Fax: +1 (617) 542-2652@*
@end iftex
@ifnottex
-Published by the:
+Printed copies available from @uref{http://shop.fsf.org/}. Published by:
@example
-GNU Press, http://www.fsf.org/campaigns/gnu-press/
+GNU Press, http://www.fsf.org/licensing/gnu-press/
a division of the email: sales@@fsf.org
Free Software Foundation, Inc. Tel: +1 (617) 542-5942
51 Franklin Street, Fifth Floor Fax: +1 (617) 542-2652
@end ifnottex
@sp 1
-@c Printed copies are available from @uref{http://shop.fsf.org/} for $35 each.@*
ISBN 1-882114-43-4
Permission is granted to copy, distribute and/or modify this document
@node Top
@top An Introduction to Programming in Emacs Lisp
+ @ifset WWW_GNU_ORG
+ @html
+ <p>The homepage for GNU Emacs is at
+ <a href="/software/emacs/">http://www.gnu.org/software/emacs/</a>.<br>
+ To view this manual in other formats, click
+ <a href="/software/emacs/manual/eintr.html">here</a>.
+ @end html
+ @end ifset
+
@insertcopying
This master menu first lists each chapter and index; then it lists
How To Write Function Definitions
* Primitive Functions::
-* defun:: The @code{defun} special form.
+* defun:: The @code{defun} macro.
* Install:: Install a function definition.
* Interactive:: Making a function interactive.
* Interactive Options:: Different options for @code{interactive}.
in the section on variables. (@xref{Variables}.)
@cindex Special form
-The second complication occurs because some functions are unusual and do
-not work in the usual manner. Those that don't are called @dfn{special
-forms}. They are used for special jobs, like defining a function, and
-there are not many of them. In the next few chapters, you will be
-introduced to several of the more important special forms.
-
-The third and final complication is this: if the function that the
+The second complication occurs because some functions are unusual and
+do not work in the usual manner. Those that don't are called
+@dfn{special forms}. They are used for special jobs, like defining a
+function, and there are not many of them. In the next few chapters,
+you will be introduced to several of the more important special forms.
+
+As well as special forms, there are also @dfn{macros}. A macro
+is a construct defined in Lisp, which differs from a function in that it
+translates a Lisp expression into another expression that is to be
+evaluated in place of the original expression. (@xref{Lisp macro}.)
+
+For the purposes of this introduction, you do not need to worry too much
+about whether something is a special form, macro, or ordinary function.
+For example, @code{if} is a special form (@pxref{if}), but @code{when}
+is a macro (@pxref{Lisp macro}). In earlier versions of Emacs,
+@code{defun} was a special form, but now it is a macro (@pxref{defun}).
+It still behaves in the same way.
+
+The final complication is this: if the function that the
Lisp interpreter is looking at is not a special form, and if it is part
of a list, the Lisp interpreter looks to see whether the list has a list
inside of it. If there is an inner list, the Lisp interpreter first
@menu
* Primitive Functions::
-* defun:: The @code{defun} special form.
+* defun:: The @code{defun} macro.
* Install:: Install a function definition.
* Interactive:: Making a function interactive.
* Interactive Options:: Different options for @code{interactive}.
function is written in Emacs Lisp or C.
@node defun
-@section The @code{defun} Special Form
+@section The @code{defun} Macro
@findex defun
-@cindex Special form of @code{defun}
@cindex @samp{function definition} defined
In Lisp, a symbol such as @code{mark-whole-buffer} has code attached to
it that tells the computer what to do when the function is called.
This code is called the @dfn{function definition} and is created by
evaluating a Lisp expression that starts with the symbol @code{defun}
-(which is an abbreviation for @emph{define function}). Because
-@code{defun} does not evaluate its arguments in the usual way, it is
-called a @dfn{special form}.
+(which is an abbreviation for @emph{define function}).
In subsequent sections, we will look at function definitions from the
Emacs source code, such as @code{mark-whole-buffer}. In this section,
name outside the @code{let} expression. This is like understanding
that whenever your host refers to `the house', he means his house, not
yours. (Symbols used in argument lists work the same way.
-@xref{defun, , The @code{defun} Special Form}.)
+@xref{defun, , The @code{defun} Macro}.)
Local variables created by a @code{let} expression retain their value
@emph{only} within the @code{let} expression itself (and within
@findex point
@findex mark
-The @code{save-excursion} function is the fourth and final special form
+The @code{save-excursion} function is the third and final special form
that we will discuss in this chapter.
In Emacs Lisp programs used for editing, the @code{save-excursion}
@node Review
@section Review
-In the last few chapters we have introduced a fair number of functions
-and special forms. Here they are described in brief, along with a few
-similar functions that have not been mentioned yet.
+In the last few chapters we have introduced a macro and a fair number
+of functions and special forms. Here they are described in brief,
+along with a few similar functions that have not been mentioned yet.
@table @code
@item eval-last-sexp
current buffer. This command is normally bound to @kbd{C-x C-e}.
@item defun
-Define function. This special form has up to five parts: the name,
-a template for the arguments that will be passed to the function,
-documentation, an optional interactive declaration, and the body of the
-definition.
+Define function. This macro has up to five parts: the name, a
+template for the arguments that will be passed to the function,
+documentation, an optional interactive declaration, and the body of
+the definition.
@need 1250
For example, in an early version of Emacs, the function definition was
@end smallexample
Like all function definitions, this definition has five parts following
-the special form @code{defun}:
+the macro @code{defun}:
@enumerate
@item
you can replace @code{when} with @code{if} and understand what goes
on. That is what the Lisp interpreter does.
-Technically speaking, @code{when} is a Lisp macro. A Lisp @dfn{macro}
+Technically speaking, @code{when} is a Lisp macro. A Lisp macro
enables you to define new control constructs and other language
features. It tells the interpreter how to compute another Lisp
expression which will in turn compute the value. In this case, the
not override the existing value. Second, @code{defvar} has a
documentation string.
-(Another special form, @code{defcustom}, is designed for variables
+(There is a related macro, @code{defcustom}, designed for variables
that people customize. It has more features than @code{defvar}.
(@xref{defcustom, , Setting Variables with @code{defcustom}}.)
internal variables that you would not expect a user to change and for
variables that you do expect a user to change. Although you can still
use @code{defvar} for user customizable variables, please use
-@code{defcustom} instead, since that special form provides a path into
+@code{defcustom} instead, since it provides a path into
the Customization commands. (@xref{defcustom, , Specifying Variables
using @code{defcustom}}.)
@sp 1
@tex
@center @image{cons-1}
-%%%% old method of including an image
-% \input /usr/local/lib/tex/inputs/psfig.tex
-% \centerline{\psfig{figure=/usr/local/lib/emacs/man/cons-1.eps}}
-% \catcode`\@=0 %
@end tex
@sp 1
@end ifset
@sp 1
@tex
@center @image{cons-2}
-%%%% old method of including an image
-% \input /usr/local/lib/tex/inputs/psfig.tex
-% \centerline{\psfig{figure=/usr/local/lib/emacs/man/cons-2.eps}}
-% \catcode`\@=0 %
@end tex
@sp 1
@end ifset
@sp 1
@tex
@center @image{cons-2a}
-%%%% old method of including an image
-% \input /usr/local/lib/tex/inputs/psfig.tex
-% \centerline{\psfig{figure=/usr/local/lib/emacs/man/cons-2a.eps}}
-% \catcode`\@=0 %
@end tex
@sp 1
@end ifset
@sp 1
@tex
@center @image{cons-3}
-%%%% old method of including an image
-% \input /usr/local/lib/tex/inputs/psfig.tex
-% \centerline{\psfig{figure=/usr/local/lib/emacs/man/cons-3.eps}}
-% \catcode`\@=0 %
@end tex
@sp 1
@end ifset
@sp 1
@tex
@center @image{cons-4}
-%%%% old method of including an image
-% \input /usr/local/lib/tex/inputs/psfig.tex
-% \centerline{\psfig{figure=/usr/local/lib/emacs/man/cons-4.eps}}
-% \catcode`\@=0 %
@end tex
@sp 1
@end ifset
@sp 1
@tex
@center @image{drawers}
-%%%% old method of including an image
-% \input /usr/local/lib/tex/inputs/psfig.tex
-% \centerline{\psfig{figure=/usr/local/lib/emacs/man/drawers.eps}}
-% \catcode`\@=0 %
@end tex
@sp 1
@end ifset
@sp 1
@tex
@center @image{cons-5}
-%%%% old method of including an image
-% \input /usr/local/lib/tex/inputs/psfig.tex
-% \centerline{\psfig{figure=/usr/local/lib/emacs/man/cons-5.eps}}
-% \catcode`\@=0 %
@end tex
@sp 1
@end ifset
A function definition provides the blueprints for a robot. When you
install a function definition, that is, when you evaluate a
-@code{defun} special form, you install the necessary equipment to
-build robots. It is as if you were in a factory, setting up an
-assembly line. Robots with the same name are built according to the
-same blueprints. So they have, as it were, the same `model number',
-but a different `serial number'.
+@code{defun} macro, you install the necessary equipment to build
+robots. It is as if you were in a factory, setting up an assembly
+line. Robots with the same name are built according to the same
+blueprints. So they have, as it were, the same `model number', but a
+different `serial number'.
We often say that a recursive function `calls itself'. What we mean
is that the instructions in a recursive function cause the Lisp
"-rw-r--r--"
@end group
@group
-nil
+t
2971624
773)
@end group
file. Indeed, you can write any Lisp expression in your @file{.emacs}
file.)
-The @code{customize} feature depends on the @code{defcustom} special
-form. Although you can use @code{defvar} or @code{setq} for variables
-that users set, the @code{defcustom} special form is designed for the
-job.
+The @code{customize} feature depends on the @code{defcustom} macro.
+Although you can use @code{defvar} or @code{setq} for variables that
+users set, the @code{defcustom} macro is designed for the job.
You can use your knowledge of @code{defvar} for writing the
first three arguments for @code{defcustom}. The first argument to
command in which group the variable is located. This tells where to
find it.
-The @code{defcustom} function recognizes more than a dozen keywords.
+The @code{defcustom} macro recognizes more than a dozen keywords.
For more information, see @ref{Customization, , Writing Customization
Definitions, elisp, The GNU Emacs Lisp Reference Manual}.
@ignore
@c texi2dvi fails when the name of the section is within ifnottex ...
(@xref{Prevent confusion, , @code{let} Prevents Confusion}, and
-@ref{defun, , The @code{defun} Special Form}.)
+@ref{defun, , The @code{defun} Macro}.)
@end ignore
@node yank
@end smallexample
@noindent
-(@xref{defun, , The @code{defun} Special Form}.)
+(@xref{defun, , The @code{defun} Macro}.)
@need 1250
@noindent
If we want to multiply 3 by 7, we can write:
-@c !!! Clear print-postscript-figures if the computer formatting this
-@c document is too small and cannot handle all the diagrams and figures.
@c clear print-postscript-figures
-@c set print-postscript-figures
@c lambda example diagram #1
@ifnottex
@smallexample
@sp 1
@tex
@center @image{lambda-1}
-%%%% old method of including an image
-% \input /usr/local/lib/tex/inputs/psfig.tex
-% \centerline{\psfig{figure=/usr/local/lib/emacs/man/lambda-1.eps}}
-% \catcode`\@=0 %
@end tex
@sp 1
@end ifset
@sp 1
@tex
@center @image{lambda-2}
-%%%% old method of including an image
-% \input /usr/local/lib/tex/inputs/psfig.tex
-% \centerline{\psfig{figure=/usr/local/lib/emacs/man/lambda-2.eps}}
-% \catcode`\@=0 %
@end tex
@sp 1
@end ifset
@sp 1
@tex
@center @image{lambda-3}
-%%%% old method of including an image
-% \input /usr/local/lib/tex/inputs/psfig.tex
-% \centerline{\psfig{figure=/usr/local/lib/emacs/man/lambda-3.eps}}
-% \catcode`\@=0 %
@end tex
@sp 1
@end ifset
-2013-07-05 Glenn Morris <rgm@gnu.org>
++2013-07-06 Glenn Morris <rgm@gnu.org>
+
+ * elisp.texi (Top): Move WWW_GNU_ORG section outside @copying.
+
2013-07-03 Glenn Morris <rgm@gnu.org>
* debugging.texi (Debugging):
* package.texi (Package Archives): Fix @url call.
-2013-06-26 Glenn Morris <rgm@gnu.org>
-
* syntax.texi (Syntax Table Functions): Mention describe-syntax.
-2013-06-19 Glenn Morris <rgm@gnu.org>
+2013-06-29 Eli Zaretskii <eliz@gnu.org>
- * loading.texi (Autoload): Fix typo.
+ * display.texi (Bidirectional Display): Document move-point-visually.
+
+2013-06-29 Xue Fuqiao <xfq.free@gmail.com>
-2013-06-12 Glenn Morris <rgm@gnu.org>
+ * buffers.texi (Buffer File Name): Fix typo.
+
+2013-06-26 Christopher Schmidt <christopher@ch.ristopher.com>
+
+ * tips.texi (Coding Conventions): Improve wording.
+
+2013-06-24 Glenn Morris <rgm@gnu.org>
+
+ * loading.texi (Autoload): Fix typo.
* variables.texi (Lexical Binding): Fix typo.
* functions.texi (Anonymous Functions): Put back ' removed 2012-10-23.
-2013-03-12 Glenn Morris <rgm@gnu.org>
+2013-06-23 Lars Magne Ingebrigtsen <larsi@gnus.org>
+
+ * display.texi (ImageMagick Images): Mention :max-width and
+ :max-height.
+
+2013-06-20 Paul Eggert <eggert@cs.ucla.edu>
+
+ * numbers.texi (Math Functions): Remove obsolete function log10.
+
+2013-06-19 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ * modes.texi (Mode Line Data, Properties in Mode): Advertise `keymap'
+ rather than `local-map'.
+
+ * keymaps.texi (Active Keymaps): Fix documentation of
+ set-temporary-overlay-map and overriding-terminal-local-map.
+
+2013-06-19 Glenn Morris <rgm@gnu.org>
+
+ * Makefile.in (dist): Edit more configure variables.
+ Try to check that we do not miss any in future.
+
+2013-06-17 Juanma Barranquero <lekktu@gmail.com>
+
+ * text.texi (Undo, Changing Properties): Fix typos.
+
+2013-06-17 Lars Magne Ingebrigtsen <larsi@gnus.org>
+
+ * text.texi (Changing Properties): Document `add-face-text-property'.
+
+2013-06-17 Kenichi Handa <handa@gnu.org>
+
+ * display.texi (Face Attributes): Refer to "Low-Level font" (not
+ "Font Selection") in the explanation of :font attribute (bug#14629).
+
+2013-06-13 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ * loading.texi (Hooks for Loading): Don't document after-load-alist.
+ Document with-eval-after-load instead of eval-after-load.
+
+2013-06-11 Xue Fuqiao <xfq.free@gmail.com>
+
+ * files.texi (File Name Expansion): Make the example more
+ intuitive.
+
+2013-06-10 Paul Eggert <eggert@cs.ucla.edu>
+
+ Documentation fix for 'ls' and hard links.
+ * compile.texi (Compilation Functions):
+ * files.texi (File Attributes, Changing Files):
+ Use current format for GNU 'ls' output.
+ (File Attributes): Fix problem introduced in previous change:
+ the link count is the number of hard links, not the number
+ of hard links + 1.
+
+2013-06-10 Xue Fuqiao <xfq.free@gmail.com>
+
+ * files.texi (File Attributes): Fix typo.
+
+2013-05-29 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ * functions.texi (Lambda Expressions): Lambda expressions don't
+ evaluate to themselves in general (bug#11782).
+
+2013-05-15 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ * loading.texi (Autoload):
+ * help.texi (Documentation Basics, Accessing Documentation)
+ (Accessing Documentation, Accessing Documentation): DOC-* is now DOC.
+
+2013-04-23 Glenn Morris <rgm@gnu.org>
+
+ * internals.texi (Writing Emacs Primitives): Remove obvious example.
+ Tweak other to avoid overly long line.
+
+2013-04-21 Xue Fuqiao <xfq.free@gmail.com>
+
+ * internals.texi (Writing Emacs Primitives): Remove unnecessary
+ references to the sources. (Bug#13800)
+
+ * searching.texi (Regexp Backslash): Doc fix for backslash
+ constructs in regular expressions.
+
+2013-04-15 Christopher Schmidt <christopher@ch.ristopher.com>
+
+ * tips.texi (Coding Conventions): Mention separation of package
+ descriptor and name of internal symbols by two hyphens.
+
+2013-04-13 Stephen Berman <stephen.berman@gmx.net>
+
+ * windows.texi (Splitting Windows): Change category of
+ split-window from a command to a function.
+
+2013-04-06 Chong Yidong <cyd@gnu.org>
+
+ * display.texi (Faces): Minor clarifications.
+ (Defining Faces): Clarify default vs custom face specs.
+ Document face-spec-set.
+
+ * display.texi (Overlay Properties):
+ * text.texi (Special Properties): Use the "anonymous face"
+ terminology. Describe foreground-color and background-color forms
+ as compatibility-only.
+
+2013-03-24 Eli Zaretskii <eliz@gnu.org>
+
+ * compile.texi (Byte-Code Objects): Add index entry.
+ (Disassembly): Add cross-references.
+
+2013-03-23 Eli Zaretskii <eliz@gnu.org>
+
+ * frames.texi (Size Parameters): More accurate description of the
+ difference between 'fullboth' and 'maximized'. (Bug#13935)
+
+2013-03-17 Christopher Schmidt <christopher@ch.ristopher.com>
+
+ * symbols.texi (Standard Properties): Document pure. (Bug#13823)
+
+2013-03-16 Glenn Morris <rgm@gnu.org>
* elisp.texi: Add some stuff specific to www.gnu.org.
-2013-03-11 Glenn Morris <rgm@gnu.org>
+2013-03-11 Teodor Zlatanov <tzz@lifelogs.com>
+
+ * control.texi (Pattern matching case statement): Fix typo.
+
+2013-03-04 Paul Eggert <eggert@cs.ucla.edu>
- * Version 24.3 released.
+ * elisp.texi, intro.texi: Switch from Latin-1 to UTF-8.
2013-03-03 Glenn Morris <rgm@gnu.org>
* objects.texi (Symbol Type): Fix typo.
-2013-02-27 Bastien Guerry <bzg@gnu.org>
+2013-02-28 Bastien Guerry <bzg@gnu.org>
* variables.texi (File Local Variables): Fix reference.
-2013-02-23 Eli Zaretskii <eliz@gnu.org>
+2013-02-24 Eli Zaretskii <eliz@gnu.org>
* files.texi (Magic File Names): Improve wording and indexing.
+2013-02-21 Glenn Morris <rgm@gnu.org>
+
+ * display.texi (Multi-Frame Images): Minor rephrasing.
+
+2013-02-20 Glenn Morris <rgm@gnu.org>
+
+ * display.texi (GIF Images, TIFF Images): Delete these nodes.
+ (ImageMagick Images): For :index, use an xref rather than duplicating.
+ (Other Image Types): Add GIF, adjust formatting.
+ (Multi-Frame Images): Rename from Animated Images. Expand section.
+ * elisp.texi (Top): Update menu for these changes.
+
2013-02-19 Glenn Morris <rgm@gnu.org>
* text.texi (Change Hooks): Fix typo.
-2013-02-14 Glenn Morris <rgm@gnu.org>
+2013-02-15 Glenn Morris <rgm@gnu.org>
* modes.texi (Basic Major Modes): 'z' no longer bound in special-mode.
* modes.texi (Minor Mode Conventions): Fix typo.
-2013-02-12 Glenn Morris <rgm@gnu.org>
-
* keymaps.texi (Scanning Keymaps): Remove obsolete sentence about
meta characters; this changed in 22.1. (Bug#13684)
-2013-02-11 Glenn Morris <rgm@gnu.org>
-
* objects.texi (Char-Table Type): Add cindex.
* keymaps.texi (Key Binding Commands): Trivial rephrasing.
-2013-02-09 Glenn Morris <rgm@gnu.org>
+2013-02-10 Glenn Morris <rgm@gnu.org>
* keymaps.texi (Creating Keymaps): Update make-keymap result.
+2013-02-09 Eli Zaretskii <eliz@gnu.org>
+
+ * modes.texi (%-Constructs): Remove the description of %t.
+
+ * nonascii.texi (MS-DOS File Types): Delete node.
+
2013-02-08 Glenn Morris <rgm@gnu.org>
* keymaps.texi (Active Keymaps, Searching Keymaps):
Remove confusing mention of "symbolic prefix". (Bug#13643)
-2013-01-16 Glenn Morris <rgm@gnu.org>
+2013-01-19 Glenn Morris <rgm@gnu.org>
* macros.texi (Indenting Macros): Fix order of an indent
symbol's arguments. (Bug#13450)
+2013-01-19 Paul Eggert <eggert@cs.ucla.edu>
+
+ Allow floating-point file offsets.
+ * files.texi (Reading from Files, Writing to Files):
+ Say that file offsets can be numbers, not just integers.
+
2013-01-09 Glenn Morris <rgm@gnu.org>
* commands.texi (Interactive Codes):
* keymaps.texi (Key Sequences): Remove obsolete sentence
(Bug#13356).
-2013-01-0
3 Ari Roponen <ari.roponen@gmail.com> (tiny change)
+2013-01-0
4 Ari Roponen <ari.roponen@gmail.com> (tiny change)
* hash.texi (Defining Hash): Fix typo. (Bug#13345)
+2013-01-04 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ * files.texi (File Attributes): Undocument return format of file-acl.
+
2013-01-03 Glenn Morris <rgm@gnu.org>
* processes.texi (System Processes):
* elisp.texi (DATE): Bump to Jan 2013.
-2012-12-31 Glenn Morris <rgm@gnu.org>
+2013-01-02 Glenn Morris <rgm@gnu.org>
* customize.texi (Common Keywords, Type Keywords):
Replace "active field" with "button". (Bug#13310)
* customize.texi (Common Keywords): Add xref. (Bug#13311)
* tips.texi (Library Headers): Add cindex.
-2012-12-29 Wolfgang Jenkner <wjenkner@inode.at>
+2012-12-30 Wolfgang Jenkner <wjenkner@inode.at>
* functions.texi (Declare Form):
* intro.texi (A Sample Function Description):
* variables.texi (Using Lexical Binding): Don't use @var or CAPS
in @def.. commands. (Bug#13292)
+2012-12-29 Eli Zaretskii <eliz@gnu.org>
+
+ * files.texi (Changing Files): Document the return values of
+ set-file-selinux-context and set-file-acl.
+
2012-12-27 Glenn Morris <rgm@gnu.org>
* files.texi (File Names): Mention Cygwin conversion functions.
* windows.texi (Selecting Windows): Reword description of
select-window (Bug#13248).
+2012-12-22 Eli Zaretskii <eliz@gnu.org>
+
+ * files.texi (File Attributes, Changing Files): Remove the details
+ about the text returned by file-acl. Instead, just document that
+ it is an opaque string meant to be used by set-file-acl.
+
2012-12-21 Chong Yidong <cyd@gnu.org>
* modes.texi (Auto Major Mode): Fix typo (Bug#13230).
* customize.texi (Simple Types): Document key-sequence type
(Bug#13048).
-2012-12-15 Chong Yidong <cyd@gnu.org>
-
* strings.texi (Text Comparison): Doc fix for compare-strings.
-2012-12-09 Stefan Monnier <monnier@iro.umontreal.ca>
+2012-12-19 Michael Albinus <michael.albinus@gmx.de>
- * control.texi (Pattern matching case statement): New node.
+ * files.texi (Magic File Names): Add `file-acl',
+ `file-selinux-context', `set-file-acl' and
+ `set-file-selinux-context'. Make the list consistent.
+
+2012-12-19 Jonas Bernoulli <jonas@bernoul.li>
+
+ * tips.texi (Library Headers): New header keyword `Homepage'.
+ Make continuation lines syntax more precise.
+
+2012-12-17 Eli Zaretskii <eliz@gnu.org>
+
+ * files.texi (File Attributes, Changing Files): Update to include
+ MS-Windows support for ACLs.
+
+2012-12-16 Romain Francoise <romain@orebokech.com>
+
+ * files.texi (File Attributes): Document ACL support and new
+ `file-acl' function.
+ (Changing Files): Mention argument name change of `copy-file' and
+ document new function `set-file-acl'.
+
+2012-12-14 Paul Eggert <eggert@cs.ucla.edu>
+
+ Fix permissions bugs with setgid directories etc. (Bug#13125)
+ * files.texi (Testing Accessibility): Document GROUP arg
+ of file-ownership-preserved-p.
+ (File Attributes): Document that 9th element is now
+ just a placeholder.
+ * os.texi (User Identification): Document new functions group-gid,
+ group-real-gid.
+
+2012-12-11 Paul Eggert <eggert@cs.ucla.edu>
+
+ * internals.texi (C Integer Types): New section.
+ This follows up and records an email in
+ <http://lists.gnu.org/archive/html/emacs-devel/2012-07/msg00496.html>.
-2012-12-06 Stefan Monnier <monnier@iro.umontreal.ca>
+2012-12-10 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ * control.texi (Pattern matching case statement): New node.
* customize.texi (Variable Definitions): Mention the default :group
for defcustoms (bug#13093).
-2012-12-05 Chong Yidong <cyd@gnu.org>
+2012-12-09 Glenn Morris <rgm@gnu.org>
+
+ * customize.texi (Variable Definitions): Mention eval-defun
+ on a defcustom calls the :set function when appropriate.
+
+2012-12-06 Paul Eggert <eggert@cs.ucla.edu>
+
+ * doclicense.texi, gpl.texi: Update to latest version from FSF.
+ These are just minor editorial changes.
+
+2012-12-06 Chong Yidong <cyd@gnu.org>
* lists.texi (Plist Access): Move put example to Symbol Plists.
* symbols.texi (Standard Properties): Fix typo.
-2012-12-02 Chong Yidong <cyd@gnu.org>
+2012-12-03 Chong Yidong <cyd@gnu.org>
* symbols.texi (Symbol Properties): New node.
(Symbol Plists): Make it a subsection under Symbol Properties.
* commands.texi (Using Interactive): Fix index entry.
-2012-11-23 Martin Rudalics <rudalics@gmx.at>
+2012-11-24 Paul Eggert <eggert@cs.ucla.edu>
+
+ * doclicense.texi: Update to latest version from FSF.
+ These are just minor editorial changes.
+ * elisp.texi (GNU Free Documentation License)
+ (GNU General Public Licens):
+ Provide sectioning, since doclicense.texi no longer does that.
+
+ * loading.texi (Named Features): @ -> @@ to fix typo.
+
+2012-11-24 Martin Rudalics <rudalics@gmx.at>
* windows.texi (Basic Windows): Fix typo.
(Windows and Frames): Fix example. Move description of
dedicatedness affects functions removing buffers or windows.
* buffers.texi (The Buffer List): Fix description of bury-buffer.
-2012-11-23 Chong Yidong <cyd@gnu.org>
+2012-11-24 Chong Yidong <cyd@gnu.org>
* modes.texi (%-Constructs): Fix statement about mode construct
padding (Bug#12866).
-2012-11-21 Stefan Monnier <monnier@iro.umontreal.ca>
+2012-11-24 Stefan Monnier <monnier@iro.umontreal.ca>
* debugging.texi (Profiling): Make it more clear
that --enable-profiling is about profiling the C code.
2012-11-21 Glenn Morris <rgm@gnu.org>
- * debugging.texi (Profiling): Mention --enable-profiling (if !tex).
- Add some basic information about the profile report buffer.
- (Debugging): Mention profiling in the introduction.
-
-2012-11-20 Glenn Morris <rgm@gnu.org>
+ * display.texi (Attribute Functions):
+ Update for set-face-* name changes.
+ Add new "inherit" argument for face-bold-p etc.
+ Move description of this argument to a common section, like "frame".
- * debugging.texi (Profiling): New section, in progress.
+ * debugging.texi (Profiling): New section.
+ (Debugging): Mention profiling in the introduction.
* tips.texi (Compilation Tips): Move profiling to separate section.
* elisp.texi: Add Profiling to detailed menu.
-2012-11-18 Martin Rudalics <rudalics@gmx.at>
+2012-11-21 Martin Rudalics <rudalics@gmx.at>
* windows.texi (Display Action Functions): Fix recently added
example. Suggested by Michael Heerdegen.
-2012-11-18 Paul Eggert <eggert@cs.ucla.edu>
+2012-11-21 Paul Eggert <eggert@cs.ucla.edu>
Minor cleanup for times as lists of four integers.
* os.texi (Time Parsing): Time values can now be four integers.
* loading.texi (How Programs Do Loading): Add eager macro expansion.
* macros.texi (Expansion): Mention eager macro expansion.
-2012-11-17 Glenn Morris <rgm@gnu.org>
-
* minibuf.texi (Basic Completion): Mention misc completion-table funcs.
-2012-11-17 Leo Liu <sdl.web@gmail.com>
+2012-11-18 Leo Liu <sdl.web@gmail.com>
* minibuf.texi (Programmed Completion): Doc fix for metadata
request (Bug#12850).
-2012-11-17 Glenn Morris <rgm@gnu.org>
+2012-11-18 Glenn Morris <rgm@gnu.org>
* display.texi (Temporary Displays): Document with-temp-buffer-window.
Fix description of display-buffer-below-selected. Reorder actions.
Add example (Bug#12848).
-2012-11-15 Stefan Monnier <monnier@iro.umontreal.ca>
-
- * keymaps.texi (Translation Keymaps): Add a subsection "Interaction
- with normal keymaps" (bug#12868).
-
-2012-11-15 Glenn Morris <rgm@gnu.org>
+2012-11-16 Glenn Morris <rgm@gnu.org>
* display.texi (Face Attributes): Fix :underline COLOR description.
(Attribute Functions): Update for set-face-underline rename.
Tweak descriptions of face-underline-p, face-inverse-video-p.
-2012-11-14 Glenn Morris <rgm@gnu.org>
-
* keymaps.texi (Searching Keymaps, Tool Bar): Untabify examples,
so they align better in info.
(Active Keymaps, Searching Keymaps, Controlling Active Maps):
Document set-temporary-overlay-map.
-2012-11-12 Glenn Morris <rgm@gnu.org>
+2012-11-15 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ * keymaps.texi (Translation Keymaps): Add a subsection "Interaction
+ with normal keymaps".
+
+2012-11-15 Dmitry Antipov <dmantipov@yandex.ru>
+
+ * internals.texi (Garbage Collection): Update descriptions
+ of vectorlike_header, garbage-collect and gc-cons-threshold.
+ (Object Internals): Explain Lisp_Object layout and the basics
+ of an internal type system.
+ (Buffer Internals): Update description of struct buffer.
+
+2012-11-13 Glenn Morris <rgm@gnu.org>
* variables.texi (Adding Generalized Variables):
At least mention gv-define-expander and gv-letplace.
-2012-11-11 Glenn Morris <rgm@gnu.org>
-
* debugging.texi (Error Debugging): Mention debug-on-message.
(Using Debugger): Mention debugger-bury-or-kill.
* variables.texi (Adding Generalized Variables):
Use standard formatting for common lisp note about setf functions.
-2012-11-07 Martin Rudalics <rudalics@gmx.at>
+2012-11-10 Martin Rudalics <rudalics@gmx.at>
* elisp.texi (Top): Add Recombining Windows to menu.
* windows.texi (Recombining Windows): New subsection.
(Splitting Windows): Rewrite text on handling of window
combinations and move it to new subsection.
-2012-11-07 Chong Yidong <cyd@gnu.org>
+2012-11-10 Chong Yidong <cyd@gnu.org>
* searching.texi (Replacing Match): Document \? in replace-match.
* edebug.texi (Specification List): setf is no longer CL-only.
-2012-11-07 Glenn Morris <rgm@gnu.org>
+2012-11-10 Glenn Morris <rgm@gnu.org>
* variables.texi (Adding Generalized Variables):
Update description of FIX-RETURN expansion.
-2012-11-06 Glenn Morris <rgm@gnu.org>
-
* variables.texi (Setting Generalized Variables):
Split most of previous contents into this subsection.
(Adding Generalized Variables): New subsection.
* elisp.texi: Add Generalized Variables subsections to detailed menu.
-2012-11-05 Chong Yidong <cyd@gnu.org>
+2012-11-10 Chong Yidong <cyd@gnu.org>
* frames.texi (Initial Parameters): Doc fix (Bug#12144).
+2012-11-08 Michael Albinus <michael.albinus@gmx.de>
+
+ * os.texi (Notifications): Update descriptions of
+ notifications-notify, notifications-close-notification and
+ notifications-get-capabilities according to latest code changes.
+ Add notifications-get-server-information.
+
2012-11-03 Chong Yidong <cyd@gnu.org>
* objects.texi (General Escape Syntax): Clarify the explanation of
2012-02-04 Chong Yidong <cyd@gnu.org>
- * functions.texi (What Is a Function): Add closures. Mention
- "return value" terminology. Add xref for command-execute.
+ * functions.texi (What Is a Function): Add closures.
+ Mention "return value" terminology. Add xref for command-execute.
Remove unused "keystroke command" terminology.
(Lambda Expressions): Give a different example than in the
following subsection. Add xref to Anonymous Functions.
2002-05-13 Kim F. Storm <storm@cua.dk>
- * variables.texi (Intro to Buffer-Local): Updated warning and
+ * variables.texi (Intro to Buffer-Local): Update warning and
example relating to changing buffer inside let.
2002-03-10 Jan Djärv <jan.h.d@swipnet.se>
This is the @cite{GNU Emacs Lisp Reference Manual}
@end ifnottex
corresponding to Emacs version @value{EMACSVER}.
- @ifset WWW_GNU_ORG
- @html
- <p>The homepage for GNU Emacs is at
- <a href="/software/emacs/">http://www.gnu.org/software/emacs/</a>.<br>
- For information on using Emacs, refer to
- the <a href="/software/emacs/manual/html_node/emacs/index.html">Emacs
- Manual</a>.<br> To view this manual in other formats,
- click <a href="/software/emacs/manual/elisp.html">here</a>.
- @end html
- @end ifset
Copyright @copyright{} 1990--1996, 1998--2013 Free Software Foundation, Inc.
@end quotation
@end copying
-@documentencoding ISO-8859-1
+@documentencoding UTF-8
@dircategory GNU Emacs Lisp
@direntry
@node Top
@top Emacs Lisp
+ @ifset WWW_GNU_ORG
+ @html
+ <p>The homepage for GNU Emacs is at
+ <a href="/software/emacs/">http://www.gnu.org/software/emacs/</a>.<br>
+ For information on using Emacs, refer to the
+ <a href="/software/emacs/manual/emacs.html">Emacs Manual</a>.<br>
+ To view this manual in other formats, click
+ <a href="/software/emacs/manual/elisp.html">here</a>.
+ @end html
+ @end ifset
+
@insertcopying
@end ifnottex
for a single file operation.
* Explicit Encoding:: Encoding or decoding text without doing I/O.
* Terminal I/O Encoding:: Use of encoding for terminal I/O.
-* MS-DOS File Types:: How DOS "text" and "binary" files
- relate to coding systems.
Searching and Matching
* Image Descriptors:: How to specify an image for use in @code{:display}.
* XBM Images:: Special features for XBM format.
* XPM Images:: Special features for XPM format.
-* GIF Images:: Special features for GIF format.
-* TIFF Images:: Special features for TIFF format.
* PostScript Images:: Special features for PostScript format.
* ImageMagick Images:: Special features available through ImageMagick.
* Other Image Types:: Various other formats are supported.
* Defining Images:: Convenient ways to define an image for later use.
* Showing Images:: Convenient ways to display an image once
it is defined.
-* Animated Images:: Some image formats can be animated.
+* Multi-Frame Images:: Some images contain more than one frame.
* Image Cache:: Internal mechanisms of image display.
Buttons
@c appendices
@include anti.texi
+@node GNU Free Documentation License
+@appendix GNU Free Documentation License
@include doclicense.texi
+@node GPL
+@appendix GNU General Public License
@include gpl.texi
@include tips.texi
@include internals.texi
-2013-07-04 Glenn Morris <rgm@gnu.org>
-
+ 2013-07-06 Glenn Morris <rgm@gnu.org>
+
+ * mh-e.texi: Fix external links.
+ (Using This Manual): Printed elisp manuals no longer available.
+
-2013-07-03 Glenn Morris <rgm@gnu.org>
-
+ * newsticker.texi (Overview): Update URL.
+
+ * nxml-mode.texi (Introduction): Update URL.
+
+ * org.texi (JavaScript support): Fix URL.
+
+ * wisent.texi (Wisent Overview): Remove incorrect, unnecessary uref.
+
+ * eudc.texi (CCSO PH/QI): Remove defunct URL.
+
+ * dbus.texi (Introspection): Update URL to a less defunct one.
+
+ * gnus.texi (Top): Restrict "Other related manuals" to info output.
+ (Foreign Groups): Use @indicateurl for examples.
+ (Direct Functions): Remove defunct URL.
+ (RSS): Update URL.
+
+ * gnus-faq.texi (FAQ 5-8, FAQ 6-3): Remove defunct URLs.
+ (FAQ 7-1): Update URL.
+
+ * pgg.texi (Top, Overview): Add note about obsolescence.
+
+2013-07-03 Paul Eggert <eggert@cs.ucla.edu>
+
+ * texinfo.tex: Merge from gnulib.
+
+2013-07-03 Glenn Morris <rgm@gnu.org>
+
* bovine.texi (top):
* cc-mode.texi (AWK Mode Font Locking):
* mh-e.texi (Preface):
* url.texi (URI Parsing): Fix cross-references to other manuals.
+2013-07-02 Lars Magne Ingebrigtsen <larsi@gnus.org>
+
+ * gnus.texi (Client-Side IMAP Splitting):
+ Note that `nnimap-inbox' now can be a list.
+
2013-06-24 Glenn Morris <rgm@gnu.org>
* eshell.texi: Fix cross-references to other manuals.
-2013-03-11 Glenn Morris <rgm@gnu.org>
+2013-06-23 Glenn Morris <rgm@gnu.org>
+
+ * Makefile.in (HTML_TARGETS, html, emacs-faq.html, emacs-faq):
+ Remove; not needed now we use a standard html layout for the faq.
+ (clean): Remove HTML_TARGETS, emacs-faq.text.
+
+2013-06-21 Eduard Wiebe <usenet@pusto.de>
+
+ * flymake.texi (Parsing the output, Customizable variables):
+ Add reference to `flymake-warning-predicate'.
+
+2013-06-19 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (Top, Configuration): Insert section `Predefined
+ connection information' in menu.
+ (Predefined connection information): New section.
+ (Android shell setup): Make a reference to `Predefined connection
+ information'.
+
+2013-06-19 Glenn Morris <rgm@gnu.org>
+
+ * Makefile.in (version): New, set by configure.
+ (clean): Delete dist tar file.
+ (infoclean): New, split from maintainer-clean.
+ (maintainer-clean): Run infoclean.
+ (dist): New rule, to make tarfile for www.gnu.org.
+
+2013-06-13 Albert Krewinkel <tarleb@moltkeplatz.de>
+
+ * sieve.texi (Managing Sieve): Fix port in example, fix documentation
+ for keys q and Q.
+ (Standards): Reference RFC5804 as the defining document of the
+ managesieve protocol.
+
+2013-06-10 Aidan Gauland <aidalgol@amuri.net>
+
+ * eshell.texi (Input/Output): Expand to cover new visual-command
+ options, eshell-visual-subcommands and eshell-visual-options.
+ Divide into separate Visual Commands and Redirection sections.
+
+2013-06-10 Glenn Morris <rgm@gnu.org>
+
+ * epa.texi (Cryptographic operations on files): Update epa-decrypt-file.
+
+2013-06-04 Katsumi Yamaoka <yamaoka@jpl.org>
+
+ * gnus.texi (Article Date):
+ Fix description of gnus-article-update-date-headers.
+
+2013-05-28 Xue Fuqiao <xfq.free@gmail.com>
+
+ * erc.texi (Special Features): ERC is being maintained within
+ Emacs now.
+
+2013-05-25 Xue Fuqiao <xfq.free@gmail.com>
+
+ * flymake.texi: Changing from one space between sentences to two.
+
+2013-05-04 Stefan Monnier <monnier@iro.umontreal.ca>
+
+ * cl.texi (Obsolete Macros): Describe replacements for `flet'
+ (bug#14293).
+
+2013-04-16 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (Frequently Asked Questions): Precise, how to define
+ an own ControlPath.
+
+2013-04-15 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (Frequently Asked Questions): New item for
+ ControlPath settings.
+
+2013-03-31 Jay Belanger <jay.p.belanger@gmail.com>
+
+ * calc.texi (Basic Operations on Units): Streamline some
+ descriptions.
+
+2013-03-27 Aidan Gauland <aidalgol@no8wireless.co.nz>
- * Version 24.3 released.
+ * eshell.texi (Built-ins): Update manual to mention tramp module.
+
+2013-03-18 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (Filename Syntax): Host names are not allowed to be
+ any method name, unless method name is specified explicitly.
+ Remove restriction on unibyte filenames.
+
+ * trampver.texi: Update release number.
+
+2013-03-17 Paul Eggert <eggert@cs.ucla.edu>
+
+ doc: convert some TeX accents to UTF-8
+ * emacs-mime.texi (Interface Functions): Use 'ï' rather than
+ '@"{@dotless{i}}'.
+
+2013-03-15 Michael Albinus <michael.albinus@gmx.de>
+
+ Sync with Tramp 2.2.7.
+
+ * trampver.texi: Update release number.
+
+2013-03-09 Jay Belanger <jay.p.belanger@gmail.com>
+
+ * calc.texi (Basic Operations on Units): Streamline some
+ descriptions.
+
+2013-03-08 Glenn Morris <rgm@gnu.org>
+
+ * faq.texi (Top): Don't say this was updated @today.
+ That's irrelevant and leads to spurious diffs.
+
+2013-03-08 Jay Belanger <jay.p.belanger@gmail.com>
+
+ * calc.texi (Basic Operations on Units):
+ Fix cross-reference.
+
+2013-03-07 Katsumi Yamaoka <yamaoka@jpl.org>
+
+ * gnus-faq.texi (FAQ 3-11): Now Gnus supports POP3 UIDL.
+
+2013-03-06 Alan Mackenzie <acm@muc.de>
+
+ * cc-mode.texi (Custom Line-Up): Clarify position of point on
+ calling a line-up function.
+
+2013-03-04 Paul Eggert <eggert@cs.ucla.edu>
+
+ * emacs-mime.texi, htmlfontify.texi, mairix-el.texi, mh-e.texi:
+ * ses.texi: Switch from Latin-1 to UTF-8.
+
+2013-03-03 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (External methods): Tramp does not connect Android
+ devices by itself.
+
+2013-03-02 Bill Wohler <wohler@newt.com>
+
+ Release MH-E manual version 8.5.
+
+ * mh-e.texi (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for
+ release 8.5.
+
+ * mh-e.texi (Preface, Conventions, Getting Started)
+ (Using This Manual, Folder Selection, Viewing, Aliases)
+ (Identities, Speedbar, Menu Bar, Tool Bar, Scan Line Formats)
+ (Bug Reports, Mailing Lists, MH FAQ and Support, Getting MH-E):
+ Update URLs.
+
+2013-03-01 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (Inline methods): Remove "ssh1", "ssh2", "plink1"
+ and "plink2" entries. "plink2" is obsolete for a long time.
+ (External methods): Remove "scp1" and "scp2" entries.
+ Explain user name and host name specification for "adb".
+
+2013-02-28 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (External methods): Mention `tramp-adb-program'.
2013-02-28 Bastien Guerry <bzg@gnu.org>
visibility settings to be honored in any circumstances.
(Progress logging, Checkboxes): Fix typos.
-2013-02-25 Michael Albinus <michael.albinus@gmx.de>
+2013-02-28 Michael Albinus <michael.albinus@gmx.de>
* tramp.texi (top) [xxx, yyy, trampfn]: Provide two versions of
the macros, for Texinfo 4.13 and 5.0.
2013-02-24 Michael Albinus <michael.albinus@gmx.de>
- Port documentation to Texinfo 5.0.
-
+ Port Tramp documentation to Texinfo 5.0.
* tramp.texi (top) [xxx, yyy, trampfn]: Remove superfluous @c.
(Filename Syntax): Do not use @trampfn{} in @item.
(Filename completion): Use @columnfractions in @multitable.
* flymake.texi (Syntax check statuses): Fix multitable continued rows.
+2013-02-21 Paul Eggert <eggert@cs.ucla.edu>
+
+ * Makefile.in (html): New rule.
+
+2013-02-20 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (Android shell setup): Improve. Reported by Thierry
+ Volpiatto <thierry.volpiatto@gmail.com>.
+
+2013-02-16 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (Top, Configuration): Insert section `Android shell
+ setup' in menu.
+ (Android shell setup): New section.
+ (Connection types, Default Method)
+ (Frequently Asked Questions): Mention "scp" instead of "scpc".
+ (External methods): Remove "scpc" and "rsyncc" entries.
+ (Frequently Asked Questions): Remove entry about ControlPersist.
+
+2013-02-13 Glenn Morris <rgm@gnu.org>
+
+ * message.texi (News Headers): Don't mention yow any more.
+
+2013-02-09 Jay Belanger <jay.p.belanger@gmail.com>
+
+ * calc.texi (Basic Operations on Units):
+ (Customizing Calc): Mention the variable `calc-allow-units-as-numbers'.
+
2013-02-08 Aidan Gauland <aidalgol@no8wireless.co.nz>
* eshell.texi: Fill most of the missing sections.
(Org-Plot): Fix link.
(Checkboxes, Radio lists): Fix typos.
-2013-02-06 Glenn Morris <rgm@gnu.org>
+2013-02-07 Glenn Morris <rgm@gnu.org>
* cl.texi (Equality Predicates): Mention memql.
-2013-02-03 Eric Ludlam <zappo@gnu.org>
+2013-02-07 Eric Ludlam <zappo@gnu.org>
* doc/misc/ede.texi (Creating a project): Make ede-new doc less
specific, and only about items it supports, indicating that there
Add ede-generic-project link.
(ede-generic-project): New node (bug#11441).
-2013-02-03 Glenn Morris <rgm@gnu.org>
+2013-02-07 Glenn Morris <rgm@gnu.org>
* cl.texi (Equality Predicates): Fix eq/eql pedantry.
+2013-02-01 Glenn Morris <rgm@gnu.org>
+
+ * calc.texi (Help Commands): Update calc-view-news description.
+ Mention etc/CALC-NEWS.
+
+2013-01-24 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (Filename Syntax): Filenames must be unibyte strings.
+
2013-01-13 Bastien Guerry <bzg@gnu.org>
* org.texi (Installation): Simplify.
variable `org-id-link-to-org-use-id'. Mention the need to load
the org-id library.
-2013-01-08 Bastien Guerry <bzg@gnu.org>
+2013-01-10 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (Default Host): Introduce `tramp-default-host-alist'.
+
+2013-01-09 Bastien Guerry <bzg@gnu.org>
* org.texi (Pushing to MobileOrg): Add footnote about using
symbolic links in `org-directory'.
`org-mark-subtree'.
(Tag inheritance): Document `org-agenda-use-tag-inheritance'.
+2013-01-08 Juri Linkov <juri@jurta.org>
+
+ * info.texi (Go to node): Mention the abbreviated format
+ `(FILENAME)' equal to `(FILENAME)Top'. (Bug#13365)
+
2013-01-06 Andreas Schwab <schwab@linux-m68k.org>
* autotype.texi: Remove undefined command @subtitlefont.
* ede.texi (Top): Rename from top, all uses changed.
* eshell.texi: Add missing argument to @sp.
* forms.texi (Top): Reorder menu to match structure.
- * htmlfontify.texi (Customisation): Add missing @item in @enumerate.
+ * htmlfontify.texi (Customisation): Add missing @item in
+ @enumerate.
* org.texi (Advanced features): Add missing argument for @item.
(Property searches): Use @backslashchar{} in macro argument.
* pcl-cvs.texi: Add missing argument to @sp.
* htmlfontify.texi: New file.
-2012-12-22 Glenn Morris <rgm@gnu.org>
+2013-01-02 Jay Belanger <jay.p.belanger@gmail.com>
+
+ * calc.texi (Free-Form Dates): Expand on the date reading
+ algorithm.
+
+2012-12-27 Glenn Morris <rgm@gnu.org>
* viper.texi (Rudimentary Changes, Key Bindings, Key Bindings):
Avoid some overfull lines.
* Makefile.in (gfdl): New variable. Use throughout where
appropriate so that targets depend on doclicense.texi.
+2012-12-25 Lars Ingebrigtsen <larsi@gnus.org>
+
+ * gnus.texi (Customizing the IMAP Connection): Mention the other
+ authenticators.
+
+2012-12-24 Lars Ingebrigtsen <larsi@gnus.org>
+
+ * gnus.texi (Browse Foreign Server):
+ Document `gnus-browse-delete-group'.
+
+2012-12-22 Glenn Morris <rgm@gnu.org>
+
+ * ada-mode.texi, ebrowse.texi, ediff.texi, ert.texi, eshell.texi:
+ * eudc.texi, idlwave.texi, pcl-cvs.texi, rcirc.texi, reftex.texi:
+ * remember.texi, ses.texi, speedbar.texi, vip.texi, viper.texi:
+ * widget.texi, wisent.texi: Nuke hand-written node pointers.
+
+ * Makefile.in (gfdl): New variable. Use throughout where
+ appropriate so that targets depend on doclicense.texi.
+
2012-12-22 Eli Zaretskii <eliz@gnu.org>
* makefile.w32-in ($(INFO_TARGETS), $(DVI_TARGETS)): Depend on
doclicense.texi. Remove doclicense.texi from all targets that
mentioned it explicitly.
+ ($(infodir)/woman$(INFO_EXT), woman.dvi): Depend on
+ $(emacsdir)/emacsver.texi.
+ ($(infodir)/erc$(INFO_EXT), erc.dvi): Don't depend on gpl.texi.
2012-12-21 Glenn Morris <rgm@gnu.org>
+ * woman.texi (UPDATED, VERSION): Remove in favor of EMACSVER.
+ Include emacsver.texi. Nuke hand-written node pointers.
+ * Makefile.in ($(buildinfodir)/woman$(INFO_EXT), woman.dvi, woman.pdf):
+ Depend on emacsver.texi.
+
* auth.texi, emacs-gnutls.texi, epa.texi, ert.texi:
* gnus-coding.texi, info.texi, nxml-mode.texi, sasl.texi:
May as well just include doclicense.texi in everything.
* erc.texi: No need to include gpl in this small manual.
-2012-12-14 Glenn Morris <rgm@gnu.org>
-
* org.texi (copying): Include a copy of the GFDL.
(GNU Free Documentation License): New section.
-2012-12-13 Bastien Guerry <bzg@gnu.org>
+2012-12-21 Bastien Guerry <bzg@gnu.org>
* org.texi: Fix typos.
+2012-12-16 Paul Eggert <eggert@cs.ucla.edu>
+
+ * calc.texi (ISO 8601): Rename from ISO-8601,
+ as it's typically spelled without a hyphen.
+
+2012-12-16 Jay Belanger <jay.p.belanger@gmail.com>
+
+ * calc.texi (ISO-8601): New section.
+ (Date Formatting Codes): Mention new codes.
+ (Standard Date Formats): Mention new formats.
+
+2012-12-14 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (External methods): Move `adb' method here.
+
2012-12-13 Glenn Morris <rgm@gnu.org>
+ * cl.texi (Modify Macros, Obsolete Macros): Now letf == cl-letf.
+
* wisent.texi: Small edits. Set copyright to FSF, update license to
GFDL 1.3+.
* Makefile.in (INFO_TARGETS, DVI_TARGETS, PDF_TARGETS): Add wisent.
* bovine.texi, wisent.texi: New files, imported from CEDET trunk.
-2012-12-12 Glenn Morris <rgm@gnu.org>
+2012-12-13 Glenn Morris <rgm@gnu.org>
* flymake.texi (Customizable variables, Locating the buildfile):
Remove refs to flymake-buildfile-dirs, removed 2007-07-20. (Bug#13148)
* makefile.w32-in (INFO_TARGETS, DVI_TARGETS, clean): Add srecode.
($(infodir)/srecode$(INFO_EXT), srecode.dvi): New targets.
-2012-12-12 Eric Ludlam <zappo@gnu.org>
+2012-12-13 Eric Ludlam <zappo@gnu.org>
* srecode.texi: New file, imported from CEDET trunk.
-2012-12-12 Bastien Guerry <bzg@gnu.org>
+2012-12-13 Bastien Guerry <bzg@gnu.org>
* org.texi (Summary, Code block specific header arguments)
(Code block specific header arguments)
* org.texi (System-wide header arguments)
(Header arguments in Org mode properties, Conflicts)
- (Dynamic blocks, Using the mapping API): Fix indendation of
- Elisp code examples.
+ (Dynamic blocks, Using the mapping API):
+ Fix indentation of Elisp code examples.
* org.texi (Comment lines): Fix description of the comment syntax.
* org.texi (Installation): Mention "make test" in the correct section.
-2012-12-02 Michael Albinus <michael.albinus@gmx.de>
+2012-12-06 Paul Eggert <eggert@cs.ucla.edu>
+
+ * doclicense.texi, gpl.texi: Update to latest version from FSF.
+ These are just minor editorial changes.
+
+2012-12-04 Michael Albinus <michael.albinus@gmx.de>
+
+ * tramp.texi (History): Mention ADB.
+ (Inline methods): Add `adb' method.
+
+2012-12-03 Michael Albinus <michael.albinus@gmx.de>
* tramp.texi (Top, Obtaining Tramp): Replace CVS by Git.
(External methods): Fix typo.
-2012-11-30 Glenn Morris <rgm@gnu.org>
+2012-12-03 Glenn Morris <rgm@gnu.org>
* rcirc.texi (Notices): Fix typo.
-2012-11-20 Michael Albinus <michael.albinus@gmx.de>
+2012-11-25 Bill Wohler <wohler@newt.com>
+
+ Release MH-E manual version 8.4.
+
+ * mh-e.texi (VERSION, EDITION, UPDATED, UPDATE-MONTH, Preface):
+ Update for release 8.4.
+
+ * mh-e.texi (Sequences): Add mh-whitelist-preserves-sequences-flag.
+ (Junk): Add mh-whitelist-preserves-sequences-flag,
+ mh-blacklist-msg-hook, mh-whitelist-msg-hook,
+ mh-folder-blacklisted, mh-folder-whitelisted (closes SF #2945712).
+
+2012-11-25 Paul Eggert <eggert@cs.ucla.edu>
+
+ * mh-e.texi (Procmail): Fix two @ typos.
+
+2012-11-24 Paul Eggert <eggert@cs.ucla.edu>
+
+ * doclicense.texi, gpl.texi: Update to latest version from FSF.
+ These are just minor editorial changes.
+
+2012-11-23 Jay Belanger <jay.p.belanger@gmail.com>
+
+ * calc.texi (Date Formatting Codes): Mention the new beginning of
+ the date numbering system.
+
+2012-11-22 Paul Eggert <eggert@cs.ucla.edu>
+
+ * calc.texi: Fix TeX issues with capitals followed by ".", "?", "!".
+ (Date Forms): Correct off-by-one error in explanation of
+ Julian day numbers. Give Gregorian equivalent of its origin.
+
+2012-11-22 Jay Belanger <jay.p.belanger@gmail.com>
- * trampver.texi: Downgrade version to 2.2.6-24.3, in order to
- distinguish from trunk.
+ * doc/misc/calc.texi (Date Forms): Mention the customizable
+ Gregorian-Julian switch.
+ (Customizing Calc): Mention the variable `calc-gregorian-switch'.
+
+2012-11-17 Paul Eggert <eggert@cs.ucla.edu>
+
+ Calc now uses the Gregorian calendar for all dates (Bug#12633).
+ It also uses January 1, 1 AD as its day number 1.
+ * calc.texi (Date Forms): Document this.
2012-11-16 Glenn Morris <rgm@gnu.org>
* cl.texi (Function Bindings): Clarify that cl-flet is lexical.
(Obsolete Macros): Move example here from Function Bindings.
-2012-11-13 Glenn Morris <rgm@gnu.org>
-
* erc.texi: Use @code{nil} rather than just "nil".
(Modules): Undocument obsolete "hecomplete".
Add "notifications".
(Connecting): Add brief section on passwords.
(Options): Make a start by adding erc-hide-list, erc-lurker-hide-list.
-2012-11-12 Glenn Morris <rgm@gnu.org>
+2012-11-13 Glenn Morris <rgm@gnu.org>
* flymake.texi (Customizable variables)
(Highlighting erroneous lines): Mention flymake-error-bitmap,
flymake-warning-bitmap, and flymake-fringe-indicator-position.
-2012-11-09 Chong Yidong <cyd@gnu.org>
+2012-11-12 Vincent Belaïche <vincentb1@users.sourceforge.net>
+
+ * ses.texi: Doc for ses-rename-cell, ses-repair-cell-reference-all & ses-range.
+ In all file place SES into @acronym{...}.
+ (Advanced Features): Add key index and function index for
+ ses-set-header-row. Add description for function
+ ses-rename-cell. Add description for function
+ ses-repair-cell-reference-all.
+ (Ranges in formulas): Add description for ses-range flags.
+
+2012-11-12 Paul Eggert <eggert@cs.ucla.edu>
+
+ * texinfo.tex: Merge from gnulib.
+
+2012-11-10 Chong Yidong <cyd@gnu.org>
* url.texi (Introduction): Move url-configuration-directory to
Customization node.
Improve docs for url-queue-*.
(Supported URL Types): Copyedits. Delete empty subnodes.
-2012-11-08 Chong Yidong <cyd@gnu.org>
-
* url.texi (Introduction): Rename from Getting Started.
Rewrite the introduction.
(URI Parsing): Rewrite. Omit the obsolete attributes slot.
-2012-11-07 Glenn Morris <rgm@gnu.org>
+2012-11-10 Glenn Morris <rgm@gnu.org>
* cl.texi (Obsolete Setf Customization):
Revert defsetf example to the more correct let rather than prog1.
Give define-modify-macro, defsetf, and define-setf-method
gv.el replacements.
-2012-11-06 Glenn Morris <rgm@gnu.org>
-
* cl.texi (Overview): Mention EIEIO here, as well as the appendix.
(Setf Extensions): Remove obsolete reference.
(Obsolete Setf Customization):
(Compiler Optimizations): Rename from "Optimizing Compiler"; reword.
(Creating Symbols, Random Numbers): De-emphasize internal
variables cl--gensym-counter and cl--random-state. (Bug#12788)
+ (Naming Conventions, Type Predicates, Macros)
+ (Predicates on Numbers): No longer mention cl-floatp-safe.
-2012-11-02 Glenn Morris <rgm@gnu.org>
+2012-11-02 Katsumi Yamaoka <yamaoka@jpl.org>
- * cl.texi (Naming Conventions, Type Predicates, Macros)
- (Predicates on Numbers): No longer mention cl-floatp-safe.
+ * gnus.texi (Mail Source Specifiers):
+ Document :leave keyword used for pop mail source.
2012-11-01 Glenn Morris <rgm@gnu.org>
(Imprint): Mention Wolfgang in list of contributors.
(Creating Citations): Give a hint about how to
auto-revert the BibTeX database file when using external editors.
- (Referencing Labels): Simplify section about reference macro cycling.
+ (Referencing Labels): Simplify section about reference macro
+ cycling.
(Options (Referencing Labels)): Adapt to new structure of
`reftex-ref-style-alist'.
(Referencing Labels, Reference Styles): Document changes in the
* org.texi (History and Acknowledgments): Fix typo.
- * org.texi (History and Acknowledgments): Add my own acknowledgments.
+ * org.texi (History and Acknowledgments): Add my own
+ acknowledgments.
* org.texi (Agenda commands): Document the new command and the new
option.
* org.texi (Agenda commands): Delete `org-agenda-action' section.
- (Agenda commands): Reorder. Document `*' to toggle persistent marks.
+ (Agenda commands): Reorder. Document `*' to toggle persistent
+ marks.
* org.texi (Agenda dispatcher):
Mention `org-toggle-agenda-sticky'.
* org.texi (Formula syntax for Lisp): Reformat.
* org.texi (Special properties, Column attributes)
- (Agenda column view): Document the new special property CLOCKSUM_T.
+ (Agenda column view): Document the new special property
+ CLOCKSUM_T.
* org.texi (Template expansion): Document the new %l template.
* org.texi: The sections in the Exporting section of the manual
left out articles in the description of the org-export-as-*
- commands, among other places. This patch adds them, adds a few
+ commands, among other places. This patch adds them, adds a few
missing prepositions, and switches instances of "an HTML" to "a
html" for internal consistency.
2012-09-30 Nicolas Goaziou <n.goaziou@gmail.com>
* org.texi (Literal examples): Remove reference to unknown
- `org-export-latex-minted' variable. Also simplify footnote since
+ `org-export-latex-minted' variable. Also simplify footnote since
`org-export-latex-listings' documentation is exhaustive already.
* org.texi (Plain lists): Remove reference to now hard-coded
simplifications.
(Basic Simplifications): Rename from "Limited Simplifications"
Replace "limited" by "basic" throughout.
- (Algebraic Simplifications): Indicate that the algebraic
+ (Algebraic Simplifications): Indicate that the algebraic
simplifications are done by default.
- (Unsafe Simplifications): Mention `m E'.
+ (Unsafe Simplifications): Mention `m E'.
(Simplification of Units): Mention `m U'.
(Trigonometric/Hyperbolic Functions, Reducing and Mapping)
(Kinds of Declarations, Functions for Declarations):
2012-04-01 Carsten Dominik <carsten.dominik@gmail.com>
* org.texi (MobileOrg): Change the wording to reflect that the
- Android Version is no longer just the little brother of the iOS version.
+ Android Version is no longer just the little brother of the iOS
+ version.
2012-04-01 Eric Schulte <eric.schulte@gmx.com>
2012-01-03 Eric Schulte <eric.schulte@gmx.com>
* org.texi (Noweb reference syntax): Adding documentation of
- the `*org-babel-use-quick-and-dirty-noweb-expansion*' variable.
+ the `*org-babel-use-quick-and-dirty-noweb-expansion*'
+ variable.
2012-01-03 Bastien Guerry <bzg@gnu.org>
2012-01-03 Thomas Dye <dk@poto.local>
- * org.texi: Changed DATA to NAME in Working With Source Code section.
+ * org.texi: Changed DATA to NAME in Working With Source Code
+ section.
2012-01-03 Tom Dye <tsd@tsdye.com>
2012-01-03 Tom Dye <tsd@tsdye.com>
- * org.texi: Added a line to specify that header arguments are lowercase.
+ * org.texi: Added a line to specify that header arguments are
+ lowercase.
2012-01-03 Tom Dye <tsd@tsdye.com>
2012-01-03 David Maus <dmaus@ictsoc.de>
- * org.texi (Exporting Agenda Views, Extracting agenda information):
- Fix command line syntax, quote symbol parameter values.
+ * org.texi (Exporting Agenda Views, Extracting agenda
+ information): Fix command line syntax, quote symbol parameter
+ values.
2012-01-03 David Maus <dmaus@ictsoc.de>
2011-08-15 Bastien Guerry <bzg@gnu.org>
- * org.texi (Languages): Add Lilypond and Awk as supported languages.
+ * org.texi (Languages): Add Lilypond and Awk as supported
+ languages.
2011-08-15 Achim Gratz <stromeko@nexgo.de>
2011-08-15 Eric Schulte <schulte.eric@gmail.com>
* org.texi (Results of evaluation): More explicit about the
- mechanism through which interactive evaluation of code is performed.
+ mechanism through which interactive evaluation of code is
+ performed.
2011-08-15 Eric Schulte <schulte.eric@gmail.com>
2011-08-15 Puneeth Chaganti <punchagan@gmail.com>
- * org.texi (Agenda commands): Doc for function option to bulk action.
+ * org.texi (Agenda commands): Doc for function option to bulk
+ action.
2011-08-15 Carsten Dominik <carsten.dominik@gmail.com>
- * org.texi (Template expansion): Document new %<...> template escape.
+ * org.texi (Template expansion): Document new %<...> template
+ escape.
2011-08-15 Carsten Dominik <carsten.dominik@gmail.com>
2011-08-15 Eric Schulte <schulte.eric@gmail.com>
- * org.texi (padline): Documentation of the new padline header argument.
+ * org.texi (padline): Documentation of the new padline header
+ argument.
2011-08-15 Eric Schulte <schulte.eric@gmail.com>
2011-08-15 Eric Schulte <schulte.eric@gmail.com>
- * org.texi (var): Clarification of indexing into tabular variables.
+ * org.texi (var): Clarification of indexing into tabular
+ variables.
2011-08-15 Eric Schulte <schulte.eric@gmail.com>
2011-08-15 Eric Schulte <schulte.eric@gmail.com>
- * org.texi (Code evaluation security): Add example for using a function.
+ * org.texi (Code evaluation security): Add example for using a
+ function.
2011-08-15 Eric Schulte <schulte.eric@gmail.com>
2011-07-14 Lars Magne Ingebrigtsen <larsi@gnus.org>
* widget.texi (Setting Up the Buffer): Remove mention of the
- global keymap parent, which doesn't seem to be accurate (bug#7045).
+ global keymap parent, which doesn't seem to be accurate
+ (bug#7045).
2011-07-12 Lars Magne Ingebrigtsen <larsi@gnus.org>
2011-03-06 Jay Belanger <jay.p.belanger@gmail.com>
- * calc.texi (Logarithmic Units): Rename calc-logunits-dblevel and
- calc-logunits-nplevel to calc-dblevel and calc-nplevel, respectively.
+ * calc.texi (Logarithmic Units): Rename calc-logunits-dblevel
+ and calc-logunits-nplevel to calc-dblevel and calc-nplevel,
+ respectively.
(Musical Notes): New section.
(Customizing Calc): Mention the customizable variable
calc-note-threshold.
dired-add-entry, dired-initial-position, dired-clean-up-after-deletion,
dired-read-shell-command, or dired-find-buffer-nocreate.
+2013-02-18 Aidan Gauland <aidalgol@no8wireless.co.nz>
+
+ * eshell.texi (Input/Output): Document insert output redirection operator, >>>.
+
2011-02-18 Glenn Morris <rgm@gnu.org>
* dired-x.texi (Optional Installation File At Point): Simplify.
@contents
@ifnottex
-@node Top, Overview, (dir), (dir)
+@node Top
@top Emacs Unified Directory Client
-@comment node-name, next, previous, up
@insertcopying
@end ifnottex
-@node Overview, Installation, Top, Top
-@comment node-name, next, previous, up
+@node Overview
@chapter Overview
EUDC, the @dfn{Emacs Unified Directory Client}, provides a common user
-@node LDAP, CCSO PH/QI, Overview, Overview
-@comment node-name, next, previous, up
+@node LDAP
@section LDAP
LDAP, @dfn{the Lightweight Directory Access Protocol}, is a communication
(@pxref{LDAP Requirements})
-@node CCSO PH/QI, BBDB, LDAP, Overview
-@comment node-name, next, previous, up
+@node CCSO PH/QI
@section CCSO PH/QI
The Central Computing Services Office (CCSO) of the University of
configured to. Nowadays this system is not widely used.
The system consists of two parts: a database server traditionally called
- @samp{qi} and a command-line client called @samp{ph}. As of 2010, the
- code can still be downloaded from @url{http://www-dev.cites.uiuc.edu/ph/}.
-
- The original command-line @samp{ph} client that comes with the
- @samp{ph/qi} distribution provides additional features like the
- possibility to communicate with the server in login-mode which makes it
- possible to change records in the database. This is not implemented in
- EUDC.
+ @samp{qi} and a command-line client called @samp{ph}.
+ @ignore
+ Until 2010, the code could be downloaded from
+ @url{http://www-dev.cites.uiuc.edu/ph/}.
+ @end ignore
+
+ The original command-line @samp{ph} client that came with the
+ @samp{ph/qi} distribution provided additional features that are
+ not implemented in EUDC, like the possibility to communicate with the
+ server in login-mode, which made it possible to change records in the
+ database.
-@node BBDB, , CCSO PH/QI, Overview
-@comment node-name, next, previous, up
+@node BBDB
@section BBDB
BBDB is the @dfn{Big Brother's Insidious Database}, a package for Emacs
EUDC also offers a means to insert results from directory queries into
your own local BBDB (@pxref{Creating BBDB Records})
-@node Installation, Usage, Overview, Top
-@comment node-name, next, previous, up
+@node Installation
@chapter Installation
Add the following to your @file{.emacs} init file:
* LDAP Requirements:: EUDC needs external support for LDAP
@end menu
-@node LDAP Requirements, , Installation, Installation
-@comment node-name, next, previous, up
+@node LDAP Requirements
@section LDAP Requirements
LDAP support is added by means of @file{ldap.el}, which is part of Emacs.
(@url{http://www.openldap.org/}).
-@node Usage, Credits, Installation, Top
-@comment node-name, next, previous, up
+@node Usage
@chapter Usage
This chapter describes the usage of EUDC@. Most functions and
@end menu
-@node Querying Servers, Query Form, Usage, Usage
-@comment node-name, next, previous, up
+@node Querying Servers
@section Querying Servers
EUDC's basic functionality is to let you query a directory server and
* Duplicate Attributes:: What to do when records have duplicate attributes
@end menu
-@node Selecting a Server, Return Attributes, Querying Servers, Querying Servers
+@node Selecting a Server
@subsection Selecting a Server
Before doing any query you will need to set the directory server. You
new directory server and protocol.
@end deffn
-@node Return Attributes, Duplicate Attributes, Selecting a Server, Querying Servers
+@node Return Attributes
@subsection Return Attributes
Directory servers may be configured to return a default set of
attributes are ignored. Default is @code{t}.
@end defopt
-@node Duplicate Attributes, , Return Attributes, Querying Servers
+@node Duplicate Attributes
@subsection Duplicate Attributes
Directory standards may authorize different instances of the same
-@node Query Form, Display of Query Results, Querying Servers, Usage
-@comment node-name, next, previous, up
+@node Query Form
@section Query Form
The simplest way to query your directory server is to use the query
names defined in @code{eudc-user-attribute-names-alist}.
@end defvar
-@node Display of Query Results, Inline Query Expansion, Query Form, Usage
-@comment node-name, next, previous, up
+@node Display of Query Results
@section Display of Query Results
Upon successful completion of a form query, EUDC will display a buffer
@end defvar
-@node Inline Query Expansion, The Server Hotlist, Display of Query Results, Usage
-@comment node-name, next, previous, up
+@node Inline Query Expansion
@section Inline Query Expansion
Inline query expansion is a powerful method to get completion from your
-@node The Server Hotlist, Multi-server Queries, Inline Query Expansion, Usage
-@comment node-name, next, previous, up
+@node The Server Hotlist
@section The Server Hotlist
EUDC lets you maintain a list of frequently used servers so that you
* The Hotlist Edit Buffer:: An interactive hotlist editing facility
@end menu
-@node The Hotlist Edit Buffer, , The Server Hotlist, The Server Hotlist
-@comment node-name, next, previous, up
+@node The Hotlist Edit Buffer
@subsection The Hotlist Edit Buffer
The hotlist edit buffer offers a means to manage a list of frequently
@end deffn
-@node Multi-server Queries, Creating BBDB Records, The Server Hotlist, Usage
-@comment node-name, next, previous, up
+@node Multi-server Queries
@section Multi-server Queries
When using inline query expansion (@pxref{Inline Query Expansion}), EUDC
-@node Creating BBDB Records, Server/Protocol Locals, Multi-server Queries, Usage
-@comment node-name, next, previous, up
+@node Creating BBDB Records
@section Creating BBDB Records
@findex eudc-insert-record-at-point-into-bbdb
actually be inserted as part of the newly created BBDB record.
-@node Server/Protocol Locals, , Creating BBDB Records, Usage
-@comment node-name, next, previous, up
+@node Server/Protocol Locals
@section Server/Protocol Locals
EUDC can be customized independently for each server or directory
* Manipulating local bindings:: Functions to set and query local bindings
@end menu
-@node Manipulating local bindings, , Server/Protocol Locals, Server/Protocol Locals
-@comment node-name, next, previous, up
+@node Manipulating local bindings
@subsection Manipulating local bindings
EUDC offers functions that let you set and query variables on a per
-@node Credits, GNU Free Documentation License, Usage, Top
-@comment node-name, next, previous, up
+@node Credits
@chapter Credits
EUDC was written by Oscar Figueiredo based on @file{ph.el} by the
Thanks to Soren Dayton for his suggestions, his enthusiasm and his help
in testing and proofreading the code and docs of @file{ph.el}.
-@node GNU Free Documentation License, Command and Function Index, Credits, Top
+@node GNU Free Documentation License
@appendix GNU Free Documentation License
@include doclicense.texi
-@node Command and Function Index, Variables Index, GNU Free Documentation License, Top
-@comment node-name, next, previous, up
+@node Command and Function Index
@unnumbered Command and Function Index
@printindex fn
-@node Variables Index, , Command and Function Index, Top
-@comment node-name, next, previous, up
+@node Variables Index
@unnumbered Variables Index
@printindex vr
@subsubheading Answer
-First of all, that's not the way POP3 is intended to work,
-if you have the possibility, you should use the IMAP
-Protocol if you want your messages to stay on the
-server. Nevertheless there might be situations where you
-need the feature, but sadly Gnus itself has no predefined
-functionality to do so.
-
-However this is Gnus county so there are possibilities to
-achieve what you want. The easiest way is to get an external
-program which retrieves copies of the mail and stores them
-on disk, so Gnus can read it from there. On Unix systems you
-could use, e.g., fetchmail for this, on MS Windows you can use
-Hamster, an excellent local news and mail server.
-
-The other solution would be, to replace the method Gnus
-uses to get mail from POP3 servers by one which is capable
-of leaving the mail on the server. If you use XEmacs, get
-the package mail-lib, it includes an enhanced pop3.el,
-look in the file, there's documentation on how to tell
-Gnus to use it and not to delete the retrieved mail. For
-GNU Emacs look for the file epop3.el which can do the same
-(If you know the home of this file, please send me an
-e-mail). You can also tell Gnus to use an external program
-(e.g., fetchmail) to fetch your mail, see the info node
-"Mail Source Specifiers" in the Gnus manual on how to do
-it.
+Yes, if the POP3 server supports the UIDL control (maybe almost servers
+do it nowadays). To do that, add a @code{:leave VALUE} pair to each
+POP3 mail source. See @pxref{Mail Source Specifiers} for VALUE.
@node FAQ 4 - Reading messages
@subsection Reading messages
If you can't use compface, there's an online X-face converter at
@uref{http://www.dairiki.org/xface/}.
- If you use MS Windows, you could also use the WinFace program from
- @uref{http://www.xs4all.nl/~walterln/winface/}.
+ If you use MS Windows, you could also use the WinFace program,
+ which used to be available from
+ @indicateurl{http://www.xs4all.nl/~walterln/winface/}.
Now you only have to tell Gnus to include the X-face in your postings by saying
@example
Of course you can also use grep to search through your
local mail, but this is both slow for big archives and
inconvenient since you are not displaying the found mail
- in Gnus. Here comes nnir into action. Nnir is a front end
+ in Gnus. Here nnir comes into action. Nnir is a front end
to search engines like swish-e or swish++ and
- others. You index your mail with one of those search
+ others. You index your mail with one of those search
engines and with the help of nnir you can search through
the indexed mail and generate a temporary group with all
- messages which met your search criteria. If this sound
- cool to you get nnir.el from
+ messages which met your search criteria. If this sounds
+ cool to you, get nnir.el from
+ @c FIXME Isn't this file in Gnus?
+ @ignore
+ @c Dead link 2013/7.
@uref{ftp://ls6-ftp.cs.uni-dortmund.de/pub/src/emacs/}
- or @uref{ftp://ftp.is.informatik.uni-duisburg.de/pub/src/emacs/}.
+ or
+ @end ignore
+ @uref{ftp://ftp.is.informatik.uni-duisburg.de/pub/src/emacs/}.
Instructions on how to use it are at the top of the file.
@node FAQ 6-4
@uref{http://infa.abo.fi/~patrik/sn/, sn},
of course you can also install a full featured news
server like
- @uref{http://www.isc.org/products/INN/, inn}.
+ @uref{http://www.isc.org/software/inn/, inn}.
Then you want to fetch your Mail, popular choices
are @uref{http://www.catb.org/~esr/fetchmail/, fetchmail}
and @uref{http://pyropus.ca/software/getmail/, getmail}.
* Index:: Variable, function and concept index.
* Key Index:: Key Index.
+ @c Doesn't work right in html.
+ @c FIXME Do this in a more standard way.
+ @ifinfo
Other related manuals
* Message:(message). Composing messages.
* Sieve:(sieve). Managing Sieve scripts in Emacs.
* EasyPG:(epa). @acronym{PGP/MIME} with Gnus.
* SASL:(sasl). @acronym{SASL} authentication in Emacs.
+ @end ifinfo
@detailmenu
--- The Detailed Node Listing ---
@vindex gnus-before-startup-hook
A hook called as the first thing when Gnus is started.
+@item gnus-before-resume-hook
+@vindex gnus-before-resume-hook
+A hook called as the first thing when Gnus is resumed after a suspend.
+
@item gnus-startup-hook
@vindex gnus-startup-hook
A hook run as the very last thing after starting up Gnus
This command is similar to @code{gnus-read-ephemeral-gmane-group}, but
the group name and the article number and range are constructed from a
given @acronym{URL}. Supported @acronym{URL} formats include:
- @url{http://thread.gmane.org/gmane.foo.bar/12300/focus=12399},
- @url{http://thread.gmane.org/gmane.foo.bar/12345/},
- @url{http://article.gmane.org/gmane.foo.bar/12345/},
- @url{http://permalink.gmane.org/gmane.foo.bar/12345/}, and
- @url{http://news.gmane.org/group/gmane.foo.bar/thread=12345}.
+ @indicateurl{http://thread.gmane.org/gmane.foo.bar/12300/focus=12399},
+ @indicateurl{http://thread.gmane.org/gmane.foo.bar/12345/},
+ @indicateurl{http://article.gmane.org/gmane.foo.bar/12345/},
+ @indicateurl{http://permalink.gmane.org/gmane.foo.bar/12345/}, and
+ @indicateurl{http://news.gmane.org/group/gmane.foo.bar/thread=12345}.
@item gnus-read-ephemeral-emacs-bug-group
@findex gnus-read-ephemeral-emacs-bug-group
@findex gnus-browse-describe-briefly
Describe browse mode briefly (well, there's not much to describe, is
there) (@code{gnus-browse-describe-briefly}).
+
+@item DEL
+@kindex DEL (Browse)
+@findex gnus-browse-delete-group
+This function will delete the current group
+(@code{gnus-browse-delete-group}). If given a prefix, this function
+will actually delete all the articles in the group, and forcibly
+remove the group itself from the face of the Earth. Use a prefix only
+if you are absolutely sure of what you are doing.
@end table
Date: 6 weeks, 4 days, 1 hour, 3 minutes, 8 seconds ago
@end example
-This line is updated continually by default. The frequency (in
-seconds) is controlled by the @code{gnus-article-update-date-headers}
-variable.
-
-If you wish to switch updating off, say:
-
-@vindex gnus-article-update-date-headers
-@lisp
-(setq gnus-article-update-date-headers nil)
-@end lisp
-
-in your @file{~/.gnus.el} file.
+To make this line updated continually, set the
+@code{gnus-article-update-date-headers} variable to the frequency in
+seconds (the default is @code{nil}).
@item W T o
@kindex W T o (Summary)
@findex nntp-open-ssl-stream
@item nntp-open-ssl-stream
Opens a connection to a server over a @dfn{secure} channel. To use
- this you must have @uref{http://www.openssl.org, OpenSSL} or
- @uref{ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL, SSLeay} installed. You
- then define a server as follows:
+ this you must have @uref{http://www.openssl.org, OpenSSL}
+ @ignore
+ @c Defunct URL, ancient package, so don't mention it.
+ or @uref{ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL, SSLeay}
+ @end ignore
+ installed. You then define a server as follows:
@lisp
;; @r{"snews" is port 563 and is predefined in our @file{/etc/services}}
@item nnimap-authenticator
Some @acronym{IMAP} servers allow anonymous logins. In that case,
-this should be set to @code{anonymous}.
+this should be set to @code{anonymous}. If this variable isn't set,
+the normal login methods will be used. If you wish to specify a
+specific login method to be used, you can set this variable to either
+@code{login} (the traditional @acronym{IMAP} login method),
+@code{plain} or @code{cram-md5}.
@item nnimap-expunge
If non-@code{nil}, expunge articles after deleting them. This is always done
@table @code
@item nnimap-inbox
-This is the @acronym{IMAP} mail box that will be scanned for new mail.
+This is the @acronym{IMAP} mail box that will be scanned for new
+mail. This can also be a list of mail box names.
@item nnimap-split-methods
Uses the same syntax as @code{nnmail-split-methods} (@pxref{Splitting
and says what authentication scheme to use. The default is
@code{password}.
+@item :leave
+Non-@code{nil} if the mail is to be left on the @acronym{POP} server
+after fetching. Mails once fetched will never be fetched again by the
+@acronym{UIDL} control. Only the built-in @code{pop3-movemail} program
+(the default) supports this keyword.
+
+If this is neither @code{nil} nor a number, all mails will be left on
+the server. If this is a number, leave mails on the server for this
+many days since you first checked new mails. If this is @code{nil}
+(the default), mails will be deleted on the server right after fetching.
+
+@vindex pop3-uidl-file
+The @code{pop3-uidl-file} variable specifies the file to which the
+@acronym{UIDL} data are locally stored. The default value is
+@file{~/.pop3-uidl}.
+
+Note that @acronym{POP} servers maintain no state information between
+sessions, so what the client believes is there and what is actually
+there may not match up. If they do not, then you may get duplicate
+mails or the whole thing can fall apart and leave you with a corrupt
+mailbox.
+
@end table
-@vindex pop3-movemail
+@findex pop3-movemail
@vindex pop3-leave-mail-on-server
If the @code{:program} and @code{:function} keywords aren't specified,
-@code{pop3-movemail} will be used. If @code{pop3-leave-mail-on-server}
-is non-@code{nil} the mail is to be left on the @acronym{POP} server
-after fetching when using @code{pop3-movemail}. Note that POP servers
-maintain no state information between sessions, so what the client
-believes is there and what is actually there may not match up. If they
-do not, then you may get duplicate mails or the whole thing can fall
-apart and leave you with a corrupt mailbox.
+@code{pop3-movemail} will be used.
Here are some examples for getting mail from a @acronym{POP} server.
+
Fetch from the default @acronym{POP} server, using the default user
name, and default fetcher:
:user "user-name" :password "secret")
@end lisp
+Leave mails on the server for 14 days:
+
+@lisp
+(pop :server "my.pop.server"
+ :user "user-name" :password "secret"
+ :leave 14)
+@end lisp
+
Use @samp{movemail} to move the mail:
@lisp
In this example, messages sent to @samp{debian-foo@@lists.debian.org}
will be filed in @samp{mail.debian.foo}.
-If the string contains the element @samp{\&}, then the previously
+If the string contains the element @samp{\\&}, then the previously
matched string will be substituted. Similarly, the elements @samp{\\1}
up to @samp{\\9} will be substituted with the text matched by the
groupings 1 through 9.
@acronym{RSS} is a format for summarizing headlines from news related
sites (such as BBC or CNN). But basically anything list-like can be
presented as an @acronym{RSS} feed: weblogs, changelogs or recent
- changes to a wiki (e.g., @url{http://cliki.net/recent-changes.rdf}).
+ changes to a wiki (e.g., @url{http://cliki.net/site/recent-changes}).
@acronym{RSS} has a quite regular and nice interface, and it's
possible to get the information Gnus needs to keep groups updated.
-\input texinfo @c -*-texinfo-*-
+\input texinfo @c -*- mode: texinfo; coding: utf-8; -*-
@c
@c Note: This document requires makeinfo version 4.6 or greater to build.
@c
@c %**end of header
@c Version of the software and manual.
-@set VERSION 8.3
+@set VERSION 8.5
@c Edition of the manual. It is either empty for the first edition or
@c has the form ", nth Edition" (without the quotes).
@set EDITION
-@set UPDATED 2011-09-20
-@set UPDATE-MONTH September, 2011
+@set UPDATED 2013-03-02
+@set UPDATE-MONTH March, 2013
@c Other variables.
@set MH-BOOK-HOME http://rand-mh.sourceforge.net/book/mh
them.
The MH-E package is distributed with Emacs@footnote{Version
-@value{VERSION} of MH-E appeared in Emacs 24.1. It is supported in GNU
+@value{VERSION} of MH-E appeared in Emacs 24.4. It is supported in GNU
Emacs 23 and higher, as well as XEmacs 21.4.22 and 21.5.31. MH-E is
known not to work with GNU Emacs versions 20 and below, and XEmacs
version 21.5.9--21.5.16. It is compatible with MH versions 6.8.4 and
@command{info} command (@samp{info mh-e}) or within Emacs (@kbd{C-h i
m mh-e @key{RET}}). The online version is available at
@uref{http://mh-e.sourceforge.net/manual/, SourceForge}. Another great
-online resource is the book @uref{http://rand-mh.sourceforge.net/book/,
-@cite{MH & nmh: Email for Users & Programmers}} (also known as
-@dfn{the MH book}).
+online resource is the book
+@uref{http://rand-mh.sourceforge.net/book/, @cite{MH & nmh: Email for
+Users & Programmers}} (also known as @dfn{the MH book}).
I hope you enjoy this manual! If you have any comments, or suggestions
for this document, please let me know.
@cindex GNU mailutils MH
If you don't have MH on your system already, you must install a
-variant of MH@. The Debian mh-e package does this for you automatically
-(@pxref{Getting MH-E}). Most people use
+variant of MH@. The Debian mh-e package does this for you
+automatically (@pxref{Getting MH-E}). Most people use
@uref{http://www.nongnu.org/nmh/, nmh}, but you may be interested in
-trying out @uref{http://www.gnu.org/software/mailutils/, GNU mailutils
-MH}, which supports IMAP@. Your GNU/Linux distribution probably has
-packages for both of these.
+trying out @uref{http://mailutils.org/, GNU mailutils MH}, which
+supports IMAP@. Your GNU/Linux distribution probably has packages for
+both of these.
@cindex @command{install-mh}
@cindex MH commands, @command{install-mh}
@footnote{The @cite{GNU Emacs Lisp Reference Manual} may be available
online in the Info system by typing @kbd{C-h i m Emacs Lisp
@key{RET}}. It is also available online at @*
- @uref{http://www.gnu.org/savannah-checkouts/gnu/emacs/manual/html_node/elisp/}.
- You can also order a printed manual, which has the desirable
- side-effect of helping to support the Free Software Foundation which
- made all this great software available. You can find an order form by
- running @kbd{C-h C-d}, or you can request an order form from @i{gnu at
- gnu.org}.}
+ @uref{http://www.gnu.org/software/emacs/manual/elisp.html}.}
@end iftex
@ifinfo
@footnote{@xref{Top, The GNU Emacs Lisp Reference Manual, , elisp, GNU
Emacs Lisp Reference Manual}, which may be available online in the
Info system. It is also available online at
- @uref{http://www.gnu.org/savannah-checkouts/gnu/emacs/manual/html_node/elisp/}.
- You can also order a printed manual, which has the desirable
- side-effect of helping to support the Free Software Foundation which
- made all this great software available. You can find an order form by
- running @kbd{C-h C-d}, or you can request an order form from @i{gnu at
- gnu.org}.}
+ @uref{http://www.gnu.org/software/emacs/manual/elisp.html}.}
@end ifinfo
@ifhtml
@footnote{The
- @uref{http://www.gnu.org/savannah-checkouts/gnu/emacs/manual/html_node/elisp/,
+ @uref{http://www.gnu.org/software/emacs/manual/elisp.html,
The GNU Emacs Lisp Reference Manual} may also be available online in
- the Info system by typing @kbd{C-h i m Emacs Lisp @key{RET}}. You can
- also order a printed manual, which has the desirable side-effect of
- helping to support the Free Software Foundation which made all this
- great software available. You can find an order form by running
- @kbd{C-h C-d}, or you can request an order form from @i{gnu at
- gnu.org}.}
+ the Info system by typing @kbd{C-h i m Emacs Lisp @key{RET}}.}
@end ifhtml
and you can look at the code itself for examples. Look in the Emacs
Lisp directory on your system (such as
- @file{/usr/local/lib/emacs/lisp/mh-e}) and find all the @file{mh-*.el}
+ @file{/usr/local/share/emacs/lisp/mh-e}) and find all the @file{mh-*.el}
files there. When calling MH-E and other Emacs Lisp functions directly
from Emacs Lisp code, you'll need to know the correct arguments. Use
the online help for this. For example, try @kbd{C-h f
suffix; otherwise, the element can be used to render invisible an
entire class of fields that start with the same prefix. If you think a
header field should be generally ignored, please update
-@uref{https://sourceforge.net/tracker/index.php?func=detail&aid=1916032&group_id=13357&atid=113357,
-SF #1916032}.
+@uref{https://sourceforge.net/p/mh-e/bugs/245/, SF #245}.
@cindex header field, @samp{Face:}
@cindex header field, @samp{X-Face:}
@samp{X-Face:} fields are present@footnote{The display of the images
requires the @uref{http://www.gnu.org/software/wget/wget.html,
@command{wget} program} to fetch the image and the @command{convert}
-program from the @uref{http://www.imagemagick.org/, ImageMagick
-suite}.}. Of the three header fields this is the most efficient in
-terms of network usage since the image doesn't need to be transmitted
-with every single mail. The option @code{mh-fetch-x-image-url}
-controls the fetching of the @samp{X-Image-URL:} header field image
-with the following values:
+program from the @uref{http://www.imagemagick.org/script/index.php,
+ImageMagick suite}.}. Of the three header fields this is the most
+efficient in terms of network usage since the image doesn't need to be
+transmitted with every single mail. The option
+@code{mh-fetch-x-image-url} controls the fetching of the
+@samp{X-Image-URL:} header field image with the following values:
@table @samp
@item Ask Before Fetching
@end ifinfo
@ifhtml
See
- @uref{http://www.dk.xemacs.org/Documentation/packages/html/pgg.html,
+ @uref{http://www.gnu.org/software/emacs/manual/pgg.html,
@cite{The PGG Manual}}.
@end ifhtml
The attribution consists of the sender's name and email address
followed by the content of the option
@code{mh-extract-from-attribution-verb}. This option can be set to
-@samp{wrote:}, @samp{a écrit:}, and @samp{schrieb:}. You can also use
+@samp{wrote:}, @samp{a écrit:}, and @samp{schrieb:}. You can also use
the @samp{Custom String} menu item to enter your own verb.
@vindex mail-citation-hook
@vindex mh-yank-behavior
For example, if you use the hook function
- @uref{http://shasta.cs.uiuc.edu/~lrclause/tc.html,
+ @uref{http://www.emacswiki.org/emacs/TrivialCite,
@code{trivial-cite}} (which is NOT part of Emacs), set
@code{mh-yank-behavior} to @samp{Body and Header}.
@end ifinfo
@ifhtml
See
- @uref{http://www.dk.xemacs.org/Documentation/packages/html/pgg.html,
+ @uref{http://www.gnu.org/software/emacs/manual/pgg.html,
@cite{The PGG Manual}}.
@end ifhtml
@cindex @command{mairix}
@cindex Unix commands, @command{mairix}
-In the examples below, replace @file{/home/user/Mail} with the path to
-your MH directory.
+In the examples below, replace @file{~/Mail} with the path to your MH
+directory.
-First create the directory @file{/home/user/Mail/.mairix}. Then create
-the file @file{/home/user/Mail/.mairix/config} with the following
-contents:
+First create the directory @file{~/Mail/.mairix}. Then create the file
+@file{~/Mail/.mairix/config} with the following contents:
@smallexample
@group
-base=/home/user/Mail
+base=~/Mail
# List of folders that should be indexed. 3 dots at the end means there
# are subfolders within the folder
mh=archive...:inbox:drafts:news:sent:trash
-vfolder_format=mh
-database=/home/user/Mail/.mairix/database
+mformat=mh
+database=~/Mail/.mairix/database
@end group
@end smallexample
from cron:
@smallexample
-mairix -f /home/user/Mail/.mairix/config
+mairix -f ~/Mail/.mairix/config
@end smallexample
@subsection namazu
@item mh-update-sequences-after-mh-show-flag
On means flush MH sequences to disk after message is shown (default:
@samp{on}).
+@item mh-whitelist-preserves-sequences-flag
+On means that sequences are preserved when messages are whitelisted
+(default: @samp{on}).
@end vtable
The following hook is available.
Spam program that MH-E should use (default: @samp{Auto-detect}).
@end vtable
+@cindex @samp{mh-sequences} customization group
+@cindex customization group, @samp{mh-sequences}
+
+The following option in the @samp{mh-sequences} customization group is
+also available.
+
+@vtable @code
+@item mh-whitelist-preserves-sequences-flag
+On means that sequences are preserved when messages are whitelisted
+(default: @samp{on}).
+@end vtable
+
+The following hooks are available.
+
+@vtable @code
+@item mh-blacklist-msg-hook
+Hook run by @kbd{J b} (@code{mh-junk-blacklist}) after marking each
+message for blacklisting (default: @code{nil}).
+@c -------------------------
+@item mh-whitelist-msg-hook
+Hook run by @kbd{J w} (@code{mh-junk-whitelist}) after marking each
+message for whitelisting (default @samp{nil}).
+@end vtable
+
+The following faces are available.
+
+@vtable @code
+@item mh-folder-blacklisted
+Blacklisted message face.
+@c -------------------------
+@item mh-folder-whitelisted
+Whitelisted message face
+@end vtable
+
@cindex SpamProbe
@cindex Spamassassin
@cindex bogofilter
incorrectly classified as spam. It then refiles the message into the
@file{+inbox} folder.
+@cindex MH profile component, @samp{Previous-Sequence:}
+@cindex @samp{cur} sequence
+@cindex @samp{Previous-Sequence:} MH profile component
+@cindex sequence, @samp{cur}
+@cindex sequence, @samp{Previous-Sequence}
+@vindex mh-whitelist-preserves-sequences-flag
+
+If a message is in any sequence (except @samp{Previous-Sequence:} and
+@samp{cur}) when it is whitelisted, then it will still be in those
+sequences in the destination folder. If this behavior is not desired,
+then turn off the option @code{mh-whitelist-preserves-sequences-flag}.
+
@cindex @samp{*MH-E Log*}
@cindex buffers, @samp{*MH-E Log*}
@findex call-process
@kindex M-x mh-version
Bug reports should be filed at
-@uref{https://sourceforge.net/tracker/?group_id=13357&atid=113357,
-SourceForge}. You need to be a SourceForge user to submit bug reports,
-but this is easy enough to do that it shouldn't be a restriction for
-you. Please include the output of @kbd{M-x mh-version}
-(@pxref{Miscellaneous}) in any bug report you send unless you're 110%
-positive we won't ask for it.
+@uref{https://sourceforge.net/p/mh-e/bugs/, SourceForge}. You need to
+be a SourceForge user to submit bug reports, but this is easy enough
+to do that it shouldn't be a restriction for you. Please include the
+output of @kbd{M-x mh-version} (@pxref{Miscellaneous}) in any bug
+report you send unless you're 110% positive we won't ask for it.
@node Mailing Lists, MH FAQ and Support, Bug Reports, Odds and Ends
@appendixsec MH-E Mailing Lists
There are several mailing lists for MH-E@. They are @i{mh-e-users at
lists.sourceforge.net}, @i{mh-e-announce at lists.sourceforge.net},
and @i{mh-e-devel at lists.sourceforge.net}. You can subscribe or view
-the archives at @uref{https://sourceforge.net/mail/?group_id=13357,
+the archives at @uref{https://sourceforge.net/p/mh-e/mailman/,
SourceForge}. Do not report bugs on these lists; please submit them
via SourceForge (@pxref{Bug Reports}).
@cindex support
-You can find FAQs on MH-E at the
-@uref{https://sourceforge.net/tracker/?group_id=13357&atid=213357,
-Support Requests} page on SourceForge. If you don't find the answer to
-your question, file a support request and your question will become a
-new FAQ!
+You can find FAQs on MH-E by searching for @i{labels:support} on the
+@uref{https://sourceforge.net/p/mh-e/bugs/search/?q=labels%3Asupport,
+Tickets} page on SourceForge. If you don't find the answer to your
+question, file a ticket and your question will become a new FAQ!
@node Getting MH-E, , MH FAQ and Support, Odds and Ends
@appendixsec Getting MH-E
@cindex release notes
New MH-E releases are always available for downloading at
-@uref{https://sourceforge.net/project/showfiles.php?group_id=13357,
-SourceForge} before they appear in an Emacs release. You can read the
-release notes on that page to determine if the given release of MH-E
-is already installed in your version of Emacs. You can also read the
-change log to see if you are interested in what the given release of
-MH-E has to offer (although we have no doubt that you will be
-extremely interested in all new releases).
+@uref{https://sourceforge.net/projects/mh-e/files/, SourceForge}
+before they appear in an Emacs release. You can read the release notes
+on that page to determine if the given release of MH-E is already
+installed in your version of Emacs. You can also read the change log
+to see if you are interested in what the given release of MH-E has to
+offer (although we have no doubt that you will be extremely interested
+in all new releases).
@cindex Debian
@cindex documentation
In addition to the mh-e package, the
-@uref{https://sourceforge.net/project/showfiles.php?group_id=13357,
-SourceForge} site also contains doc and contrib packages. The former
-is the latest release of this manual, and the latter contains a few
-contributed packages you might find useful.
+@uref{https://sourceforge.net/projects/mh-e/files/, SourceForge} site
+also contains doc and contrib packages. The former is the latest
+release of this manual, and the latter contains a few contributed
+packages you might find useful.
@node History, GFDL, Odds and Ends, Top
@appendix History of MH-E
For more details on the basic concepts for understanding Wisent, it is
worthwhile to read the @ref{Top, Bison Manual, , bison}.
- @ifhtml
- @uref{http://www.gnu.org/manual/bison/html_node/index.html}.
- @end ifhtml
Wisent can generate compilers compatible with the @semantic{} tool set.
See the @ref{Top, Semantic Manual, , semantic}.
@item
For generating the lookahead sets, Wisent uses the well-known
-technique of F. DeRemer and A. Pennello they described in:
+technique of F. DeRemer and A. Pennello described in:
@quotation
-@cite{Efficient Construction of LALR(1) Lookahead Sets}@*
-October 1982, ACM TOPLS Vol 4 No 4.
+@cite{Efficient Computation of LALR(1) Look-Ahead Sets}@*
+October 1982, ACM TOPLAS Vol 4 No 4, 615--49,
+@uref{http://dx.doi.org/10.1145/69622.357187}.
@end quotation
@item
* Conflicts::
@end menu
-@node Grammar format, Example, Wisent Grammar, Wisent Grammar
-@comment node-name, next, previous, up
+@node Grammar format
@section Grammar format
@cindex grammar format
Says that two groupings of type @samp{exp}, with a @samp{+} token in
between, can be combined into a larger grouping of type @samp{exp}.
-
+
@cindex grammar coding conventions
By convention, a nonterminal symbol should be in lower case, such as
@samp{exp}, @samp{stmt} or @samp{declaration}. Terminal symbols
@end table
@end table
-@node Example, Compiling a grammar, Grammar format, Wisent Grammar
-@comment node-name, next, previous, up
+@node Example
@section Example
@cindex grammar example
@end group
@end example
-@node Compiling a grammar, Conflicts, Example, Wisent Grammar
-@comment node-name, next, previous, up
+@node Compiling a grammar
@section Compiling a grammar
@cindex automaton
@end table
@end defun
-@node Conflicts, , Compiling a grammar, Wisent Grammar
-@comment node-name, next, previous, up
+@node Conflicts
@section Conflicts
Normally, a grammar should produce an automaton where at each state
@item start
@itemx end
-Are the optionals beginning and end positions of @var{value} in the
+Are the optional beginning and ending positions of @var{value} in the
input stream.
@end table
@example
@group
-(stmnt (( error ?; )) ;; on error, skip until ';' is read
- )
+(statement (( error ?; )) ;; on error, skip until ';' is read
+ )
@end group
@end example
* Useful functions::
@end menu
-@node Iterative style, Bison style, Grammar styles, Grammar styles
+@node Iterative style
@subsection Iterative style
@cindex grammar iterative style