[ESS] README organization

Martin Maechler maechler at stat.math.ethz.ch
Wed Dec 3 14:43:42 CET 2008


>>>>> "RoSp" == Rodney Sparapani <rsparapa at mcw.edu>
>>>>>     on Mon, 01 Dec 2008 16:42:09 -0600 writes:

    RoSp> tyler wrote:
    >> Hi,
    >> 
    >> I just installed 5.3.8 from the tarball. There isn't an INSTALL file,
    >> but readers of the README are directed to look 'way down' to find the
    >> instructions. I didn't notice this at first as I was quickly scanning
    >> the file for the heading "Installation", and nearly gave up after
    >> several hundred lines of News.
    >> 
    >> So, nothing is actually missing or even misleading, but for
    >> patience-challenged folks like me it might be helpful to pull the
    >> installation instructions up to the top of the file, or even into a
    >> separate INSTALL file. No big deal either way, just an idea.
    >> 
    >> Thanks for the ongoing efforts,
    >> 
    >> Tyler
    >> 

    RoSp> Hi Tyler:

    RoSp> This has been recommended before and vetoed, but I don't remember why. 
    RoSp> The way we create the docs is a little tricky right now.  I managed
    RoSp> to create the topics in the following order:

    RoSp> * License::
    RoSp> * Stability::
    RoSp> * Requirements::
    RoSp> * Latest Version::
    RoSp> * Installation::
    RoSp> * Starting an ESS Process::
    RoSp> * New Features::
    RoSp> * Current Features::
    RoSp> * Reporting Bugs::
    RoSp> * Mailing Lists::
    RoSp> * Authors::

    RoSp> If we can all agree on this, then I'll commit the changes.  See the proposed
    RoSp> README below:

I don't care too much, so I'd say "yes" since you Rodney have
evidently poured some thought into it...

Others opinions?

Martin


    RoSp> 1 General Information: README
    RoSp> *****************************

    RoSp> This is the README file for the distribution of ESS version

    RoSp> 5.3.9

    RoSp> ESS is a GNU Emacs and XEmacs mode for interactive statistical
    RoSp> programming and data analysis.  Languages supported: the S family (S
    RoSp> 3/4, S-PLUS 3/4/5/6/7, and R), SAS, XLispStat, Stata and BUGS.
    RoSp> Installation help can be found in sections for both Unix and Windows.
    RoSp> For INSTALLATION, see way below.

    RoSp> ESS grew out of the desire for bug fixes and extensions to S-mode and
    RoSp> SAS-mode as well as a consistent union of their features in one package.

    RoSp> The current development team is led by Martin Maechler since August
    RoSp> 2004. Former project leader A.J. (Tony) Rossini
    RoSp> (<rossini at blindglobe.net>) did the initial port to XEmacs and has been
    RoSp> the primary coder.  Martin Maechler (<maechler at stat.math.ethz.ch>) and
    RoSp> Kurt Hornik (<Kurt.Hornik at R-project.org>) have assisted with S-PLUS,
    RoSp> S4, R, and XLispStat.  Stephen Eglen (<stephen at gnu.org>) has worked
    RoSp> mostly on R support.  Richard M. Heiberger (<rmh at temple.edu>) has
    RoSp> assisted with S-PLUS and S4 development for Windows.  Richard and
    RoSp> Rodney A. Sparapani (<rsparapa at mcw.edu>) have done much of the work
    RoSp> implementing interactive SAS (iESS[SAS]) and batch SAS (ESS[SAS])
    RoSp> support.

    RoSp> We are grateful to the previous developers of S-mode (Doug Bates, Ed
    RoSp> Kademan, Frank Ritter, David M. Smith), SAS-mode (Tom Cook) and
    RoSp> Stata-mode (Thomas Lumley).

    RoSp> 1.1 License
    RoSp> ===========

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

    RoSp> ESS is distributed in the hope that it will be useful, but WITHOUT
    RoSp> ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    RoSp> FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    RoSp> in the file COPYING in the same directory as this file for more details.

    RoSp> 1.2 Stability
    RoSp> =============

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

    RoSp> 1.3 Requirements
    RoSp> ================

    RoSp> ESS has been tested with

    RoSp> * R >=0.49

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

    RoSp> * S4

    RoSp> * SAS >=6.12

    RoSp> * BUGS 0.5, 0.6

    RoSp> * JAGS 1.0

    RoSp> * Stata >=6.0 (command line only)

    RoSp> on the following platforms

    RoSp> * Linux/x86 (all)

    RoSp> * Solaris (all)

    RoSp> * MS Windows 98/NT/2000/XP (R, S-PLUS, SAS interactive only, and
    RoSp> BUGS)

    RoSp> * Apple Mac OS X 10.4-5 (R, JAGS, Stata)

    RoSp> with the following versions of emacs

    RoSp> * GNU Emacs 20.3-7, 21.1, 21.3-4, 22.1

    RoSp> * XEmacs 21.4.0-8, 21.4.9-13(1), 21.4.14-15, 21.4.17-21 (betas not
    RoSp> supported, but 21.5.23+ may work)

    RoSp> ---------- Footnotes ----------

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

    RoSp> 1.4 Getting the Latest Version
    RoSp> ==============================

    RoSp> The latest released version of ESS is always available on the web at:
    RoSp> ESS web page (http://ess.r-project.org) or StatLib
    RoSp> (http://lib.stat.cmu.edu/general/ESS/)

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

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

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

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

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

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

    RoSp> 1.5 Installation (from tar file)
    RoSp> ================================

    RoSp> 1.6 Unix installation
    RoSp> =====================

    RoSp> 1.  `cd' to a directory where you keep emacs lisp files, or create a
    RoSp> new directory (for example, `$HOME/emacs') to hold the
    RoSp> distribution.  This directory will be referred to below as "the
    RoSp> ESS distribution directory".

    RoSp> _Note for XEmacs packages:_ ESS is no longer available as an
    RoSp> XEmacs package.  But, you can still install ESS into the XEmacs
    RoSp> package system by choosing
    RoSp> `ESSDIR'=`PREFIX/lib/xemacs/site-packages'.  ESS requires that the
    RoSp> XEmacs sumo tarball (all XEmacs packages combined) also be
    RoSp> installed.  For information on installing XEmacs packages, follow
    RoSp> this link: Quickstart Package Guide
    RoSp> (http://www.xemacs.org/Documentation/packageGuide.html).

    RoSp> 2. Retrieve the latest version from ESS downloads area
    RoSp> (http://ess.r-project.org/downloads/ess) to `ESSDIR'.

    RoSp> 3. Extract the files from the disribution.
    RoSp> If you are using GNU tar, `tar zxf ess-VERSION.tgz'.
    RoSp> Otherwise, `gunzip < ess-VERSION.tgz | tar xf -',

    RoSp> The `tar' command will create the subdirectory `ess-VERSION' and
    RoSp> install the files there.

    RoSp> 4. Edit the file `ESSDIR/ess-VERSION/lisp/ess-site.el' as explained
    RoSp> in the comments section of that file.

    RoSp> 5. If you are using GNU Emacs add the line
    RoSp> (load "ESSDIR/ess-VERSION/lisp/ess-site")
    RoSp> to `$HOME/.emacs'.  For XEmacs, if you followed the XEmacs package
    RoSp> system installation advice, add the line
    RoSp> (require 'ess-site)
    RoSp> to `$HOME/.xemacs/init.el'.  Otherwise, for XEmacs, add the line
    RoSp> (load "ESSDIR/ess-VERSION/lisp/ess-site")
    RoSp> to `$HOME/.xemacs/init.el'.

    RoSp> 6. That's it!  ESS is now ready to use.  (The remaining step below is
    RoSp> only for a custom installation.)  To edit statistical programs,
    RoSp> just open files with the requisite extensions (`.R' for R, `.sas'
    RoSp> for SAS, `.bug' for BUGS, etc.).  To start a statistical process
    RoSp> within emacs, such as R, type `M-x R'.

    RoSp> 7. (OPTIONAL) READ THIS ITEM THOROUGHLY BEFORE STARTING:

    RoSp> If you want to place the compiled files in other locations edit the
    RoSp> `LISPDIR', `INFODIR' and `ETCDIR' entries in Section 1 of
    RoSp> `Makeconf' in the `ESSDIR/ess-VERSION' directory (if you are using
    RoSp> XEmacs, then uncomment the XEmacs subsection in Section 1).

    RoSp> You can compile those files by:
    RoSp> make all

    RoSp> When that completes successfully, install the compiled files:
    RoSp> make install


    RoSp> 1.7 Microsoft Windows installation
    RoSp> ==================================

    RoSp> For Microsoft Windows installation, please follow the next steps.

    RoSp> 1. `cd' to a directory where you keep emacs lisp files, or create a
    RoSp> new directory (for example, `c:\emacs\') to hold the distribution.
    RoSp> This directory will be referred to below as "the ESS distribution
    RoSp> directory".

    RoSp> _Note for XEmacs packages:_ ESS is no longer available as an XEmacs
    RoSp> package. But, you can still install ESS into the XEmacs package
    RoSp> system by choosing `ESSDIR'=`PREFIX\XEmacs\site-packages'.  ESS
    RoSp> requires that the XEmacs sumo tarball (all XEmacs packages
    RoSp> combined) also be installed.  For information on installing XEmacs
    RoSp> packages, follow this link: Quickstart Package Guide
    RoSp> (http://www.xemacs.org/Documentation/packageGuide.html).

    RoSp> 2. Retrieve the latest zip file (`ess-VERSION.zip') from ESS
    RoSp> downloads area (http://ess.r-project.org/downloads/ess) and store
    RoSp> it in the ESS distribution directory.  Be aware that http browsers
    RoSp> on Windows frequently change the "." and "-" characters in
    RoSp> filenames to other punctuation.  Please change the names back to
    RoSp> their original form.

    RoSp> 3. Extract all the files from `ess-VERSION.zip' into the ESS
    RoSp> distribution directory as `c:\emacs\ess-VERSION\'.  (It is possible
    RoSp> to unpack the zip archive in Windows Explorer by double clicking
    RoSp> on the folder; you should then see a new folder called
    RoSp> `ess-VERSION'.  Drag that folder into your ESS distribution
    RoSp> directory.)

    RoSp> 4. If you are using GNU Emacs add the line
    RoSp> (load "ESSDIR/ess-VERSION/lisp/ess-site")
    RoSp> to `%HOME%/.emacs'.  For XEmacs, if you followed the XEmacs
    RoSp> package system installation advice, add the line
    RoSp> (require 'ess-site)
    RoSp> to `%HOME%/.xemacs/init.el'.  Otherwise, for XEmacs, add the line
    RoSp> (load "ESSDIR/ess-VERSION/lisp/ess-site")
    RoSp> to `%HOME%/.xemacs/init.el'.  _Note:_ Both GNU Emacs and XEmacs
    RoSp> require that the HOME environment variable be set on your system,
    RoSp> otherwise, your initialization file will not be utilized, and
    RoSp> therefore, ESS will not work.

    RoSp> After saving your initialization file, ESS is now installed.
    RoSp> Start a new emacs and you should be ready to use ESS.  For
    RoSp> example, to edit statistical programs, load the files with the
    RoSp> requisite extensions (".sas" for SAS, ".S" or "s" or "q" or "Q"
    RoSp> for S-PLUS, ".r" or ".R" for R, and ".lsp" for XLispStat).  One
    RoSp> further step is needed if you wish to run statistical processes,
    RoSp> see below.

    RoSp> 5. To run statistical processes under ESS, Windows users will need to
    RoSp> make sure that the directories for the software they will be using
    RoSp> is in the PATH environment variable.  On Windows 9x, add lines
    RoSp> similar to the following to your `c:\autoexec.bat' file:
    RoSp> path=%PATH%;c:\progra~1\insightful\splus70\cmd
    RoSp> On Windows NT/2000/XP, add the directories to the PATH using the
    RoSp> `My Computer/Control Panel/System/Advanced/Environment Variables'
    RoSp> menu.  Note that the directory containing the program is added to
    RoSp> the PATH, not the program itself.  One such line is needed for
    RoSp> each software program.  Be sure to use the abbreviation `progra~1'
    RoSp> and not the long version with embedded blanks.  Use backslashes
    RoSp> "`\'".

    RoSp> An alternative, for R users, is that rather than adjusting the PATH
    RoSp> variable, you can add the following to your emacs initialization
    RoSp> file (and restart emacs):
    RoSp> (setq inferior-R-program-name 
    RoSp> "C:/progra~1/R/R-2.2.1/bin/Rterm.exe")
    RoSp> This assumes that you have installed R-2.2.1 in the default
    RoSp> location.  Change the path otherwise to point to other locations.

    RoSp> Windows users who place S-PLUS anywhere other than the default
    RoSp> location will also need to add the following three lines (properly
    RoSp> adjusted for their location) to their `%HOME%/.emacs' or
    RoSp> `%HOME%/.xemacs/init.el' file:
    RoSp> (setq-default inferior-S+6-program-name
    RoSp> "c:/progra~1/Insightful/SPLUS70/cmd/Splus")
    RoSp> (setq-default inferior-Sqpe+6-SHOME-name
    RoSp> "c:/progra~1/Insightful/SPLUS70")
    RoSp> (setq-default inferior-Sqpe+6-program-name
    RoSp> "c:/progra~1/Insightful/SPLUS70/cmd/Sqpe.exe")
    RoSp> The above example uses the default location of S-PLUS in
    RoSp> `c:/progra~1/Insightful'.  Please note that ESS considers S-PLUS
    RoSp> 6, 7, and 8 to be variants of S+6.

    RoSp> These users may also need to modify the emacs variable
    RoSp> `ess-SHOME-versions' to match their installation in order to get
    RoSp> the full set of S-PLUS versions on their machine into the `ESS'
    RoSp> menu.

    RoSp> To start the S-PLUS [678].x GUI from ESS under emacs:
    RoSp> 1. If you use Cygwin bash as your primary shell, then
    RoSp> M-x S
    RoSp> (or `M-x S+6').

    RoSp> 2. If you use the MSDOS prompt window as your primary shell, then
    RoSp> M-x S+6-msdos
    RoSp> You will then be asked for a pathname ("S starting data
    RoSp> directory?"), from which to start the process.  The prompt will
    RoSp> propose your current directory as the default.  ESS will start the
    RoSp> S-PLUS GUI.  There will be slight delay during which emacs is
    RoSp> temporarily frozen.  ESS will arrange for communication with the
    RoSp> S-PLUS GUI using the DDE protocol.  Send lines or regions from the
    RoSp> emacs buffer containing your S program (for example, `myfile.s')
    RoSp> to the S-PLUS Commands Window with the `C-c C-n' or `C-c C-r' keys.
    RoSp> (If you are still using S-PLUS 4.x or 2000,\ then use `M-x S+4' or
    RoSp> `M-x S+4-msdos'.)

    RoSp> To start an S-PLUS [678].x session inside an emacs buffer--and
    RoSp> without the S-PLUS GUI:
    RoSp> M-x Sqpe
    RoSp> (or `M-x Sqpe+6').
    RoSp> This works with both the bash and msdos shells.  You will then be
    RoSp> asked for a pathname ("S starting data directory?"), from which to
    RoSp> start the process.  The prompt will propose your current directory
    RoSp> as the default.  You get Unix-like behavior, in particular the
    RoSp> entire transcript is available for emacs-style search commands.
    RoSp> Send lines or regions from the emacs buffer containing your S
    RoSp> program (for example, `myfile.s') to the *S+6* buffer with the
    RoSp> `C-c C-n' or `C-c C-r' keys.  Interactive graphics are available
    RoSp> with Sqpe by using the java library supplied with S-PLUS 6.1 and
    RoSp> newer releases.  Enter the commands:
    RoSp> library(winjava)
    RoSp> java.graph()
    RoSp> Graphs can be saved from the `java.graph' device in several
    RoSp> formats, but not PostScript.   If you need a PostScript file you
    RoSp> will need to open a separate `postscript' device.  (If you are
    RoSp> still using S-PLUS 4.x or 2000, then use `M-x Sqpe+4'.)

    RoSp> To connect to an already running S-PLUS GUI (started, for example,
    RoSp> from the S-PLUS icon):
    RoSp> M-x S+6-existing
    RoSp> or
    RoSp> M-x S+6-msdos-existing
    RoSp> You will then be asked for a pathname ("S starting data
    RoSp> directory?"), from which to start the process.  The prompt will
    RoSp> propose your current directory as the default.  ESS will arrange
    RoSp> for communication with the already running S-PLUS GUI using the
    RoSp> DDE protocol.  Send lines or regions from the emacs buffer
    RoSp> containing your S program (for example, `myfile.s') to the S-PLUS
    RoSp> Commands Window with the `C-c C-n' or `C-c C-r' keys.  (If you are
    RoSp> still using S-PLUS 4.x or 2000,  then use `M-x S+4-existing' or
    RoSp> `M-x S+4-msdos-existing'.)

    RoSp> If you wish to run R, you can start it with:
    RoSp> M-x R

    RoSp> XLispStat can not currently be run with
    RoSp> M-x XLS
    RoSp> Hopefully, this will change.  However, you can still edit with
    RoSp> emacs, and cut and paste the results into the XLispStat *Listener*
    RoSp> Window under Microsoft Windows.

    RoSp> 6. That's it!


    RoSp> 1.8 Starting an ESS process
    RoSp> ===========================

    RoSp> To start an S session on Unix or on Windows when you use the Cygwin
    RoSp> bash shell, simply type `M-x S RET'.

    RoSp> To start an S session on Windows when you use the MSDOS prompt
    RoSp> shell, simply type `M-x S+6-msdos RET'.

    RoSp> 1.9 Current Features
    RoSp> ====================

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

    RoSp> * SAS

    RoSp> * BUGS/JAGS

    RoSp> * Stata

    RoSp> * XLispStat including Arc and ViSta

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

    RoSp> * Partial evaluation of code

    RoSp> * Loading and error-checking of code

    RoSp> * Source code revision maintenance

    RoSp> * Batch execution (SAS, BUGS/JAGS)

    RoSp> * Use of imenu to provide links to appropriate functions

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

    RoSp> * Searchable Command history

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

    RoSp> * Quick access to object lists and search lists

    RoSp> * Transcript recording

    RoSp> * Interface to the help system

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

    RoSp> * Manipulating and editing saved transcripts

    RoSp> * Re-evaluating commands from transcript files

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

    RoSp> * Sending Examples to running ESS process.

    RoSp> * Previewing

    RoSp> 1.10 New Features
    RoSp> =================

    RoSp> Changes/New Features in 5.3.10:
    RoSp> * Fixed noweb-mode bug accidentally introduced into 5.3.9

    RoSp> * In noweb-mode, e.g., Rnw-mode, electric "<" also inserts closing
    RoSp> "@".   Further, the code chunk boundaries are better kept
    RoSp> up-to-date, such that  code[R] <-> text[LaTeX] minor mode
    RoSp> switching should happen more reliably.

    RoSp> Changes/New Features in 5.3.9:
    RoSp> * ESS[SAS]: evince PDF viewer now supported as well; search order:
    RoSp> evince, Xpdf, Adobe/Acrobat Reader

    RoSp> * ESS[R]: added support for Roxygen, potentially to be extended.

    RoSp> * ESS[S] (and R): inferior (`*R*') and transcript modes no longer
    RoSp> fontify language keywords (such as `for', `in', etc).

    RoSp> * iESS[Stata]: Customize the `ess-sta-delimiter-friendly' setting to
    RoSp> t to convert embedded semi-colons to newlines for Stata processing.

    RoSp> * Sweave fix for embedded blanks in PDF reader and PDF files

    RoSp> * Several fixes for Major Mode Convention violations in `ess-mode'
    RoSp> and `noweb-mode'.

    RoSp> * ESS[JAGS]: `M-x comment-region' now available!

    RoSp> * ESS[S] The `ess-swv-*' commands (and keybindings) are now in a
    RoSp> submenu of the "Noweb" menu, when editing Sweave files.

    RoSp> Changes/New Features in 5.3.8:
    RoSp> * ESS[JAGS]: more separation from ESS[BUGS] (as much as is currently
    RoSp> planned); now `C-c C-c' on an empty `.jmd' creates a template as
    RoSp> it should; symbolic links are created for CODA output so BOA is
    RoSp> happy: from `index.txt' to `.ind' and `chain#.txt' to `#.out'

    RoSp> * ESS[SAS]: buffer-local `ess-sas-submit-command' and
    RoSp> `ess-sas-submit-command-options' now recognized by
    RoSp> `ess-sas-submit-region'

    RoSp> * ESS[S]: When trying to evaluate code in an S language buffer and
    RoSp> there is no associated process, now start R automatically instead
    RoSp> of  signalling an error.  Also, restart R if there is an
    RoSp> associated process  which is not running.  However, do not start R
    RoSp> just via the "electric"  `(' (`ess-r-args-auto-show').

    RoSp> * ESS[S]: For (one-line) functions withOUT '{ .. }' bodys, the end
    RoSp> of function is now correctly found more often.  This notably
    RoSp> improves  `C-c C-c' (`ess-eval-function-or-paragraph-and-step').

    RoSp> * ESS[JAGS]: cleanup/re-organization of elisp code; symbolic links
    RoSp> for CODA output are now only created by the new JAGS `system'
    RoSp> command in version 1.0.3; specify whether this command is
    RoSp> available via `ess-jags-system'; if not present, then no links are
    RoSp> created so that the `*shell*' buffer does not become unresponsive
    RoSp> during the batch run

    RoSp> Changes/New Features in 5.3.7:
    RoSp> * ESS: `ess-default-style' now *is* customizable, i.e.,   changing
    RoSp> its value in `~/.emacs' now does have the desired effect.

    RoSp> * ESS: `ess-font-lock-mode' is a new variable (default: t) which
    RoSp> controls whether font-locking is enabled in ESS buffers.

    RoSp> * ESS[R]: for XEmacs on Windows; another tweak to find R versions

    RoSp> * ESS[SAS]: font-locking updated for ODS and SAS Bayesian Procedures;
    RoSp> a more consistent handling of SAS options by
    RoSp> `ess-sas-submit-command-options' which is buffer-local; portable
    RoSp> snooze for MS Windows via customize-able `ess-sleep-for' (floats
    RoSp> welcome); Xpdf now supported as a PDF viewer

    RoSp> * ESS[Rnw]: now also works with "emacs -nw" and Emacs 22.

    RoSp> * ESS[JAGS]: now requires JAGS 1.0 (see the new ESS for JAGS help
    RoSp> section for more information): both need work; suggestions welcome

    RoSp> * ESS[R]: [TAB] completion now uses the R-internal completion
    RoSp> mechanism (for R >= 2.5.0).

    RoSp> * ESS[R] ([S]): interpretation of "_" as assignment has been removed
    RoSp> in `ess-continued-statement-p' for R and S.

    RoSp> * several internal code cleanups.

    RoSp> * ESS[R]: An experimental version of a new command `Rgui' on MS
    RoSp> Windows to send lines directly from emacs to `Rgui' is available
    RoSp> in file `lisp/essd-rgui.el'.  Preliminary documentation is in file
    RoSp> `doc/rgui-doc.txt'.

    RoSp> Changes/New Features in 5.3.6:
    RoSp> * ESS: for XEmacs, using "gnuclient" (without a "-q") works for
    RoSp> things like fix() after M-x gnuserv-start has been done.

    RoSp> * ESS[R]: M-x R-newest should now work in more situations on MS
    RoSp> Windows, e.g., when R has been installed in a non-default
    RoSp> "ProgramFiles"  directory tree.  In these cases, there's no need
    RoSp> to specify the name (and  full path) of the R program anymore.

    RoSp> * ESS[R]: For XEmacs, startup (with new tooltip code) works again.

    RoSp> Changes/New Features in 5.3.5:
    RoSp> * ESS[R] a new defun is available, `M-x R-newest', which will start
    RoSp> the newest version of R that it can find on your system.

    RoSp> * ESS[R] add Sven Hartenstein's "R function arguments tips"
    RoSp> functionality, via new file `../lisp/essd-r-args.el'.   Note that
    RoSp> this includes an "electric "("" behavior inside `R-mode'  which is
    RoSp> _active by default_ and can be customized via
    RoSp> `ess-r-args-electric-paren'; i.e., use `(setq
    RoSp> ess-r-args-electric-paren nil)' to turn it off.  Further,
    RoSp> `ess-r-args-show-as' allows to switch to the "tooltip" mode.

    RoSp> * ESS: functions `ess-get-pdf-viewer' and *-ps-viewer; built on new
    RoSp> customizable variables `ess-pdf-viewer-pref' and
    RoSp> `ess-ps-viewer-pref'; currently used in `ess-swv-PDF' and  `*-PS'.

    RoSp> * ESS[R] Improved `ess-swv-PDF' to run pdf viewer only if  pdflatex
    RoSp> was ok

    RoSp> * ESS[R] Improved `ess-swv-weave' to start R automatically if  none
    RoSp> is running.

    RoSp> * ESS: Do no longer ask _which_ ESS process to use if there  is only
    RoSp> one.

    RoSp> Changes/New Features in 5.3.4:
    RoSp> * ESS[R] now better work with options(error=recover); and the new
    RoSp> default of CHM help files on windows.

    RoSp> * ESS[R] some more cleanup in the "sweave" functions

    RoSp> * miscellaneous fixes

    RoSp> Changes/New Features in 5.3.3:
    RoSp> * ESS[S] fix buglet (5.3.2 only) which left command prompt in
    RoSp> "execute buffer" and hence help files.

    RoSp> * new customizable variable `ess-display-buffer-reuse-frames' set to
    RoSp> true (which changes default behavior) such that execution or help
    RoSp> *frames* are reused.

    RoSp> Changes/New Features in 5.3.2:
    RoSp> * Classic BUGS now supported by `(require 'essd-bugs)' with ESS[BUGS]
    RoSp> and JAGS by `(require 'essd-jags)' with ESS[JAGS].  But,
    RoSp> only one       of them can be used at a time since they don't play
    RoSp> nice together.  Also,       `C-c C-c' is now bound to the function
    RoSp> `ess-bugs-next-action'       (`F12' has been retired).  And
    RoSp> finally, note that `essl-bug.el'       is deprecated and the
    RoSp> replacement is `essl-bugs.el'.

    RoSp> * ESS[R] Improved some of the "Sweave-make"  functions (yet scarcely
    RoSp> documented) in `ess-swv.el'.

    RoSp> * ESS[S] No longer mess with .Last.value (nor in other "languages").

    RoSp> Changes/New Features in 5.3.1:
    RoSp> * See the docs for 2 ways to install ESS for XEmacs
    RoSp> 1. by uncommenting the XEmacs part of             Section 1 of
    RoSp> `Makeconf' and performing `make install'

    RoSp> 2. by unpacking either             `ess-5.3.1.tgz' or
    RoSp> `ess-5.3.1.zip' into
    RoSp> `PREFIX/lib/xemacs/site-packages' on unix or
    RoSp> `PREFIX\XEmacs\site-packages' on windows

    RoSp> * ESS[R]: fixed bugs so that Rterm.exe can be found by XEmacs

    RoSp> * ESS[S]: `ess-toggle-S-assign-key' is slightly changed; in
    RoSp> particular, the default `ess-assign-key' is now `C-x ='.

    RoSp> * ESS[R]: `M-x R-site-search' is a new (slightly experimental)
    RoSp> utility similar to R's `RSiteSearch(..)' but with the advantage of
    RoSp> using Emacs' preferred browser, see `browse-url-browser-function'

    RoSp> Changes/New Features in 5.3.0:
    RoSp> * ESS[BUGS]: sanely re-format statistical output, `.bog', from
    RoSp> scientific notation to numbers rounded with 4 decimal places with
    RoSp> `M-x ess-bugs-sci-round-to-4-dp'.

    RoSp> * The keys for navigating among section headings in help buffers
    RoSp> worked, but only for one language per session; they should now
    RoSp> work for multiple languages.  (They were also broken on Windows
    RoSp> machines.)

    RoSp> * ESS[S] long standing buglets in the internal logic for loading
    RoSp> lisp code on Windows.  Particularly fixed behavior in help mode
    RoSp> with S-plus GUI.

    RoSp> * New variable, `ess-use-inferior-program-name-in-buffer-name',
    RoSp> which enables using the executable name instead of the dialect
    RoSp> name for R. Feature request.

    RoSp> * ESS[S] `ess-execute-screen-options' now also works correctly when
    RoSp> there is more than one window *side-by-side* in the same frame and
    RoSp> runs in the correct buffer also when there is more than one S
    RoSp> buffer.

    RoSp> * iESS[S] new functions `ess-eval-paragraph-and-step' and
    RoSp> `ess-eval-function-or-paragraph-and-step' are bound to keys  `C-c
    RoSp> C-p' and `C-c C-c' respectively and to the menu in  ESS-mode; also
    RoSp> bound in the help mode (for evaluating examples).

    RoSp> * ESS[S] new function `ess-toggle-S-assign-key' allows to assign the
    RoSp> " <- " insertion to an arbitrary key.

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

    RoSp> * Rterm/Cygwin combination works under Microsoft Windows.

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

    RoSp> * New experimental support for installing ESS.  See the file
    RoSp> `lisp/ess-install.el'.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    RoSp> * S-Plus 7 for Windows is now recognized.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    RoSp> Changes/New Features in 5.1.24:
    RoSp> * The version number is now correct even inside ESS/Emacs

    RoSp> Changes/New Features in 5.1.23:
    RoSp> * Minor more Makefile clean up.

    RoSp> Changes/New Features in 5.1.22:
    RoSp> * Besides info documentation, PDF and HTML documentation are also
    RoSp> provided (instead of built using "make") and available on the web
    RoSp> as well; see ESS web page (http://ess.r-project.org/) and StatLib
    RoSp> (http://lib.stat.cmu.edu/general/ESS/doc)

    RoSp> * Now that info documentation is available, the README.* files are
    RoSp> no longer supported.  However, they are still distributed for what
    RoSp> it's worth.

    RoSp> * ESS is now an XEmacs package!  See XEmacs Installation HOWTO
    RoSp> (http://www.xemacs.org/Install/index.html) for details
    RoSp> (specifically, items 10-15).

    RoSp> * ESS[SAS]: more user-friendly enhancements for remote SAS batch
    RoSp> jobs with Kermit file transfers (LOG and OUTPUT function key
    RoSp> features now supported).  Multiple shells now supported so you can
    RoSp> run SAS on different computers from different buffers by setting
    RoSp> the buffer-local variable ess-sas-shell-buffer to unique buffer
    RoSp> names.

    RoSp> * Major re-vamping of Makefile/Makeconf.

    RoSp> Changes/New Features in 5.1.21:
    RoSp> * ESS[SAS]: info documentation now available!, see ESS->Help for
    RoSp> SAS; `F12' opens GSASFILE nearest point for viewing either within
    RoSp> emacs, when available, or via an external viewer; more syntax
    RoSp> highlighting keywords; more enhancements for remote SAS batch jobs
    RoSp> with Kermit; new framework for remote SAS interactive jobs, see
    RoSp> ess-remote

    RoSp> * ESS[S]: info documentation now available!, see ESS->Help for the S
    RoSp> family

    RoSp> * Makefile: tag now independent of rel; info files made by
    RoSp> doc/Makefile and installed in new info sub-directory

    RoSp> Changes/New Features in 5.1.20:
    RoSp> * New `options()$STERM' in the S dialects (S, S-Plus, R).  The S
    RoSp> program can determine the environment in which it is currently
    RoSp> running.  ESS sets the option to `iESS' or `ddeESS' when it starts
    RoSp> an S language process.  We recommend other specific values for S
    RoSp> language processes that ESS does not start.

    RoSp> * New `ess-mouse-me' function, assigned to S-mouse-3 by default.
    RoSp> User may click on a word or region and then choose from the menu
    RoSp> to display the item, or a summary, or a plot, etc.  This feature
    RoSp> is still under development.

    RoSp> * GNU Emacs 21.1 is now supported (fixed for S dialects, SAS & BUGS),
    RoSp> (some from Stephen Eglen).

    RoSp> * XEmacs 21.x is now supported (fixed w32-using-nt bug)

    RoSp> * XEmacs on Win (NT) is better supported.

    RoSp> * Workaround for bug in Sqpe+6 (S-PLUS 6 for Win).

    RoSp> * should now work even when imenu is not available (for old
    RoSp> XEmacsen).

    RoSp> * ESS[SAS]: XEmacs-Imenu fix; `C-TAB' is globalized along with your
    RoSp> function-key definitions, if specified; you can specify your SAS
    RoSp> library definitions outside of autoexec.sas for ess-sas-data-view
    RoSp> with SAS code placed in the variable ess-sas-data-view-libname,
    RoSp> also the dataset name is defaulted to the nearest permanent dataset
    RoSp> to point; Speedbar support now works for permanent datasets, please
    RoSp> ignore first./last.; new font-locking is now the default with more
    RoSp> improvements for font-locking PROCs, macro statements, * ; and %* ;
    RoSp> comments; you can toggle sas-log-mode with `F10' which will
    RoSp> font-lock your .log (if it isn't too big); submit remote .sas
    RoSp> files accessed with ange-ftp, EFS or Tramp (Kermit is
    RoSp> experimental) by setting ess-sas-submit-method to 'sh;
    RoSp> ess-sas-submit-command and ess-sas-submit-command-options are
    RoSp> buffer-local so you can have local file variable sections at the
    RoSp> end of your .sas files to request different executables or specify
    RoSp> special options and the local file variables are re-read at submit
    RoSp> instead of only at file open so that if you make a change it is
    RoSp> picked up immediately;

    RoSp> * ESS[BUGS]: font-lock with `in' fixed.

    RoSp> * for STATA: font-lock bug fixed.

    RoSp> * for Rd mode: `C-c C-v' and `switch-process' in menu.  further,
    RoSp> `C-c C-f' prefix (Rd-font) for inserting or surrounding a word by
    RoSp> things such as \code{.}, \code{\link{.}}, \emph{.} etc.

    RoSp> * new functions (ess-directory-function) and (ess-narrow-to-defun)
    RoSp> ess-directory <-> default-directory logic (Jeff Mincy).

    RoSp> * Re-organized Makefile and fixed a few bugs.

    RoSp> Changes/New Features in 5.1.19:
    RoSp> * S+6 now supported (Tony Rossini (Unix) and Rich Heiberger
    RoSp> (Windows))

    RoSp> * New BUGS support through ESS[BUGS] mode (Rodney Sparapani)
    RoSp> Templates assist you in writing .bug and .cmd code (.cmd and .log
    RoSp> are replaced by .bmd and .bog to avoid emacs extension collisions).
    RoSp> Substitution" parameters facilitate "automagic" generation of
    RoSp> data...in" and "init...in" filenames, "const N=" from your data
    RoSp> file and "monitor()/stats()" commands.  Activated by pressing
    RoSp> `F12'.

    RoSp> * Fixes for `ess-smart-underscore' SAS breakage (Rich Heiberger)

    RoSp> * You can change between PC and Unix, local and global SAS
    RoSp> function-key definitions interactively (Rich Heiberger)

    RoSp> * `C-Submit' a highlighted region to SAS batch (Rodney Sparapani)

    RoSp> * New and improved SAS syntax highlighting (Rodney Sparapani) To get
    RoSp> the new functionality, set ess-sas-run-make-regexp to nil.  Also
    RoSp> available in .log files via `F10'.

    RoSp> * Open a permanent SAS dataset for viewing via `F9' (Rodney
    RoSp> Sparapani) You must have the library defined in autoexec.sas for
    RoSp> it to work.

    RoSp> * User-friendly defaults for `sas-program',
    RoSp> `ess-sas-batch-pre-command' and `ess-sas-batch-post-command' as
    RoSp> well Customize support for these and other ESS[SAS] variables
    RoSp> (Rodney Sparapani)

    RoSp> * `ess-sas-suffix-2' now defaults to .dat via `F11' (Rodney
    RoSp> Sparapani)

    RoSp> * Emacs/XEmacs, Unix/Windows issues collectively handled in
    RoSp> ess-emcs.el

    RoSp> * defadvice solves problem of missing *ESS* (thanks to Jeff Mincy)

    RoSp> * Improved manual a bit by including things that were only in
    RoSp> `README'.

    RoSp> Changes/New Features in 5.1.18:
    RoSp> * New `ess-smart-underscore' function, now assigned to "_" by
    RoSp> default.  Inserts `ess-S-assign' (customizable " <- "), unless
    RoSp> inside string and comments where plain "_" is used instead. (MM)

    RoSp> * Fixes for longstanding interactive SAS breakage (RMH)

    RoSp> Changes/New Features in 5.1.17:
    RoSp> * Documentation for Windows Installation (Rich Heiberger)

    RoSp> * removal of ess-vars, finalization of customize support (in the
    RoSp> sense that there is no more use of ess-vars, but that we need to
    RoSp> fix ess-cust) (AJ Rossini)

    RoSp> * Many small (and large) fixes/contributions (MMaechler)

    RoSp> * addition of the "S-equal" variable and provide `M-x
    RoSp> ess-add-MM-keys' a way to remap "_" to `ess-S-assign', typically "
    RoSp> <- ", but customizable. (MMaechler)

    RoSp> Changes/New Features in 5.1.16:
    RoSp> * BUG FIXES

    RoSp> * Better SAS support

    RoSp> Changes/New Features in 5.1.15:
    RoSp> * BUG FIXES

    RoSp> Changes/New Features in 5.1.14:
    RoSp> * Yet more fixes to SAS mode, (Rich Heiberger and Rodney Sparapani)

    RoSp> * Customize support (for most Emacsen which support it) (AJRossini)

    RoSp> * ARC and ViSta support out of the box, and fixes for XLispStat
    RoSp> (AJRossini)

    RoSp> Changes/New Features in 5.1.13:
    RoSp> * Version numbering finally all depending on the ./VERSION file,
    RoSp> thanks to Martin Maechler.

    RoSp> * Yet more fixes to SAS mode, thanks to Rich Heiberger.

    RoSp> Changes/New Features in 5.1.12:
    RoSp> * Splus 5.1 stabilized, thanks to Martin Maechler, Bill Venables,
    RoSp> Chuck Taylor, and others.

    RoSp> * More fixes to SAS mode, thanks to Rodney Sparapani and Rich
    RoSp> Heiberger.

    RoSp> Changes/New Features in 5.1.11:
    RoSp> * More fixes to Stata mode, thanks to Brendan Halpin
    RoSp> (mailto:brendan at essex.ac.uk).

    RoSp> * fixed bugs in ESS-elsewhere, thanks to many testers

    RoSp> * README.SPLUS4WIN has DETAILED instructions for S-PLUS 2000, thanks
    RoSp> to David Brahm (mailto:brahm at alum.mit.edu).

    RoSp> * Fixes to SAS mode, thanks to Rodney Sparapani

    RoSp> Changes/New Features in 5.1.10:
    RoSp> * More fixes to Stata mode

    RoSp> * primitive generic version of ESS-elsewhere

    RoSp> * Small fixes to SAS/Stata.

    RoSp> Changes/New Features in 5.1.9:
    RoSp> * Stata mode works

    RoSp> * Literate Data Analysis using Noweb works

    RoSp> Changes/New Features in 5.1.8:
    RoSp> * Bug fixes

    RoSp> * R documentation mode defaults changed

    RoSp> Changes/New Features in 5.1.2:
    RoSp> * able to use inferior iESS mode to communicate directly with a
    RoSp> running S-Plus 4.x process using the Microsoft DDE protocol.  We
    RoSp> use the familiar (from Unix ESS) `C-c C-n' and related key
    RoSp> sequences to send lines from the S-mode file to the inferior S
    RoSp> process.  We continue to edit S input files in ESS[S] mode and
    RoSp> transcripts of previous S sessions in ESS Transcript mode.  All
    RoSp> three modes know the S language, syntax, and indentation patterns
    RoSp> and provide the syntactic highlighting that eases the programming
    RoSp> tasks.

    RoSp> 1.11 Reporting Bugs
    RoSp> ===================

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

    RoSp> The easiest way to do this is within Emacs by typing

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

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

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

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

    RoSp> 1.12 Mailing Lists
    RoSp> ==================

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

    RoSp> The purposes of the mailing list include

    RoSp> *  helping users of ESS to get along with it.

    RoSp> *  discussing aspects of using ESS on Emacs and XEmacs.

    RoSp> *  suggestions for improvements.

    RoSp> *  announcements of new releases of ESS.

    RoSp> *  posting small patches to ESS.

    RoSp> 1.13 Authors
    RoSp> ============

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

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

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

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

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

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



    RoSp> -- 
    RoSp> Rodney Sparapani      Center for Patient Care & Outcomes Research (PCOR)
    RoSp> Sr. Biostatistician              http://www.mcw.edu/pcor
    RoSp> 4 wheels good, 2 wheels better!  Medical College of Wisconsin (MCW)
    RoSp> WWLD?:  What Would Lombardi Do?  Milwaukee, WI, USA

    RoSp> ______________________________________________
    RoSp> ESS-help at stat.math.ethz.ch mailing list
    RoSp> https://stat.ethz.ch/mailman/listinfo/ess-help




More information about the ESS-help mailing list