Block: Updated documentation, and changed to use consistent naming.

Agreed with @eordano. I vote for leaving those methods there for API simplicity