Minor Documentation

- Explain better Boost warnings for Ubuntu 12.04
- Clarify var meaning
- Deprecate in documentation StateStorage.h - this should be deleted according to @isucan but MoveIt! depends on it still (though doesn't actually use it). This is a first step.