summaryrefslogtreecommitdiffstats
path: root/fs
diff options
context:
space:
mode:
authorTobin C. Harding <me@tobin.cc>2018-01-10 00:27:29 -0500
committerTheodore Ts'o <tytso@mit.edu>2018-01-10 00:27:29 -0500
commitf69120ce6c024aa634a8fc25787205e42f0ccbe6 (patch)
treedf61d8f7c7bba712ea269cb5b037cd13d613fe43 /fs
parentabbc3f9395c76d554a9ed27d4b1ebfb5d9b0e4ca (diff)
downloadop-kernel-dev-f69120ce6c024aa634a8fc25787205e42f0ccbe6.zip
op-kernel-dev-f69120ce6c024aa634a8fc25787205e42f0ccbe6.tar.gz
jbd2: fix sphinx kernel-doc build warnings
Sphinx emits various (26) warnings when building make target 'htmldocs'. Currently struct definitions contain duplicate documentation, some as kernel-docs and some as standard c89 comments. We can reduce duplication while cleaning up the kernel docs. Move all kernel-docs to right above each struct member. Use the set of all existing comments (kernel-doc and c89). Add documentation for missing struct members and function arguments. Signed-off-by: Tobin C. Harding <me@tobin.cc> Signed-off-by: Theodore Ts'o <tytso@mit.edu> Cc: stable@vger.kernel.org
Diffstat (limited to 'fs')
-rw-r--r--fs/jbd2/transaction.c5
1 files changed, 4 insertions, 1 deletions
diff --git a/fs/jbd2/transaction.c b/fs/jbd2/transaction.c
index 881a9e0..ac31103 100644
--- a/fs/jbd2/transaction.c
+++ b/fs/jbd2/transaction.c
@@ -492,8 +492,10 @@ void jbd2_journal_free_reserved(handle_t *handle)
EXPORT_SYMBOL(jbd2_journal_free_reserved);
/**
- * int jbd2_journal_start_reserved(handle_t *handle) - start reserved handle
+ * int jbd2_journal_start_reserved() - start reserved handle
* @handle: handle to start
+ * @type: for handle statistics
+ * @line_no: for handle statistics
*
* Start handle that has been previously reserved with jbd2_journal_reserve().
* This attaches @handle to the running transaction (or creates one if there's
@@ -623,6 +625,7 @@ error_out:
* int jbd2_journal_restart() - restart a handle .
* @handle: handle to restart
* @nblocks: nr credits requested
+ * @gfp_mask: memory allocation flags (for start_this_handle)
*
* Restart a handle for a multi-transaction filesystem
* operation.
OpenPOWER on IntegriCloud