futex: Fix kernel-doc notation & typos

/**

 * struct futex_q - The hashed futex queue entry, one per waiting task

 * @list:		priority-sorted list of tasks waiting on this futex

 * @task:		the task waiting on the futex

 * @lock_ptr:		the hash bucket lock

 * @key:		the key the futex is hashed on

 *

 * A futex_q has a woken state, just like tasks have TASK_RUNNING.

 * It is considered woken when plist_node_empty(&q->list) || q->lock_ptr == 0.

 * The order of wakup is always to make the first condition true, then

 * The order of wakeup is always to make the first condition true, then

 * the second.

 *

 * PI futexes are typically woken before they are removed from the hash list via

 * Slow path to fixup the fault we just took in the atomic write

 * access to @uaddr.

 *

 * We have no generic implementation of a non destructive write to the

 * We have no generic implementation of a non-destructive write to the

 * user address. We know that we faulted in the atomic pagefault

 * disabled section so we can as well avoid the #PF overhead by

 * calling get_user_pages() right away.

			 */

			pi_state = this->pi_state;

			/*

			 * Userspace might have messed up non PI and PI futexes

			 * Userspace might have messed up non-PI and PI futexes

			 */

			if (unlikely(!pi_state))

				return -EINVAL;

	/*

	 * We set q->lock_ptr = NULL _before_ we wake up the task. If

	 * a non futex wake up happens on another CPU then the task

	 * might exit and p would dereference a non existing task

	 * a non-futex wake up happens on another CPU then the task

	 * might exit and p would dereference a non-existing task

	 * struct. Prevent this by holding a reference on p across the

	 * wake up.

	 */

/**

 * futex_requeue() - Requeue waiters from uaddr1 to uaddr2

 * uaddr1:	source futex user address

 * uaddr2:	target futex user address

 * nr_wake:	number of waiters to wake (must be 1 for requeue_pi)

 * nr_requeue:	number of waiters to requeue (0-INT_MAX)

 * requeue_pi:	if we are attempting to requeue from a non-pi futex to a

 * @uaddr1:	source futex user address

 * @fshared:	0 for a PROCESS_PRIVATE futex, 1 for PROCESS_SHARED

 * @uaddr2:	target futex user address

 * @nr_wake:	number of waiters to wake (must be 1 for requeue_pi)

 * @nr_requeue:	number of waiters to requeue (0-INT_MAX)

 * @cmpval:	@uaddr1 expected value (or %NULL)

 * @requeue_pi:	if we are attempting to requeue from a non-pi futex to a

 * 		pi futex (pi to pi requeue is not supported)

 *

 * Requeue waiters on uaddr1 to uaddr2. In the requeue_pi case, try to acquire

	 * of the complex code paths. Also we want to prevent

	 * registration of robust lists in that case. NULL is

	 * guaranteed to fault and we get -EFAULT on functional

	 * implementation, the non functional ones will return

	 * implementation, the non-functional ones will return

	 * -ENOSYS.

	 */

	curval = cmpxchg_futex_value_locked(NULL, 0, 0);