~ chicken-core (chicken-5) 7d620473790c1a8a7a363625c3d0c4a829dfd3f1

commit 7d620473790c1a8a7a363625c3d0c4a829dfd3f1
Author:     felix <felix@call-with-current-continuation.org>
AuthorDate: Sun Jun 20 02:17:29 2010 +0200
Commit:     felix <felix@call-with-current-continuation.org>
CommitDate: Sun Jun 20 02:17:29 2010 +0200

    manual updates

diff --git a/manual/Acknowledgements b/manual/Acknowledgements
index dc5b6edf..b40d35bf 100644
--- a/manual/Acknowledgements
+++ b/manual/Acknowledgements
@@ -4,33 +4,33 @@
 
 Many thanks to Nico Amtsberg, Alonso Andres, William Annis, Marc
 Baily, Peter Barabas, Jonah Beckford, Arto Bendiken, Kevin Beranek,
-Peter Bex, Jean-Francois Bignolles, Alaric Blagrave-Snellpym, Dave
-Bodenstab, Fabian Boehlke, T. Kurt Bond, Ashley Bone, Dominique
-Boucher, Terence Brannon, Roy Bryant, Adam Buchbinder, Hans Bulfone,
-Category 5, Taylor Campbell, Naruto Canada, Mark Carter, Esteban
-U. Caamano Castro, Semih Cemiloglu, Franklin Chen, Thomas Chust, Gian
-Paolo Ciceri, Fulvio Ciriaco, Tobia Conforto, John Cowan, Grzegorz
-Chrupa&#322;a, James Crippen, Tollef Fog Heen, Drew Hess, Alejandro
-Forero Cuervo, Peter Danenberg, Linh Dang, Brian Denheyer, Sean
-D'Epagnier, dgym, Don, Chris Double, Brown Dragon, Jarod Eells, Petter
-Egesund, Stephen Eilert, Steve Elkins, Daniel B. Faken, Will Farr,
-Graham Fawcett, Marc Feeley, Fizzie, Matthew Flatt, Kimura Fuyuki,
-Tony Garnock-Jones, Martin Gasbichler, Abdulaziz Ghuloum, Joey Gibson,
-Stephen C. Gilardi, Mario Domenech Goulart, Joshua Griffith, Johannes
-Groedem, Damian Gryski, Andreas Gustafsson, Sven Hartrumpf, Jun-ichiro
-itojun Hagino, Ahdi Hargo, Matthias Heiler, Karl M. Hegbloom, William
-P. Heinemann, Bill Hoffman, Bruce Hoult, Hans H&uuml;bner, Markus
-Huelsmann, Goetz Isenmann, Paulo Jabardo, Wietse Jacobs, David
-Janssens, Christian Jaeger, Matt Jones, Dale Jordan, Valentin
-Kamyshenko, Daishi Kato, Peter Keller, Brad Kind, Ron Kneusel,
-Matthias Koeppe, Krysztof Kowa&#322;czyk, Andre Kuehne, Todd R. Kueny
-Sr, Goran Krampe, David Krentzlin, Ben Kurtz, Micky Latowicki, John
-Lenz, Kirill Lisovsky, Juergen Lorenz, Kon Lovett, Lam Luu, Vitaly
-Magerya, Leonardo Valeri Manera, Dennis Marti, Charles Martin, Bob
-McIsaac, Alain Mellan, Eric Merrit, Perry Metzger, Scott G. Miller,
-Mikael, Bruce Mitchener, Fadi Moukayed, Chris Moline, Eric E. Moore,
-Julian Morrison, Dan Muresan, David N. Murray, Lars Nilsson, Ian
-Oversby, o.t., Gene Pavlovsky, Levi Pearson, Jeronimo Pellegrini,
+Peter Bex, Jean-Francois Bignolles, Oivind Binde, Alaric
+Blagrave-Snellpym, Dave Bodenstab, Fabian Boehlke, T. Kurt Bond,
+Ashley Bone, Dominique Boucher, Terence Brannon, Roy Bryant, Adam
+Buchbinder, Hans Bulfone, Category 5, Taylor Campbell, Naruto Canada,
+Mark Carter, Esteban U. Caamano Castro, Semih Cemiloglu, Franklin
+Chen, Thomas Chust, Gian Paolo Ciceri, Fulvio Ciriaco, Tobia Conforto,
+John Cowan, Grzegorz Chrupala, James Crippen, Tollef Fog Heen, Drew
+Hess, Alejandro Forero Cuervo, Peter Danenberg, Linh Dang, Brian
+Denheyer, Sean D'Epagnier, dgym, Don, Chris Double, Brown Dragon,
+Jarod Eells, Petter Egesund, Stephen Eilert, Steve Elkins, Daniel
+B. Faken, Will Farr, Graham Fawcett, Marc Feeley, Fizzie, Matthew
+Flatt, Kimura Fuyuki, Tony Garnock-Jones, Martin Gasbichler, Abdulaziz
+Ghuloum, Joey Gibson, Stephen C. Gilardi, Mario Domenech Goulart,
+Joshua Griffith, Johannes Groedem, Damian Gryski, Andreas Gustafsson,
+Sven Hartrumpf, Jun-ichiro itojun Hagino, Ahdi Hargo, Matthias Heiler,
+Karl M. Hegbloom, William P. Heinemann, Bill Hoffman, Bruce Hoult,
+Hans H&uuml;bner, Markus Huelsmann, Goetz Isenmann, Paulo Jabardo,
+Wietse Jacobs, David Janssens, Christian Jaeger, Matt Jones, Dale
+Jordan, Valentin Kamyshenko, Daishi Kato, Peter Keller, Brad Kind, Ron
+Kneusel, Matthias Koeppe, Krysztof Kowalczyk, Andre Kuehne, Todd
+R. Kueny Sr, Goran Krampe, David Krentzlin, Ben Kurtz, Micky
+Latowicki, John Lenz, Kirill Lisovsky, Juergen Lorenz, Kon Lovett, Lam
+Luu, Vitaly Magerya, Leonardo Valeri Manera, Dennis Marti, Charles
+Martin, Bob McIsaac, Alain Mellan, Eric Merrit, Perry Metzger, Scott
+G. Miller, Mikael, Bruce Mitchener, Fadi Moukayed, Chris Moline, Eric
+E. Moore, Julian Morrison, Dan Muresan, David N. Murray, Lars Nilsson,
+Ian Oversby, o.t., Gene Pavlovsky, Levi Pearson, Jeronimo Pellegrini,
 Nicolas Pelletier, Derrell Piper, Carlos Pita, Robin Lee Powell,
 Pupeno, Davide Puricelli, presto, Doug Quale, Eric Raible, Ivan
 Raikov, Joel Reymont, Chris Roberts, Eric Rochester, Paul Romanchenko,
@@ -61,14 +61,12 @@ Thanks to Dunja Winkelmann for putting up with all of this.
 CHICKEN contains code from several people:
 
 ; Richard Kelsey, Jonathan Rees and Taylor Campbell : {{syntax-rules}} expander
-; Eli Barzilay : some performance tweaks used in TinyCLOS.
 ; Mikael Djurfeldt : topological sort used by compiler.
 ; Marc Feeley : pretty-printer.
 ; Aubrey Jaffer : implementation of {{dynamic-wind}}.
 ; Richard O'Keefe : sorting routines.
 ; Olin Shivers : implementation of {{let-optionals[*]}} and reference implementations of SRFI-1, SRFI-13 and SRFI-14.
 ; Andrew Wilcox : queues.
-; [[http://chicken.wiki.br/users/Alex-Shinn|Alex Shinn]] : {{scheme-complete.el}} emacs tab-completion
 
 The documentation and examples for explicit renaming macros was taken from
 the following paper:
diff --git a/manual/Using the interpreter b/manual/Using the interpreter
index 18fae716..a71f3643 100644
--- a/manual/Using the interpreter	
+++ b/manual/Using the interpreter	
@@ -127,7 +127,7 @@ The toplevel loop understands a number of special commands:
 
 ; ,? : Show summary of available toplevel commands.
 
-; ,l FILENAME ... : Load files with given {{FILENAME}}s
+; ,l FILENAME ... : Load files with given {{FILENAME}}s.
 
 ; ,ln FILENAME ... : Load files and print result(s) of each top-level expression.
 
@@ -139,6 +139,8 @@ The toplevel loop understands a number of special commands:
 
 ; ,dur EXP N : Dump {{N}} bytes of the result of evaluated expression {{EXP}}.
 
+; ,e FILENAME : Runs an external editor to edit the given {{FILENAME}} (see below for more information).
+
 ; ,exn : Describes the last exception that occurred and adds it to the result history (it can be accessed using the {{#}} notation).
 
 ; ,q : Quit the interpreter.
@@ -163,6 +165,20 @@ Defines or redefines a toplevel interpreter command which can be invoked by ente
 read any required argument via {{read}} (or {{read-line}}). If the optional
 argument {{HELPSTRING}} is given, it will be listed by the {{,?}} command.
 
+=== Running an external editor
+
+The {{,e}} command runs the editor given by:
+
+* The parameter {{editor-command}} which should return a string naming
+  an external editor and defaults to {{#f}}, which means no editor is currently
+  selected (so the following alternatives are tried).
+
+* The contents of the environment variables {{EDITOR}} or {{VISUAL}}.
+
+* If the environment variable {{EMACS}} is set, the editor chosen is {{emacsclient}}.
+
+* As a last resort, {{vi}} is used.
+
 === History access
 
 The interpreter toplevel accepts the special object {{#[INDEX]}} which