updated documentation, added short locale support