Release notes for WeBWorK 1.9.03
The WeBWorKTeam is pleased to announce the release of WeBWorK 1.9.03. This release makes WeBWorK 1.9 compatible with PG 2.0, allowing WeBWorK 1.9 and 2.0 to share a single PG codebase.
Changes since WeBWorK 1.9.02 include:
- several changes to
system_webwork_setup.pl: new question for path to system HTML directory, default perl path is
cgi/MAKEDEBUGnow preserves permissions.
- the debug wrapper scripts were removed (can be generated with
- changed the shebang lines on the CGI scripts to
- using new
- spelling corrections in
" renamed backup() to back_up() to remove conflict with another backup routine in
- courseScripts/MAKELINKS written to robustly make symlinks from shared PG macros and modules to WW1 courseScripts directory, removed MAKELINKS.PL and MAKELINKS.pl.
lib/Global.pmsupport for a global, web-accessible temp directory, a global non-web-accessible temp directory, and a global DATA directory.
lib/PGtranslator.pmreplaced with stub.
The complete system is distributed as two tarballs. One for the WeBWorK system itself, and one for the PG system, including a standard set of PG modules and macro files. This is the first release of WeBWorK 1 which requires the separate PG distribution.
Files are available below and on our SourceForge project page:
Documentation on installing and configuring WeBWorK is available on the U of R WeBWorK site and in the distribution itself. However, this version introduces some differences in installation that are noted here:
We're currently in a transitional period concerning the layout of WeBWorK directories. For the time being, I suggest the following directory layout:
/opt base directory
pg-2.0.pr3 PG distribution, unpacked from pg-2.0.pr3.tar.bz2. webwork-1.9.03 WeBWorK 1 distribution, unpacked from webwork-1.9.03.tar.bz2. courses courses directory system libraries, CGI scripts, and shell scripts system_html HTML files utilized by the system webworkdocs HTML documentation pg -> pg-2.0pr3 symlink to current version of PG webwork -> webwork-1.9.03 symlink to current version of WeBWorK 1
If you have WeBWorK 2 installed, you might also have a
webwork-2.0prX directory and a
webwork2 symlink pointing to the current version of WeBWorK 2.
webwork/system/courseScripts directory no longer contains PG modules and macro files, as these are now kept in
pg/macros, respectivly. Instead, there is a script named
MAKELINKS which generates symbolic links to the modules in
pg/lib and the macros in
pg/macros. If your directory structure is laid out as above, invoke
MAKELINKS as follows:
; cd /opt/webwork/system/courseScripts ; perl MAKELINKS
pg directory is somewhere else:
; cd /opt/webwork/system/courseScripts ; perl MAKELINKS /path/to/pg
If a module or macro file is added to your
pg directory, re-run
MAKELINKS to create a corresponding symlink.
Debugging wrapper scripts
Since the CGI debug scripts are programmatically generated, they have been removed from the distribution. To create them, run the script
MAKEDEBUG from the
; cd webwork/system/cgi ; perl MAKEDEBUG
This will create a wrapper script for each perl script in the enclosed
The only wrapper script that is necessary for WeBWorK's operation is
login.pl. If you wish, you can skip running
MAKEDEBUG and instead create only the
; cd webwork/system/cgi ; cp -p MAKEDEBUG.template login.pl
Sharing the equation cache
Though WeBWorK 1 and 2 now use a common PG subsystem, by default they use separate equation caches. To share the equation cache, make sure that the following pairs of configuration variables refer to the same paths and URLs:
|WeBWorK 1||WeBWorK 2|
If you need help installing or using WeBWorK, visit the WeBWorK discussion group and post your question there. The developers monitor this forum.
Bug Reports & Feature Requests
Submit bug reports and feature requests at http://bugs.webwork.rochester.edu/. We can't fix bugs and add features if you don't tell us about them!
While we welcome patches of any sort, by patching against the latest CVS code, you save us and yourself time. A bug in 1.9.03 may be fixed in CVS, and we can more easily handle patches against the latest code. Check out the latest development version from CVS and patch against that. Consult the WeBWorKCVS topic for more information.
-- Main.SamHathaway - 17 Feb 2004