SERVER-14668 Extend the LockManager API and add comments

o Adds downgrade call for the lock manager, which will soon be necessary
for the Flush lock and also for document-level locking.

o Adds timeout parameter for lock grant to occur.

o Adds comments where they were missing before.