From: Randy Dunlap Add structure fields kernel-doc for 2 fields in struct journal_s. Warning(/var/linsrc/linux-2614-rc4//include/linux/jbd.h:808): No description found for parameter 'j_wbuf' Warning(/var/linsrc/linux-2614-rc4//include/linux/jbd.h:808): No description found for parameter 'j_wbufsize' Convert fs/jbd/recovery.c non-static functions to kernel-doc format. fs/jbd/recovery.c doesn't export any symbols, so it should use !I instead of !E to eliminate this warning message: Warning(/var/linsrc/linux-2614-rc4//fs/jbd/recovery.c): no structured comments found Signed-off-by: Randy Dunlap Signed-off-by: Andrew Morton --- Documentation/DocBook/journal-api.tmpl | 2 +- fs/jbd/recovery.c | 4 ++-- include/linux/jbd.h | 3 +++ 3 files changed, 6 insertions(+), 3 deletions(-) diff -puN Documentation/DocBook/journal-api.tmpl~jbd-doc-fix-some-kernel-doc-warnings Documentation/DocBook/journal-api.tmpl --- devel/Documentation/DocBook/journal-api.tmpl~jbd-doc-fix-some-kernel-doc-warnings 2005-10-15 22:22:33.000000000 -0700 +++ devel-akpm/Documentation/DocBook/journal-api.tmpl 2005-10-15 22:22:33.000000000 -0700 @@ -306,7 +306,7 @@ an example. Journal Level !Efs/jbd/journal.c -!Efs/jbd/recovery.c +!Ifs/jbd/recovery.c Transasction Level !Efs/jbd/transaction.c diff -puN fs/jbd/recovery.c~jbd-doc-fix-some-kernel-doc-warnings fs/jbd/recovery.c --- devel/fs/jbd/recovery.c~jbd-doc-fix-some-kernel-doc-warnings 2005-10-15 22:22:33.000000000 -0700 +++ devel-akpm/fs/jbd/recovery.c 2005-10-15 22:22:33.000000000 -0700 @@ -210,7 +210,7 @@ do { \ } while (0) /** - * int journal_recover(journal_t *journal) - recovers a on-disk journal + * journal_recover - recovers a on-disk journal * @journal: the journal to recover * * The primary function for recovering the log contents when mounting a @@ -266,7 +266,7 @@ int journal_recover(journal_t *journal) } /** - * int journal_skip_recovery() - Start journal and wipe exiting records + * journal_skip_recovery - Start journal and wipe exiting records * @journal: journal to startup * * Locate any valid recovery information from the journal and set up the diff -puN include/linux/jbd.h~jbd-doc-fix-some-kernel-doc-warnings include/linux/jbd.h --- devel/include/linux/jbd.h~jbd-doc-fix-some-kernel-doc-warnings 2005-10-15 22:22:33.000000000 -0700 +++ devel-akpm/include/linux/jbd.h 2005-10-15 22:22:33.000000000 -0700 @@ -617,6 +617,9 @@ struct transaction_s * @j_revoke: The revoke table - maintains the list of revoked blocks in the * current transaction. * @j_revoke_table: alternate revoke tables for j_revoke + * @j_wbuf: array of buffer_heads for journal_commit_transaction + * @j_wbufsize: maximum number of buffer_heads allowed in j_wbuf, the + * number that will fit in j_blocksize * @j_private: An opaque pointer to fs-private information. */ _