ebb: Update man documentation

EBB documentation update wchi includes:

* mention that the file descriptor returned by paf_ebb_pmu_init
  should be closed when done to prevent resource leak.

* the valid values for 'flags' on the paf_ebb_register_handler.

* make explicit errno is set for some error returns

* add a simple example