- restructure some functions internally so the error handling
  is less haphazard

- libboushi(3) manpage

- README, AUTHORS, NEWS, ChangeLog

- add a short blurb to each (internal) function so its assumptions
  about input and output are clear