Copyright (c)1995-2004 Purity Software <http://www.purity.com/>
========================================================================

WebSiphon v2.0.9
released on 2004-01-17

New in this version:

• The Kingfisher add-on library from Flaming LogoWare is now part of the standard WebSiphon 2 distribution package, enabling direct access to MySQL data servers using SiphonScript. The user guide has also been updated to include the 31 new functions introduced through Kingfisher's implementation of the MySQL API.

• Files found in the WebSiphon Data's Startup, Shutdown, and Libraries folders whose name begins with a '.' are ignored. This avoids attempts to execute Mac OS X Finder .DS_Store files, amongst other gremlins that should not be served.

• Fixed bug which caused the built-in variable 'server_port' to contain an empty value using the W*API plug-in runtime.

• Fixed bug where ulSaveFile() was returning a file path shortened by one directory level.

• The 'EnableLogging' configuration setting in WebSiphon's preferences now opens/closes the console log file immediately when toggled. One can now effectively rotate the main log file using a SiphonScript.

• Fixed problem where passing 'null' as a parameter value to HTTPost() could cause a crash.

• FTPDeleteFile() is now included in the NetworkLib FTP function suite (the function was previously documented in the user guide, but missing from actual package).

• Fixed major problem where copying a folder into itself could result in a system crash and/or potential file system corruption, depending on the recursive nature of the bug.

• Updated install section and function index in the user guide.

Unsupported/Conceptual Stuff:

• New preliminary version of header-setting function: __setCustomHeader(string) sets the HTTP Response Header to an arbitrary string. This is an unsupported function, and if you use it in your scripts you will likely need to modify them when migrating to WebSiphon 3.

  With that caveat in mind this function can be quite helpful when responding to certain events, such as a request triggered by a web server ERROR action. This type of error is caused when an object is not located in the file system as indicated by the web request.

  By overriding the standard HTTP 404 error response header, SiphonScript can be devised that acts as a programmatic meta-content server responding to "virtual" web requests which do not correlate directly with an object in the local file system.

  example usage:

  // included as component of web server 404 error page
  local my_head = "HTTP/1.0 200 OK\r\nServer: WebSiphon/2.0.9"
                  & " MyPastaServer/1.0.8";
  __setCustomHeader(my_head);
  

Known issues:

• appendHeader() doesn't override default HTTP headers supplied by WebSiphon and also forgets to include custom headers with calls to redirectClient().

• FileLib and Aliases: An attempt to perform an action on an path pointing to an alias will result in the action being performed on the targeted object rather than the alias file itself.

• SiphonScript-2 language support for the 'null' data type is inconsistent, particularly with older functions provided by WebSiphon or add-on libraries.

  Though in most cases one is safe using null, its a good idea to work explicitly with the type and be prepared for loose coercions which may not be immediately obvious (ie. referencing a null value as a list in a comparison operation will cause a coercion to an empty list).

• POP3 functions do not support MIME-encoded e-mails.

• listToTime() increments some fields incorrectly when relying on the function to perform date calculations by passing deeply out-of-range values. The function works as-advertised when using valid date values, however.