Linux-Fsdevel Archive on lore.kernel.org
 help / color / Atom feed
* [PATCH 2/2] Documentation: add eventpoll to fs api-summary book
@ 2020-10-16  3:38 Randy Dunlap
  0 siblings, 0 replies; only message in thread
From: Randy Dunlap @ 2020-10-16  3:38 UTC (permalink / raw)
  To: linux-fsdevel
  Cc: Randy Dunlap, Jonathan Corbet, linux-doc, Andrew Morton, Alexander Viro

Add fs/eventpoll.c to the filesystem api-summary book.

Fix kernel-doc warnings in eventpoll.c:

../fs/eventpoll.c:1132: warning: Function parameter or member 'new' not described in 'list_add_tail_lockless'
../fs/eventpoll.c:1132: warning: Function parameter or member 'head' not described in 'list_add_tail_lockless'
../fs/eventpoll.c:1172: warning: Function parameter or member 'epi' not described in 'chain_epi_lockless'

Also remove kernel-doc begin notation (/**) from reverse_path_check()
and some other comment blocks.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Andrew Morton <akpm@linux-foundation.org>
Cc: Alexander Viro <viro@zeniv.linux.org.uk>
---
 Documentation/filesystems/api-summary.rst |    6 ++++++
 fs/eventpoll.c                            |    6 +++---
 2 files changed, 9 insertions(+), 3 deletions(-)

--- linux-next-20201013.orig/Documentation/filesystems/api-summary.rst
+++ linux-next-20201013/Documentation/filesystems/api-summary.rst
@@ -125,6 +125,12 @@ Events based on file descriptors
 .. kernel-doc:: fs/eventfd.c
    :export:
 
+eventpoll (epoll) interfaces
+============================
+
+.. kernel-doc:: fs/eventpoll.c
+   :internal:
+
 The Filesystem for Exporting Kernel Objects
 ===========================================
 
--- linux-next-20201013.orig/fs/eventpoll.c
+++ linux-next-20201013/fs/eventpoll.c
@@ -1106,7 +1106,7 @@ struct file *get_epoll_tfile_raw_ptr(str
 }
 #endif /* CONFIG_CHECKPOINT_RESTORE */
 
-/**
+/*
  * Adds a new entry to the tail of the list in a lockless way, i.e.
  * multiple CPUs are allowed to call this function concurrently.
  *
@@ -1159,7 +1159,7 @@ static inline bool list_add_tail_lockles
 	return true;
 }
 
-/**
+/*
  * Chains a new epi entry to the tail of the ep->ovflist in a lockless way,
  * i.e. multiple CPUs are allowed to call this function concurrently.
  *
@@ -1419,7 +1419,7 @@ static int reverse_path_check_proc(void
 	return error;
 }
 
-/**
+/*
  * reverse_path_check - The tfile_check_list is list of file *, which have
  *                      links that are proposed to be newly added. We need to
  *                      make sure that those added links don't add too many

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, back to index

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-10-16  3:38 [PATCH 2/2] Documentation: add eventpoll to fs api-summary book Randy Dunlap

Linux-Fsdevel Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/linux-fsdevel/0 linux-fsdevel/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-fsdevel linux-fsdevel/ https://lore.kernel.org/linux-fsdevel \
		linux-fsdevel@vger.kernel.org
	public-inbox-index linux-fsdevel

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.kernel.vger.linux-fsdevel


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git