Unfortunately, there has been quite a mess with the documentation ... I've tried to update the docs to reflect the current behaviour, so this should be ok by now.
Besides, I've added some new testcases which should make it a lot easier to further improve the FileBrowser.