Re: [PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings

From: Christoph Hellwig
Date: Thu May 10 2018 - 04:38:47 EST


> * Use either while holding wait_queue_head::lock or when used for wakeups
> - * with an extra smp_mb() like:
> + * with an extra smp_mb() like::

Independent of any philosophical discussion not allowing a setence to
end with a single ':' is completely idiotic. Please fix the tooling
instead to allow it, as it is very important for being able to just
write understandable comments.