Per the original author, the proposed document was never deemed
necessary, and the important bits got merged into completion.txt. Let's
just stop confusing readers by pointing at a nonexistent doc.
Signed-off-by: NBrian Norris <briannorris@chromium.org>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Mostly language improvements to the new completions.txt document, but there
is also a semantic correction in the description of completion_done() at
the very end.
Acked-by: NIngo Molnar <mingo@kernel.org>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Fix for imprecise/wrong statements on context in which wait_for_completion*()
can be called, updated notes on "going out of scope" problems and some
language fixups.
Signed-off-by: NNicholas Mc Guire <hofrat@osadl.org>
Acked-by: NIngo Molnar <mingo@kernel.org>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>

Signed-off-by: NNicholas Mc Guire <der.herr@hofr.at>
[jc: cleaned up some spurious blank lines]
Signed-off-by: NJonathan Corbet <corbet@lwn.net>