Make max-chars default to (1- array-total-size-limit).

- Remove outdated comments.
- Use BABEL:SIMPLE-UNICODE-STRING type.
- Document *DEFAULT-FOREIGN-ENCODINGS*.
- Add :FREE-FROM-FOREIGN and :FREE-TO-FOREIGN boolean
  parameters to the :STRING type.

- Work around apparent SBCL bug.
- Handle :RE endianness in BGET and BSET.

- Don't return second value of FOREIGN-STRING-TO-LISP.

Not sure if this is a great idea yet.  In any case, CFFI-FEATURES is
still there for backwards compatibility for the time being.

- Update test suite to reflect this change.

- Fix :LICENSE -> :LICENCE in cffi-grovel.asd
- grovel.lisp fixes:
    * fix OpenMCL's INVOKE
    * have INVOKE call NATIVE-NAMESTRING
    * add IGNORABLE declaration to DEFINE-GROVEL-SYNTAX
- CMUCL's EXT:UNIX-NAMESTRING is buggy, don't use it.
- strings.lisp: pass missing max-octets argument to OCTET-COUNTER
  in FOREIGN-STRING-ALLOC.

- LISP-STRING-TO-FOREIGN takes new arguments START, END and OFFSET.  Also,
  instead of bailing out when STRING needs more octets than BUFSIZE, it
  fills in as much as possible.
- test STRING.SHORT-WRITE.1 now passes.
- FOREIGN-STRING-TO-LISP takes new argument MAX-CHARS.

Changed to match the new WITH-FOREIGN-STRING syntax.  Document later.

- WITH-FOREIGN-STRING's new syntax:
    with-foreign-string (binding &rest args) &body
      binding  :

- Preliminary (likely buggy) version.  Includes documentation and tests.
- New cffi-features: big-endian and little-endian determined with CFFI
  code.
- Needs cleaning up.

The changes are summarized here:
http://article.gmane.org/gmane.lisp.cffi.devel/1029

Also adapted tests and examples and uffi-compat.

Note to self: do not use darcs amend-record with someone else's patch. Doh.

- WITH-FOREIGN-STRING: check for (or string (array (unsigned-byte 8))).
- New tests: misc-types.string.ub8.[12].

- Add UNPARSE generic function for unparsing types.
- Reverse the order of the type name and class in translator GFs.
- Add NEXT-* versions of the translator GFs.

- Refactoring of the type translation mechanism, now based on
  generic functions. The only user-visible changes is that you can
  now specialize the on the argument of the translator, and there's
  no type argument now (which was useless too for user-defined types).
- Don't export define-type-spec-parser since it's useless on its own.
- The anonymous :enum type is gone.
- Updated manual.

- Renamed: null-ptr -> null-pointer, null-ptr-p -> null-pointer,
  inc-ptr -> inc-pointer, with-foreign-ptr -> with-foreign-pointer,
  with-foreign-ptr-as-string -> with-foreign-pointer-as-string,
  foreign-slot-address -> foreign-slot-pointer,
  get-var-ptr -> get-var-pointer and
  foreign-symbol-ptr -> foreign-symbol-pointer.
- Updated various references to the old names in the cffi code itself,
  examples, tests and the manual.
- New functions: cffi(-sys):pointer-address and cffi(-sys):make-pointer.
- Use these in uffi-compat.
- Documented them in the manual.
- New tests: POINTER.1 and POINTER.2

- Use variables for the lisps' paths so that one can easily pick
  different versions to run the tests with. eg:
    CMUCL

- removed foreign-object-alloc, added cffi:foreign-alloc with new options
  (including the functionality foreign-object-alloc provided).
- renamed the cffi-sys:foreign-alloc's to cffi-sys:%foreign-alloc.
- updated respective documentation.
- improved mem-aref's documentation including new examples.
- fixed with buf with lisp-string-to-foreign not handling empty strings
  correctly. added regression test.
- fixed translate-to-c and translate-from-c (not exported yet)
- fixed uffi-compat bugs, implemented all operators (including a bunch
  that aren't documented in UFFI's manual) except a foreign-string-length
  which is weird and not used anywhere.
- added "UFFI" as a nickname for the cffi-uffi-compat package.

Bug fixes / tweaks:
- fixed typo in foreign-enum-value.
- defcenum: renamed argument, allow a docstring.
- defcvar and defcfun: also accept symbols as names.
- defcvar: added (declare (ignore value)) when read-only is true.
- foreign-funcall: fixed bug; premature canonicalization of the
  return-type. added regression test for this.
- defcfun and defcallback: use the make-gensym-list utility
- defcallback: return the callback name;
- strings.lisp: fixed the docstrings for the :string translators;
- mem-aref: fixed bug/typo in its setf-expander; added regression
  test for this.
- defcstruct and defcunion: allow a docstring.
- new tests: callbacks.qsort and funcall.string.3

Documentation:
- New file doc/Makefile for generating docs and uploading them to
  c-l.net.
- Added every cffi function/macro that is currently exported.
  documented half of them or so.
- colorize-lisp-examples.lisp: little script to colorize the examples
  in the texinfo-generated html docs.
- gend...

- New tests: tests/enums.lisp (4 tests) and tests/misc-types.lisp (3 tests).
- New file: objects.lisp, skeleton of the safe typed pointer interface. I
  also added a :boolean type here, it's looking for a better home still.
- (early-types.lisp): type parsers, DEFINE-TYPE-SPEC-PARSER and PARSE-TYPE.
  Added abbility to have anonymous types (ie. a name is no longer required
  for FOREIGN-TYPE). Moved DEFCTYPE to types.lisp.
- (enum.lisp): improved DEFCENUM, the values for each keyword are now
  optional, like in C. Added the anonymous type (:enum ...)
- (types.lisp):
    - Renamed :TO-C-ARG to :TO-C-DYNAMIC.
    - Renamed FOREIGN-AREF to MEM-AREF and implemented compiler macros
      for it.
    - New exported macro: DEFINE-FOREIGN-TYPE for parameterized types.
    - Change DEFINE-TYPE-TRANSLATOR back to the previous interface,
      translators take a type argument now and we have translators
      available at runtime now too.
    - FOREIGN-TYPEDEF's now inherit their parent type's translators.
    - New :wrapper type, for anonymous typedefs with translators.
- (strings.lisp): Renamed string to :string. Added new type, :string+ptr.
- (utils.lisp): renamed let-if to bif.
- (tests/callbacks.lisp): two tests were not being run for SBCL
  because I thought it triggered a bug but it's actually only one that
  triggers the bug. Fixed that.
- Updated examples and tests to use :string instead of string.