fix documentation regarding key meta

- explain reference counting
- fix links in keyNew
- make old meta data obsolete in keyNew
- add xdg_bds to be used for XDG resolving
add example how different ordering could be done in c++