| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
| <html xmlns="http://www.w3.org/1999/xhtml"> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| <title>Rivet 2.3: Release Notes and Known Problems</title> |
| <link rel="stylesheet" href="../templates/wondrous/styles.css" type="text/css" /> |
| </head> |
| |
| <body> |
| <div id="container"> |
| <div id="header"> |
| <h1><a href="../index.html">Rivet</a></h1> |
| <h2 id="slogan">Webscripting for Tcl'ers</h2> |
| <div class="clear"></div> |
| </div> |
| <div id="body"> |
| <div id="content"> |
| <h2>Rivet 2.3: Release Notes and Known Problems</h2> |
| <div> |
| <div class="sez"> |
| <h4>Download</h4> |
| <p> |
| Rivet 2.3 is available for download from ASF mirror sites. Check the |
| <a href="download.html">download page</a> |
| |
| for information about |
| downloading the source code, rpm files or packages for SuSE, |
| Redhat, Debian and Ubuntu (packages for SuSE and Redhat are available thanks to |
| Harald Oehlmann). |
| </p> |
| <p> |
| Code integrity for this release can be checked using the |
| public keys in the <a href="http://www.apache.org/dist/tcl/KEYS">KEYS</a> |
| |
| file. |
| </p> |
| <p> |
| Rivet 2.3 works with the Apache Webserver version 2.2 and 2.4 (running the |
| <strong>prefork</strong> |
| |
| MPM) and requires Tcl >= 8.5.11. Tcl >= 8.6.1 is |
| recommended |
| </p> |
| </div> |
| <div class="sez"> |
| <h4>Rivet 2.3.0 Release Notes</h4> |
| <p> |
| Rivet 2.3.0 consolidates the 2.2.x module series with several improvements in the way |
| the command export was handled. This will be the last 2.x version series in preparation |
| of the newly developed 3.0 module. |
| </p> |
| <p> |
| Rivet 2.3.0 introduces the command <b>::rivet::try</b> |
| |
| and <b>::rivet::catch</b> |
| |
| |
| as a wrappers of the Tcl core |
| language <b>try</b> |
| |
| and <b>catch</b> |
| |
| commands. These commands are not exported to |
| the global namespace even when |
| mod_rivet is build with the <i>--enable-rivet-commands-export</i> |
| |
| and they should be |
| used within Rivet scripts to protect any <b>::rivet::abort_page</b> |
| |
| and |
| <b>::rivet::exit</b> |
| |
| execution. These commands interrupt code execution by |
| raising a Tcl error with reserved error codes (respectively ABORTPAGE and EXITPAGE) to |
| signal the module to fire the AbortScript Tcl script with special codes accessible |
| through the <b>::rivet::abort_code</b> |
| |
| command |
| </p> |
| <p> |
| Execution of <b>::rivet::try</b> |
| |
| fails if mod_rivet is not built with Tcl >= 8.6 |
| </p> |
| <p> |
| Command <b>::rivet::exit</b> |
| |
| was also introduced to help mod_rivet to give the command |
| exit a more sensible behavior within the context of the Apache HTTP Web Server. |
| In fact the core command has become an alias of <b>::rivet::exit</b> |
| |
| which interrupts |
| the script execution and hands control to any AbortScript, completes the request |
| and just before returning to the web server framework terminates the child process |
| by calling <b>Tcl_Exit</b> |
| </p> |
| <p> |
| This command replaces the <b>exit</b> |
| |
| core command and it's provided as a way |
| to give it a meaning within the Rivet and Apache context but the |
| programmer should avoid to use it and instead adopt proper software design |
| to bring about sudden process termination |
| </p> |
| </div> |
| </div> |
| |
| |
| |
| <div class="contentbottom"> |
| |
| </div> |
| </div> |
| |
| <div class="sidebar"> |
| <ul> |
| <li id="news"> |
| <h4>News</h4> |
| <ul class="blocklist"> |
| <li class="navitem"> |
| <a href="rn-2-1.html">3 Mar 2014: Rivet 2.1.4 released</a> |
| </li> |
| <li class="navitem"> |
| <a href="rn-2-2.html">5 Dec 2015: Rivet 2.2.4 released</a> |
| </li> |
| <li class="navitem"> |
| <a href="rn-2-3.html">27 Mar 2016: Rivet 2.3.0 released</a> |
| </li> |
| </ul> |
| </li> |
| |
| </ul> |
| <ul> |
| <li id="home"> |
| <h4>Rivet</h4> |
| <ul class="blocklist"> |
| <li class="navitem"> |
| <a title="A home for Rivet" href="../index.html">Rivet Homepage</a> |
| </li> |
| <li class="navitem"> |
| <a title="Home of Apache Tcl related stuff" target="asf" href="http://tcl.apache.org/">Apache Tcl Home</a> |
| </li> |
| <li class="navitem"> |
| <a title="Getting Rivet" href="download.html">Getting Rivet</a> |
| </li> |
| <li class="navitem"> |
| <a title="Hello World!" href="hello_world.html">Examples</a> |
| </li> |
| <li class="navitem"> |
| <a title="The Rivet development team" href="about.html">About Us - Contact</a> |
| </li> |
| </ul> |
| </li> |
| <li id="tcl"> |
| <h4>Tcl/Tk</h4> |
| <ul class="blocklist"> |
| <li class="navitem"> |
| <a title="The Tcl Developer Xchange" target="tclxchange" class="extern" href="http://www.tcl.tk/"> |
| The Tcl/Tk Language |
| </a> |
| </li> |
| <li class="navitem"> |
| <a title="Tcl community wiki site" target="tclwiki" class="extern" href="http://wiki.tcl.tk/">Tcl'ers Wiki</a> |
| </li> |
| </ul> |
| </li> |
| <li id="manual"> |
| <h4>Documentation</h4> |
| <ul class="blocklist"> |
| <li class="navitem"> |
| <a title="Rivet 2.1 Manual" target="rivetman2.1" href="http://tcl.apache.org/rivet/manual2.1/">Rivet 2.1 Manual</a> |
| </li> |
| <li class="navitem"> |
| <a title="Rivet 2.2 Manual" target="rivetman2.2" href="http://tcl.apache.org/rivet/manual2.2/">Rivet 2.2 Manual</a> |
| </li> |
| <li class="navitem"> |
| <a title="Rivet 2.3 Manual" target="rivetman2.3" href="http://tcl.apache.org/rivet/manual2.3/">Rivet 2.3 Manual</a> |
| </li> |
| </ul> |
| </li> |
| <li id="support"> |
| <h4>Support</h4> |
| <ul class="blocklist"> |
| <li class="navitem"> |
| <a title="Apache Rivet Bugzilla" class="extern" href="https://issues.apache.org/bugzilla/buglist.cgi?quicksearch=Rivet">Bug Reports</a> |
| </li> |
| </ul> |
| </li> |
| |
| </ul> |
| <ul> |
| |
| </ul> |
| </div> |
| <div class="clear"></div> |
| </div> |
| </div> |
| <div id="footer"> |
| <div class="footer-content"> |
| <p><a href="http://www.apache.org/">Apache Software Foundation</a> | Design by <a href="http://www.spyka.net">Free CSS Templates</a> | <a href="http://www.justfreetemplates.com">Free Web Templates</a></p> |
| </div> |
| </div> |
| <div style="text-align: center; font-size: 0.75em;">Design downloaded from <a href="http://www.freewebtemplates.com/">free website templates</a>.</div></body> |
| </html> |
| |
