adding doc blocks to locale methods