[src/trunk]: src/sys/external/bsd/drm2/linux Expand docstring for reservation...

[riastradh <riastradh%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/e0fa902108db
branches:  trunk
changeset: 993115:e0fa902108db
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Mon Aug 27 15:28:27 2018 +0000

description:
Expand docstring for reservation_object_poll.

diffstat:

 sys/external/bsd/drm2/linux/linux_reservation.c |  15 +++++++++++----
 1 files changed, 11 insertions(+), 4 deletions(-)

diffs (36 lines):

diff -r 929f8791e59a -r e0fa902108db sys/external/bsd/drm2/linux/linux_reservation.c
--- a/sys/external/bsd/drm2/linux/linux_reservation.c   Mon Aug 27 15:28:16 2018 +0000
+++ b/sys/external/bsd/drm2/linux/linux_reservation.c   Mon Aug 27 15:28:27 2018 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: linux_reservation.c,v 1.9 2018/08/27 15:28:16 riastradh Exp $  */
+/*     $NetBSD: linux_reservation.c,v 1.10 2018/08/27 15:28:27 riastradh Exp $ */
 
 /*-
  * Copyright (c) 2018 The NetBSD Foundation, Inc.
@@ -30,7 +30,7 @@
  */
 
 #include <sys/cdefs.h>
-__KERNEL_RCSID(0, "$NetBSD: linux_reservation.c,v 1.9 2018/08/27 15:28:16 riastradh Exp $");
+__KERNEL_RCSID(0, "$NetBSD: linux_reservation.c,v 1.10 2018/08/27 15:28:27 riastradh Exp $");
 
 #include <sys/param.h>
 #include <sys/poll.h>
@@ -851,8 +851,15 @@
 /*
  * reservation_object_poll(robj, events, rpoll)
  *
- *     POLLOUT         wait for all fences shared and exclusive
- *     POLLIN          wait for the exclusive fence
+ *     Poll for reservation object events using the reservation poll
+ *     state in rpoll:
+ *
+ *     - POLLOUT       wait for all fences shared and exclusive
+ *     - POLLIN        wait for the exclusive fence
+ *
+ *     Return the subset of events in events that are ready.  If any
+ *     are requested but not ready, arrange to be notified with
+ *     selnotify when they are.
  */
 int
 reservation_object_poll(struct reservation_object *robj, int events,