[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