updated docs and unit test regarding the usage of boolean flags

git-svn-id: http://shflags.googlecode.com/svn/trunk@171 9d7cb843-df4f-0410-8a79-4785ae5a3405
Update from upstream