[CB-2670] wrote quirks section for BB file system edge case

BB file system edge case fixed in CB-2649
problem may still occur with user created files, so quirks section authored in the relevant function documentation in File API docs