Commit 739aca06 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab
Browse files

scsi: fix some kernel-doc markups 



Sphinx is very pedantic with regards to ident/spacing.
Fix some kernel-doc markups in order to solve those
errors/warnings:

./drivers/scsi/scsicam.c:121: WARNING: Inline emphasis start-string without end-string.
./drivers/scsi/scsicam.c:121: WARNING: Inline emphasis start-string without end-string.
./drivers/scsi/scsicam.c:121: WARNING: Inline emphasis start-string without end-string.
./drivers/scsi/scsi_scan.c:1056: ERROR: Unexpected indentation.
./drivers/scsi/scsi_scan.c:1057: WARNING: Block quote ends without a blank line; unexpected unindent.
./drivers/scsi/scsi_transport_fc.c:2918: ERROR: Unexpected indentation.
./drivers/scsi/scsi_transport_fc.c:2921: WARNING: Block quote ends without a blank line; unexpected unindent.
./drivers/scsi/scsi_transport_fc.c:2922: WARNING: Enumerated list ends without a blank line; unexpected unindent.

No functional changes.

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent 60202365

drivers/scsi/scsi_scan.c

+4 −3
Original line number Diff line number Diff line
@@ -1051,10 +1051,11 @@ static unsigned char *scsi_inq_str(unsigned char *buf, unsigned char *inq, 
 *     allocate and set it up by calling scsi_add_lun.

 *

 * Return:

 *     SCSI_SCAN_NO_RESPONSE: could not allocate or setup a scsi_device

 *     SCSI_SCAN_TARGET_PRESENT: target responded, but no device is

 *

 *   - SCSI_SCAN_NO_RESPONSE: could not allocate or setup a scsi_device

 *   - SCSI_SCAN_TARGET_PRESENT: target responded, but no device is

 *         attached at the LUN

 *     SCSI_SCAN_LUN_PRESENT: a new scsi_device was allocated and initialized

 *   - SCSI_SCAN_LUN_PRESENT: a new scsi_device was allocated and initialized

 **/

static int scsi_probe_and_add_lun(struct scsi_target *starget,

				  u64 lun, int *bflagsp,

drivers/scsi/scsi_transport_fc.c

+10 −8
Original line number Diff line number Diff line
@@ -2914,10 +2914,12 @@ EXPORT_SYMBOL(fc_remote_port_add); 
 * port is no longer part of the topology. Note: Although a port

 * may no longer be part of the topology, it may persist in the remote

 * ports displayed by the fc_host. We do this under 2 conditions:

 *

 * 1) If the port was a scsi target, we delay its deletion by "blocking" it.

 *    This allows the port to temporarily disappear, then reappear without

 *    disrupting the SCSI device tree attached to it. During the "blocked"

 *    period the port will still exist.

 *

 * 2) If the port was a scsi target and disappears for longer than we

 *    expect, we'll delete the port and the tear down the SCSI device tree

 *    attached to it. However, we want to semi-persist the target id assigned

drivers/scsi/scsicam.c

+2 −2
Original line number Diff line number Diff line
@@ -116,8 +116,8 @@ EXPORT_SYMBOL(scsicam_bios_param); 
 * @hds: put heads here

 * @secs: put sectors here

 *

 * Description: determine the BIOS mapping/geometry used to create the partition

 *      table, storing the results in *cyls, *hds, and *secs 

 * Determine the BIOS mapping/geometry used to create the partition

 * table, storing the results in @cyls, @hds, and @secs

 *

 * Returns: -1 on failure, 0 on success.

 */

CRA Git | Maintained and supported by SUSTech CRA and CCSE