Refactoring. Besides documentation/javadoc this should be ready for 0.1 "release".

Changes:
- overhauled documentation in README.md: removed useless lists that are
  better done by javadoc, moved dependencies section up, added section
  where examples will be put
- added "javadoc" profile. Javadoc pages themselves will be in separate
  branch gh-pages.
- @DiscardObjectAfterInvocation can now be applied to parameters
- @ExpectedFailureProfile:
  * Added documentation
  * Added field retries() with default 0 (zero)
  * Renamed values in FailureMode enum (FAIL_LATE->CARRY_ON,
  * HIDES_FAILURES->IGNORE, added RETRY)
  * FailureMode no longer has default value (annotation is meaningless
    without that value)
- Added documentation to @ExpectedPerformanceProfile. Added GC_HEAVY to
  PerformanceCharacteristic
- Added annotation @HasSideEffects
- Added annotation @OwnershipTransferredToTarget
- Removed interface HasValue.