diff --git a/docs/README b/docs/README index 1296ba5..425e465 100644 --- a/docs/README +++ b/docs/README @@ -1,19 +1,26 @@ This directory contains: test-systems - list of all the ASDF systems in Quicklisp - with a word "test" in the system name; - ordered by the project download count. + with a word "test" in the system name; + ordered by the project download count. + detect-test-systems.lisp - the lisp code which - generated the test-systems file + generated the test-systems file + quicklisp-download-statistics-2012.txt - quiclisp download statistics + coverage.org - information about the libraries already reviewed: - whether it is added to test grid, and if not added - why - (no test suite, needs manual configuration, hangs, etc.) - The libraries are ordered in alphabetical order. + whether it is added to test grid, and if not added - why + (no test suite, needs manual configuration, hangs, etc.) + The libraries are ordered in alphabetical order. TODO.org - Notes about what needs to be done in the project. - Ordered approximatelly by priority (descending) + Ordered approximatelly by priority (descending) + TODO.done-archived.org - Done TODO items. issues-found.org - Information about all the bug reports - I submitted based on the test-grid resutls. + I submitted based on the test-grid resutls. + +agent-portability.txt - Notes about running test grid agent + on various CL implementations. \ No newline at end of file diff --git a/docs/agent-portability.txt b/docs/agent-portability.txt new file mode 100644 index 0000000..bbba202 --- /dev/null +++ b/docs/agent-portability.txt @@ -0,0 +1,51 @@ +As of 2012-07-25 and quicklisp 2012-07-03 we have +the following situation: + +CCL is the recommented choice, as it is the development platform +of test grid. Works on windows and linux (tested with CCL 1.8 and 1.7) +The command line to start agent with CCL: + + lx86cl --load run-agent.lisp --eval "(quit)" + +SBCL works on linux (tested with SBCL 1.0.57), +but doesn't work on windows (problem with external-program library). + + export SBCL_HOME=/home/testgrid/lisps/sbcl-1.0.57/lib/sbcl + /home/testgrid/lisps/sbcl-1.0.57/bin/sbcl --load run-agent.lisp --eval "(quit)" + + +CLISP 2.49 Windows - Doesn't work. +(Something seems to be wrong in external-program +with passing program parameters) +Anyway, here are the CLISP parameters: + + clisp -x (load "run-agent.lisp")' + + +ABCL - I don't know, but at least it would take some effort. +I stopped when ABCL required JNA for CFFI (JNA is a Java +library to work with FFI). I need to learn +how to make JNA available for ABCL. + + java -jar abcl.jar --batch --load run-agent.lisp + + +CMUCL - Doesn't work (tested on cmu-20crelease-20c20c_unicode-linux-x86). +The first issue encountered is with external-program: +https://github.com/sellout/external-program/issues/12) + + /opt/cmucl-20c/bin/lisp -load run-agent.lisp -eval "(quit)" + + +ECL - Doesn't work (tested with ecl-12.7.1-dee2506a-win-x86). +When it starts child CCL process to update quicklisp, the CCL crashes. + + ecl -load run-agent.lisp -eval "(quit)" + + +Allegro - not tested: + + alisp -qq -L run-agent.lisp + + +Other Lisps - not tested. diff --git a/run-agent.bat.sample b/run-agent.bat.sample index 2ff8508..d125520 100644 --- a/run-agent.bat.sample +++ b/run-agent.bat.sample @@ -1,62 +1,14 @@ @echo off -echo. -echo ************************************************************************ -echo Updating to the recent cl-test-grid version... -echo ************************************************************************ +rem Updating to the recent cl-test-grid version call git pull -echo. -echo ************************************************************************ -echo Running the test grid agent -echo ************************************************************************ +rem Start your run-agent.lisp script. We suppose +rem Quicklisp is installed and added to the init +rem file of your lisp. -rem Please choose ONE lisp to run the main agent process. -rem -rem Quicklisp is required to be installed and added to the init -rem file of that lisp. -rem -rem As of 2012-07-25 and quicklisp 2012-07-03 we have -rem the following situation: +rem (EDIT THE PATH TO CCL) +C:\Users\testgrid\lisps\ccl-1.8-windows\wx86cl64.exe --load run-agent.lisp --eval "(quit)" +rem CCL is the recommented choice, as it is the test grid development platform. - -rem CCL - the recommented choice, as it is the development platform -rem of test grid. Works on windows and linux (tested with CCL 1.8 and 1.7) -rem -rem C:\Users\anton\unpacked\ccl\ccl-1.8-windows\wx86cl64.exe --load run-agent.lisp --eval "(quit)" - - -rem SBCL - works on linux (tested with SBCL 1.0.57), -rem but doesn't work on windows (problem with external-program library). -rem -rem sbcl --load run-agent.lisp --eval "(quit)" - - -rem CLISP 2.49 Windows - Doesn't work. -rem (Something seems to be wrong in external-program -rem with passing program parameters) -rem Anyway, here are the CLISP parameters: -rem -rem clisp -x "(load \"run-agent.lisp\")" - - -rem ABCL - I don't know, but at least it would take some effort. -rem I stopped when ABCL required JNA for CFFI (JNA is a Java -rem library to work with FFI). I need to learn -rem how to make JNA available for ABCL. -rem -rem call C:\Users\anton\unpacked\abcl\abcl-bin-1.0.1\abcl.bat --batch --load run-agent.lisp - - -rem ECL - Doesn't work (tested with ecl-12.7.1-dee2506a-win-x86). -rem When it starts child CCL process to update quicklisp, the CCL crashes. -rem -rem C:\Users\anton\projects\ecl\bin\ecl -load run-agent.lisp -eval "(quit)" - - -rem Allegro - not tested: -rem -rem "C:\Program Files (x86)\acl82express\alisp.exe" -qq -L run-agent.lisp - - -rem other Lisps - not tested. +rem As for lisps other than CCL, see docs/agent-portability.txt. diff --git a/run-agent.sh.sample b/run-agent.sh.sample index 438a12e..807ffde 100644 --- a/run-agent.sh.sample +++ b/run-agent.sh.sample @@ -1,71 +1,20 @@ #!/bin/sh -echo -echo "************************************************************************" -echo "Updating to the recent cl-test-grid version..." -echo "************************************************************************" +# Update to the recent cl-test-grid version git pull -echo -echo "************************************************************************" -echo "Running the test grid agent..." -echo "************************************************************************" +# Start your run-agent.lisp script. We suppose +# Quicklisp is installed and added to the init +# file of your lisp. -# Please choose ONE lisp to run the main agent process. -# -# Quicklisp is required to be installed and added to the init -# file of that lisp. -# -# As of 2012-07-25 and quicklisp 2012-07-03 we have -# the following situation: - - -# CCL - the recommented choice, as it is the development platform -# of test grid. Works on windows and linux (tested with CCL 1.8 and 1.7) -# -#/home/anton/ccl/ccl-1.8/lx86cl --load run-agent.lisp --eval "(quit)" - - -# SBCL - works on linux (tested with SBCL 1.0.57), -# but doesn't work on windows (problem with external-program library). -# -#export SBCL_HOME=/home/anton/sbcl/sbcl-1.0.54-x86-linux/lib/sbcl -#/home/anton/sbcl/sbcl-1.0.54-x86-linux/bin/sbcl --load run-agent.lisp --eval "(quit)" - - -# CLISP 2.49 Windows - Doesn't work. -# (Something seems to be wrong in external-program -# with passing program parameters) -# Anyway, here are the CLISP parameters: -# -#clisp -x (load "run-agent.lisp")' +# (EDIT THE PATH TO CCL) +/home/testgrid/lisps/ccl-1.8/lx86cl --load run-agent.lisp --eval "(quit)" +# CCL is the recommented choice, as it is the test grid development platform. - -# ABCL - I don't know, but at least it would take some effort. -# I stopped when ABCL required JNA for CFFI (JNA is a Java -# library to work with FFI). I need to learn -# how to make JNA available for ABCL. -# -#/path/to/abcl/abcl.sh --batch --load run-agent.lisp - - -# CMUCL - Doesn't work (tested on cmu-20crelease-20c20c_unicode-linux-x86). -# The first issue encountered is with external-program: -# https://github.com/sellout/external-program/issues/12) +# Alternatively SBCL may also be used (but not on windows). Tested with SBCL 1.0.57. # -#/opt/cmucl-20c/bin/lisp -load run-agent.lisp -eval "(quit)" - - -# ECL - Doesn't work (tested with ecl-12.7.1-dee2506a-win-x86). -# When it starts child CCL process to update quicklisp, the CCL crashes. -# -#ecl -load run-agent.lisp -eval "(quit)" - - -# Allegro - not tested: -# -#alisp -qq -L run-agent.lisp - +#export SBCL_HOME=/home/testgrid/lisps/sbcl-1.0.57/lib/sbcl +#/home/testgrid/lisps/sbcl-1.0.57/bin/sbcl --load run-agent.lisp --eval "(quit)" -# other Lisps - not tested. +# As for other lisps, see docs/agent-portability.txt.