Replace deadlock word in docs

[xolra0d]

Hi. Deadlock is a scary word, which describes a situation when multiple threads are unable to progress, because each waits for one other to release resources.

However, this is not what happens in dashmap. I believe it would be benefiting to replace the word deadlock for more meaningful one (blocking).

For example:

get_mut()

Get a mutable reference to an entry in the map

Locking behaviour: This method is blocking and will wait until all references into the map are dropped.

[xolra0d]

I can open a PR, if this is fine

[EpicEric]

But the docs are correct. Using your example, get_mut will deadlock if you call it while holding a reference to the same object in the same thread.

[xolra0d]

Word deadlock is used in the context of multi threaded applications, not single threaded.

[EpicEric]

You can definitely deadlock with a single thread, especially with DashMap:

use dashmap::DashMap;

fn main() {
    let map: DashMap<String, usize> = DashMap::new();
    map.insert(String::from("key"), 42);
    let inserted = map.get_mut("key").unwrap();
    println!("{}", inserted.value());
    let retrieved = map.get("key").unwrap();
    println!("Deadlock (this never gets printed): {}", retrieved.value());
}