[ESS] ESS 5.2.12 released

Martin Maechler maechler at stat.math.ethz.ch
Tue Feb 7 17:20:01 CET 2006

Dear ESS users,
we have just released version 5.2.12 of ESS;
   --> https://ESS.r-project.org/downloads/ess/

This is a patch release useful
 - for SAS users
 - users of "R-devel" (or R-2.3.x in the future)
 - Windows R users of "Rterm in Cygwin".

See the  "New Features" section below, for a bit more.

For the ESS core team (see "Authors" below),
Martin Maechler, ETH Zurich

-------------------- start of "ANNOUNCE" file (part of ESS) ----------------


The ESS Developers proudly announce the release of ESS


   Emacs Speaks Statistics (ESS) provides an intelligent, consistent
interface between the user and the software.  ESS interfaces with
S-PLUS, R, SAS, BUGS and other statistical analysis packages under the
Unix, Microsoft Windows, and Apple Mac OS operating systems.  ESS is a
package for the GNU Emacs and XEmacs text editors whose features ESS
uses to streamline the creation and use of statistical software.  ESS
knows the syntax and grammar of statistical analysis packages and
provides consistent display and editing features based on that
knowledge.  ESS assists in interactive and batch execution of
statements written in these statistical analysis languages.

   ESS is freely available under the GNU General Public License (GPL).
Please read the file COPYING which comes with the distribution, for
more information about the license. For more detailed information,
please read the README files that come with ESS.

1.1 Getting the Latest Version

The latest released version of ESS is always available on the web at:
ESS web page (http://ess.r-project.org) or StatLib

   The latest development version of ESS is available via
`https://svn.R-project.org/ESS/', the ESS Subversion repository.  If
you have a Subversion client (see `http://subversion.tigris.org/'), you
can download the sources using:
     % svn checkout https://svn.r-project.org/ESS/trunk PATH
   which will put the ESS files into directory PATH.  Later, within
that directory, `svn update' will bring that directory up to date.
Windows-based tools such as TortoiseSVN are also available for
downloading the files.  Alternatively, you can browse the sources with a
web browser at: ESS SVN site (https://svn.r-project.org/ESS/trunk).
However, please use a subversion client instead to minimize the load
when retrieving.

   If you remove other versions of ESS from your emacs load-path, you
can then use the development version by adding the following to .emacs:

     (load "/path/to/ess-svn/lisp/ess-site.el")

   Note that https is required, and that the SSL certificate for the
Subversion server of the R project is

     Certificate information:
      - Hostname: svn.r-project.org
      - Valid: from Jul 16 08:10:01 2004 GMT until Jul 14 08:10:01 2014 GMT
      - Issuer: Department of Mathematics, ETH Zurich, Zurich, Switzerland, CH
      - Fingerprint: c9:5d:eb:f9:f2:56:d1:04:ba:44:61:f8:64:6b:d9:33:3f:93:6e:ad

(currently, there is no "trusted certificate").  You can accept this
certificate permanently and will not be asked about it anymore.

1.2 Current Features

   * Languages Supported:
        * S family (S 3/4, S-PLUS 3.x/4.x/5.x/6.x/7.x, and R)

        * SAS

        * BUGS

        * Stata

        * XLispStat including Arc and ViSta

   * Editing source code (S family, SAS, BUGS, XLispStat)
        * Syntactic indentation and highlighting of source code

        * Partial evaluation of code

        * Loading and error-checking of code

        * Source code revision maintenance

        * Batch execution (SAS, BUGS)

        * Use of imenu to provide links to appropriate functions

   * Interacting with the process (S family, SAS, XLispStat)
        * Command-line editing

        * Searchable Command history

        * Command-line completion of S family object names and file

        * Quick access to object lists and search lists

        * Transcript recording

        * Interface to the help system

   * Transcript manipulation (S family, XLispStat)
        * Recording and saving transcript files

        * Manipulating and editing saved transcripts

        * Re-evaluating commands from transcript files

   * Help File Editing (R)
        * Syntactic indentation and highlighting of source code.

        * Sending Examples to running ESS process.

        * Previewing

1.3 Requirements

ESS has been tested with

   * R >=0.49

   * S-PLUS 3.3-4, 4.5, 5.0-1, 6.0-2, 7.0, 2000

   * S4

   * SAS >=6.12

   * BUGS 0.5, 0.603

   * Stata >=6.0

   * XLispStat >=3.50

   on the following platforms

   * Linux (all)

   * Solaris/SunOS (all)

   * Microsoft Windows 95/98/NT/2000/XP (R, SPLUS 4.5/6.0-2/7.0/2000,
     SAS and BUGS)

   * Apple Mac OS (SAS for OS 9 and R for OS X)

   with the following versions of emacs

   * GNU Emacs 20.3-7, 21.1, 21.3-4, 22.0.50-pretesting

   * XEmacs 21.0, 21.1.13-14, 21.4.0-8, 21.4.9-13(1), 21.4.14-15,
     21.4.17-18, 21.5.23

   ---------- Footnotes ----------

   (1) require the files.el patch to revert-buffer for the Local
Variables updating problem

1.4 Stability

Versions 5.2.x are meant to be release-quality versions.  While some
new features are being introduced, we are cleaning up and improving the
interface.  We know about some remaining documentation inconsistencies.
Patches or suggested fixes with bug reports are much appreciated!

1.5 Mailing List

There is a mailing list for discussions and announcements relating to
ESS.  Join the list by sending an e-mail with "subscribe ess-help" (or
"help") in the body to <ess-help-request at stat.math.ethz.ch>;
contributions to the list may be mailed to
<ess-help at stat.math.ethz.ch>.  Rest assured, this is a fairly
low-volume mailing list.

   The purposes of the mailing list include

   *  helping users of ESS to get along with it.

   *  discussing aspects of using ESS on Emacs and XEmacs.

   *  suggestions for improvements.

   *  announcements of new releases of ESS.

   *  posting small patches to ESS.

1.6 Reporting Bugs

Please send bug reports, suggestions etc. to
<ESS-bugs at stat.math.ethz.ch>

   The easiest way to do this is within Emacs by typing

   `M-x ess-submit-bug-report'

   This also gives the maintainers valuable information about your
installation which may help us to identify or even fix the bug.

   If Emacs reports an error, backtraces can help us debug the problem.
Type "M-x set-variable RET debug-on-error RET t RET".  Then run the
command that causes the error and you should see a *Backtrace* buffer
containing debug information; send us that buffer.

   Note that comments, suggestions, words of praise and large cash
donations are also more than welcome.

1.7 Authors

   * A.J. Rossini (mailto:blindglobe at gmail.com)

   * Richard M. Heiberger (mailto:rmh at temple.edu)

   * Kurt Hornik (mailto:Kurt.Hornik at R-project.org)

   * Martin Maechler (mailto:maechler at stat.math.ethz.ch)

   * Rodney A. Sparapani (mailto:rsparapa at mcw.edu)

   * Stephen Eglen (mailto:stephen at gnu.org)

1.8 License

ESS is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later

   ESS is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
in the file COPYING in the same directory as this file for more details.

1.9 New Features

Changes/New Features in 5.2.12:
   * ESS[SAS]: `M-;' fixed, but the XEmacs function `comment-dwim' may
     be broken, if so, use `M-x comment-region' and `M-x
     uncomment-region' instead; only valid PROCs are fontified which is
     very helpful finding syntax errors (currently supported: BASE,
     ETS, FSP, GRAPH, IML, INSIGHT and STAT); the "feature" where
     `F'-keys take you to an empty buffer when the requested
     destination is a file that does not exist has been fixed, now the
     request results in a no-op.  Further, sas-mode now also works in
     simple terminals.

   * Rterm/Cygwin combination works under Microsoft Windows.

   * ESS[R]: internal calls use baseenv() instead of NULL and define
     'baseenv' where needed.

   * New experimental support for installing ESS.  See the file

   Changes/New Features in 5.2.11:
   * ESS Info entry and `dir' handled more effectively for GNU Emacs

   * ESS[SAS]: temporary files created for batch submission of a region
     are now named based on the current file; see `ess-sas-file-root'
     for details; all `lag' and `dif' functions now fontified correctly

   * iESS[SAS]: fixed a few nagging bugs, however, still does not
     appear to work at this time; please let us know if you have any

   * ESS[S]: Support for running other versions of Splus has been added
     for unix.  Two new variables, `ess-s-versions' and
     `ess-s-versions-list', are used to tell ESS what other versions of
     Splus you would like to run.

   Changes/New Features in 5.2.10:
   * ESS[R]: ess-r-versions can no longer be customized (since the
     customization was not taking effect unless customizations were
     loaded before ESS).  Its value has been changed so that it will
     also find R executables beginning "R-devel" and "R-patched".  If
     you wish to change this variable, it must be set in your `.emacs'
     before ESS is loaded.

   * Installation with GNU Make enhanced:  unix and unix-like operating
     systems will now be able to install ESS for all users in either a
     GNU Emacs site-lisp or an XEmacs package configuration by editing
     `lisp/ess-site.el' and `Makeconf' accordingly, then issuing `make

   * ESS[S]: Filename completion (inside strings) now also works in
     XEmacs for R and S-plus.

   Changes/New Features in 5.2.9:
   * ESS[R] for Windows:  the \ directory character bug with respect to
     ess-load-file has been eradicated.

   * iESS[SAS]: `C-c C-r' and `C-c C-b' once again work as intended and

   * ESS[S]: M-x ess-fix-EQ-assign is a bit more agressive.

   * ESS[S]: Imenu now also shows setAs(), etc.

   * ESS[R]: R function pattern enhanced with underlying code such that
     `M-C-a' (`ess-beginning-of-function') etc now work for many more
     cases, including S4 method definitions.

   * iESS[R]: myOwnhelp(1) no longer wrongly triggers help(1).

   * ESS[R]: Improved detection of bogus help buffers: valid help
     buffers containing with the string "no documentation"(e.g. contour)
     were being treated as bogus.

   * ESS[R]: In R help buffers, if `options("help.try.all.packages" =
     TRUE)' then `?rlm' will list which packages rlm is defined in.
     This help  buffer is not bogus, but instead is now relabelled
     "*help[R](rlm in  packages)*".

   * ESS[STA]: add "//" as comment starting character to syntax-table.

   Changes/New Features in 5.2.8:
   * iESS: [Tab] completes *file* names "inside string" as in earlier
     (<= 5.2.3) ESS versions.

   Changes/New Features in 5.2.7:
   * If you use Custom to change the variable ess-toolbar-items, the
     new toolbar is used in all subsequent ESS buffers.

   * ESS[SAS]: new feature:  if ess-sas-log-max >0 and your .log grows
     to more than ess-sas-log-max bytes, just the first ess-sas-log-max
     bytes are refreshed; this is helpful when your .sas program
     generates lots of error messages and gets too big for emacs to

   * ESS[R/S]: `M-;' in R/S editing modes will now indent with either
     one or two hashes depending on context.

   * ESS[R]: David Whiting's Sweave extensions (to 'noweb') are now
     available (from ess-swv.el loaded by default).

   Changes/New Features in 5.2.6:
   * Removed non-ASCII characters in a few files.

   * ESS[R]: now works better when UTF-8 locale is active; in
     particular, you get correct directional quotes in R's startup
     message  for R-devel (unstable development version of R 2.1.0)
     when using  environment variables LANGUAGE=en at quot

   * ESS[SAS]: toggling of .log mode improved (`F10'); toggling of .lst
     mode now also available (`C-F10'); killing all buffers associated
     with .sas program no longer bound to `C-F10' since its a bit

   * S-Plus 7 for Windows is now recognized.

   * ESS[S] (incl. R): in auto-fill mode, strings are not wrapped

   * ESS[S] (incl. R): font-lock now correctly differs between R and S,
     e.g., for "_"; both now fontify warning(.) and S does terminate()

   * Support for `bell' aka `beep' aka `ding' aka `alarm' in all
     inferior modes: When \a is output "to the the console" at the
     beginning of a line, the bell is rung.

   Changes/New Features in 5.2.5:
   * ESS[R]: `C-c C-q' or `Quit S' from the menu now should work (again
     and less klunkily) and do not append `-exited' to the buffer name.
     Further, the behavior of `(ess-cleanup)', called from ess-quit,
     now depends on the new customizable variable
     `ess-S-quit-kill-buffers-p' which defaults to `nil'.
     Consequently, the question _"Delete all buffers associated with
     ..?"_ will not be asked anymore by default.

   * ESS[SAS] - ess-ebcdic-to-ascii-search-and-replace will now work
     with the `recode' application as well which is available on many

   * ESS[S] (incl. R): Name completion for slots of S4 objects now

   Changes/New Features in 5.2.4:
   * The documentation now includes an overview of how to use the emacs
     TAGS facility for S functions.  (The distribution also used to
     contain a directory `etc/other/Tags' where a ~1990 version of
     `etags.c' was distributed; this is no longer relevant and so has
     been deleted.)

   * ESS[SAS] - When you are working with EBCDIC files on an ASCII
     platform, .log NOTEs may display as gibberish since the EBCDIC
     characters are not converted to ASCII prior to their display.  So,
     the function ess-ebcdic-to-ascii-search-and-replace is provided for
     convenience and is bound to `C-F11'.  This function requires the
     `dd' command (only available on unix or unix-like platforms).

   * ESS: Completion of object names is now always done dynamically
     rather than allowing the option of using a pre-computed database
     (by `ess-create-object-name-db') since modern computers seem fast
     enough for dynamic completion.  (We expect few users, if any, have
     been using the pre-computed database method.)

   * ESS: object completion in iESS buffers running on Windows was very
     slow (for GNU Emacs, but not XEmacs) and has now been fixed.
     Further, it was more or less broken for all versions of S-plus 6.x,
     and has been fixed to work everywhere but with the Windows' GUI of
     S-plus.  The list of objects now shows unique names also when an
     object appears more than once in the search path.

   * ESS[R]: Completion of object names now also includes those
     starting with ".".

   Changes/New Features in 5.2.3:
   * ESS: When new inferior ESS processes are created, by default they
     will replace the current buffer (this restores behavior from pre
     5.2.0). If you wish new ESS processes to start in another window
     of the current frame, set inferior-ess-same-window to nil.

   * New variables inferior-Splus-args and inferior-R-args provide a
     way to pass command line arguments to starting S and R processes.

   Changes/New Features in 5.2.2:
   * bug-fixes for 5.2.1 (require 'executable), html docs, etc.

   * ess-lisp-directory/../doc/info added to Info-directory-list if
     ess-info not found by info

   * ESS[R]: If you have other versions of R on your exec-path, such as
     "R-1.8.1" with Unix or "rw1081" with Windows, ESS will find them
     and create appropriate functions, such as `M-x R-1.8.1' or `M-x
     rw1081', for calling them.  By default only Unix programs
     beginning "R-1" and "R-2" and Windows programs parallel to the
     version of R in your exec-path will be found, but see
     ess-r-versions and ess-rterm-versions for ways to find other
     versions of R.

   * ESS[R]: Other versions of R, such as "R-1.8.1" on Unix and
     "rw1081" on Windows, are added to the "ESS / Start Process /
     Other" menu.

   * ESS[S]: If you have other versions of S-Plus on your Windows
     computer, such as S-Plus 6.1 or S-Plus 4.5, ESS will find them and
     create appropriate functions, such as `M-x splus61', for calling
     the console version (Sqpe) inside an emacs buffer.  By default only
     programs installed in the default location will be found, but see
     ess-SHOME-versions for ways to find other versions of S-Plus.

   * ESS[S]: Other versions of Sqpe on Windows, such as "splus61", are
     added to the "ESS / Start Process / Other" menu.

   * ESS[R]: (bug fix) ess-quit (bound to `C-c C-q') should now quit the
     inferior R process, when issued from either the inferior buffer,
     or from a .R buffer.

   Changes/New Features in 5.2.1:
   * ESS[S] (R and S-plus): now have toolbar support with icons to
     evaluate code in the inferior process or to switch there.  This
     code is experimental and likely to change as XEmacs/Emacs issues
     get resolved. The toolbar should be enabled if your Emacs displays
     images, but can be disabled with the variable ess-use-toolbar.
     Thanks to David Smith from Insightful for the S-plus logo.

   * ESS[SAS]: ess-sas-graph-view (`F12') enhanced; you can specify
     external file viewers for each graphics file type via the alist
     ess-sas-graph-view-viewer-alist; also .jpg/.gif are now handled by
     image-mode on XEmacs, if available, otherwise by graphics
     primitives as before

   Changes/New Features in 5.2.0:
   * ESS[BUGS]:  new info documentation!  now supports interactive
     processing thanks to Aki Vehtari (mailto:Aki.Vehtari at hut.fi); new
     architecture-independent unix support as well as support for BUGS
     v. 0.5

   * ESS[SAS]:  convert .log to .sas with ess-sas-transcript; info
     documentation improved; Local Variable bug fixes; SAS/IML
     statements/functions now highlighted; files edited remotely by
     ange-ftp/EFS/tramp are recognized and pressing SUBMIT opens a
     buffer on the remote host via the local variable
     ess-sas-shell-buffer-remote-init which defaults to "ssh"; changed
     the definition of the variable ess-sas-edit-keys-toggle to boolean
     rather than 0/1; added the function ess-electric-run-semicolon
     which automatically reverse indents lines containing only "run;";
     `C-F1' creates MS RTF portrait from the current buffer; `C-F2'
     creates MS RTF landscape from the current buffer; `C-F9' opens a
     SAS DATASET with PROC INSIGHT rather than PROC FSVIEW; "inferior"
     aliases for SAS batch:  `C-c C-r' for submit region, `C-c C-b' for
     submit buffer, `C-c C-x' for goto .log; `C-c C-y' for goto .lst

   * ESS[S]: Pressing underscore ("_") once inserts " <- " (as before);
     pressing underscore twice inserts a literal underscore.  To stop
     this smart behaviour, add "(ess-toggle-underscore nil)" to your
     .emacs after ess-site has been loaded;
     ess-dump-filename-template-proto (new name!) now can be customized
     successfully (for S language dialects); Support for Imenu has been
     improved; set ess-imenu-use-S to non-nil to get an "Imenu-S" item
     on your menubar; ess-help: Now using nice underlines (instead of
     `nuke-* ^H_')

   * ESS[R]:  After (require 'essa-r), `M-x ess-r-var' allows to load
     numbers from any Emacs buffer into an existing *R* process; `M-x
     ess-rdired' gives a "directory editor" of R objects; fixed
     ess-retr-lastvalue-command, i.e. .Last.value bug (thanks to David

   * ESS: Support for creating new window frames has been added to ESS.
     Inferior ESS processes can be created in dedicated frames by
     setting inferior-ess-own-frame to t.  ESS help buffers can also
     open in new frames; see the documentation for ess-help-own-frame
     for details.  (Thanks to Kevin Rodgers for contributing code.)

More information about the ESS-help mailing list