Release Notes for Clearsilver 0.6.0                    4/25/2002
-------------------------------------
Yeah, I know, there wasn't an announcement for v0.5, it was out last
week, but some bugs found shortly after it was released made for some
quick fixes...

Aside from the assorted bugfixes, we have the following new features:
- Function to sort HDF at a given level in the tree.
- Support for HTTP PUT (works a lot like POST File Upload, except you
  call cgi_filehandle() with NULL instead of a query name).
- search/in/index functions for ULIST
- support for parenthesis in CS expressions
- support for bracket array access in CS expressions
  this means that foo["bar"] is equal to foo.bar, and
  if bar = test, then foo[bar] = foo.test
- some convenience functions for NEOERRs, so you can now get just
  the error string instead of the entire traceback. You can also
  match an error without clearing it (so you can re-throw it).
- support for alt CS command. This command allows you to follow an
  alternative path if a given expression doesn't have a value.
  <?cs alt:MyVar ?> I don't know anything <?cs /alt ?> will display
  the value of MyVar if it exists, or display the text if not.
- support for loop CS command. This command allows you to walk
  through a sequential list of values without actually writing all of
  them into your HDF. The syntax is currently quite ugly and subject
  to change when I think of a better one, but:
    <?cs loop:x=#1,#100,#3 ?>
      <?cs var:x ?>
    <?cs /loop ?>
  This will display the values 1 to 100 (inclusive) by 3.
- ne_listdir() and some other functions that will load the list of
  files for a directory into a ULIST
- An image viewer is now included as an example. It's called imd, and
  you can see it in action at http://www.fiction.net/~blong/Images/
  (login: friend pass: yakko)
- HDF now supports attributes on a per node basis. This means that
  you can now have out of band data in your HDF dataset. For example:
    Images {
      top {
	height [type=num] = 512
	width [type=num] = 512
	url [url] = /img/loc/top.gif
	alt [type=string, lang=en, desc="The end of \n the world?"] = ClearSilver Rocks!
      }
    }
  Currently, attributes are only accessible from code as I'm still
  considering what the possible CS syntax should be. Yes, this brings
  HDF a step closer to XML, but its still simpler in the base case...
  and at some point in the future I might add xml export/import
  functions for HDF...


Also, be sure to check out the new improved ClearSilver website at
http://www.clearsilver.net/

As always, we invite people to participate, share examples, suggest
examples, write documentation, write code...