worked with dholbach to write an extensive revision of the code

- revised the code in some depth (see rational.txt)
- added a rationale document listing our changes both from a conceptual
  level and in a more detailed "itemized" fashion