From: Randy Dunlap <rdunlap@xxxxxxxxxxxxx> drivers/scsi/scsi_transport_srp.c has incomplete kernel-doc notation for some of the functions. This causes several kernel-doc warnings. Fix these kernel-doc warnings by changing the beginning /** kernel-doc marker to a plain /* comment. Warning(drivers/scsi/scsi_transport_srp.c:75): No description found for parameter 'reconnect_delay' Warning(drivers/scsi/scsi_transport_srp.c:75): No description found for parameter 'fast_io_fail_tmo' Warning(drivers/scsi/scsi_transport_srp.c:75): No description found for parameter 'dev_loss_tmo' Warning(drivers/scsi/scsi_transport_srp.c:373): No description found for parameter 'work' Warning(drivers/scsi/scsi_transport_srp.c:413): No description found for parameter 'work' Warning(drivers/scsi/scsi_transport_srp.c:431): No description found for parameter 'work' Warning(drivers/scsi/scsi_transport_srp.c:496): No description found for parameter 'rport' Warning(drivers/scsi/scsi_transport_srp.c:507): No description found for parameter 'shost' Warning(drivers/scsi/scsi_transport_srp.c:545): No description found for parameter 'rport' Warning(drivers/scsi/scsi_transport_srp.c:611): No description found for parameter 'scmd' Warning(drivers/scsi/scsi_transport_srp.c:679): No description found for parameter 'rport' Warning(drivers/scsi/scsi_transport_srp.c:688): No description found for parameter 'rport' Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx> --- drivers/scsi/scsi_transport_srp.c | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) --- lnx-313-rc7.orig/drivers/scsi/scsi_transport_srp.c +++ lnx-313-rc7/drivers/scsi/scsi_transport_srp.c @@ -62,7 +62,7 @@ static inline struct Scsi_Host *rport_to return dev_to_shost(r->dev.parent); } -/** +/* * srp_tmo_valid() - check timeout combination validity * * The combination of the timeout parameters must be such that SCSI commands @@ -366,7 +366,7 @@ invalid: return -EINVAL; } -/** +/* * srp_reconnect_work() - reconnect and schedule a new attempt if necessary */ static void srp_reconnect_work(struct work_struct *work) @@ -406,7 +406,7 @@ static void __rport_fail_io_fast(struct i->f->terminate_rport_io(rport); } -/** +/* * rport_fast_io_fail_timedout() - fast I/O failure timeout handler */ static void rport_fast_io_fail_timedout(struct work_struct *work) @@ -424,7 +424,7 @@ static void rport_fast_io_fail_timedout( mutex_unlock(&rport->mutex); } -/** +/* * rport_dev_loss_timedout() - device loss timeout handler */ static void rport_dev_loss_timedout(struct work_struct *work) @@ -486,7 +486,7 @@ static void __srp_start_tl_fail_timers(s } } -/** +/* * srp_start_tl_fail_timers() - start the transport layer failure timers * * Start the transport layer fast I/O failure and device loss timers. Do not @@ -500,7 +500,7 @@ void srp_start_tl_fail_timers(struct srp } EXPORT_SYMBOL(srp_start_tl_fail_timers); -/** +/* * scsi_request_fn_active() - number of kernel threads inside scsi_request_fn() */ static int scsi_request_fn_active(struct Scsi_Host *shost) @@ -520,7 +520,7 @@ static int scsi_request_fn_active(struct return request_fn_active; } -/** +/* * srp_reconnect_rport() - reconnect to an SRP target port * * Blocks SCSI command queueing before invoking reconnect() such that @@ -597,7 +597,7 @@ out: } EXPORT_SYMBOL(srp_reconnect_rport); -/** +/* * srp_timed_out() - SRP transport intercept of the SCSI timeout EH * * If a timeout occurs while an rport is in the blocked state, ask the SCSI @@ -672,7 +672,7 @@ static int srp_host_match(struct attribu return &i->t.host_attrs.ac == cont; } -/** +/* * srp_rport_get() - increment rport reference count */ void srp_rport_get(struct srp_rport *rport) @@ -681,7 +681,7 @@ void srp_rport_get(struct srp_rport *rpo } EXPORT_SYMBOL(srp_rport_get); -/** +/* * srp_rport_put() - decrement rport reference count */ void srp_rport_put(struct srp_rport *rport) -- To unsubscribe from this list: send the line "unsubscribe linux-scsi" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
