Proper README/documentation

[zehanort]

Must include the following, at least:

• system requirements ☑
• installation ☑
• usage ☑
• limitations & known issues ☑
• license ☑

[zehanort]

Must reflect all the latest changes; must update usage examples; add some GIPHYs; create a wiki for the documentation of both the command line tool and the package API.

[zehanort]

known issues:

1. if kernel is prone to segfault, some times produces empty output (if lucky) or freezes for ever and must be killed
2. when the kernel is profile (i.e. instcounts) it is compiled and ran with NO optimizations (optimizations are normally used in all other modes)

THINKS IT IS CACHED BUT IT IS NOT: 1. time it (with --clear-cache to be sure) 2. instcounts and it breaks, because it thinks it is already instrumented and cached, which is wrong

[zehanort]

cache bug fixed

[zehanort]

almost done, must add the following in the wiki:

1. how oclude works (very briefly, but must refer to source code instrumentation, for example)
2. cache related thingies