One of my projects, swankr
(essentially, a SLIME for R, reusing most
of the existing communication protocol and implementing a SWANK
backend in R, hence the name), obviously depends on SLIME: if nothing
else, the existing instructions for getting swankr up and running
included a suggestion to get the SLIME sources from
CVS, which as Zach says is
a problem that it's nice no longer to have. (Incidentally, Zach is
running a survey –
– to assess possible effects of changes on the SLIME userbase.)
So, time to update the instructions, and in the process also
- hoover up any obvious patches from my inbox;
- improve the startup configuration so that the user need do no
explicit configuration beyond a suitable entry in
- update the
TODO.orgfiles for the current reality.
That's all safely checked in and pushed to the many various locations which people might think of as the primary swankr repository. But those org-mode files are exported to HTML to produce the minimal swankr web presence, and the script that does that was last run with org-mode version 7.x, while now, in the future, org-mode is up to version 8 (and this time the change in major version number is definitely indicative of non-backwards-compatible API changes).
This has already bitten me. The principles of reproducible research are good, and org-mode offers many of the features that help: easily-edited source format, integration with a polyglossia of programming languages, high-quality PDF output (and adequate-quality HTML output, from the same sources) – I've written some technical reports in this style, and been generally happy with it. But, with the changes from org-mode 7 to org-mode 8, in order to reproduce my existing documents I needed to make not only (minor) source document changes, but also (quite major) changes to the bits of elisp to generate exported documents in house style. Reproducible research is difficult; I suppose it's obvious that exact reproduction depends on exact software versions, platform configurations and so on – see this paper, for example – but how many authors of supposedly reproducible research are actually listing all the programs, up to exact versions of dynamically-linked libraries they link to, used in the preparation and treatment of the data and document?
In any case, the changes needed for swankr are
though I was briefly confused when I tried
org-html-export-as-html first (and no output was
produced, because that's the new name for exporting to an HTML
buffer rather than an HTML file. The
swankr website should now
reflect the current state of affairs.