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

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
...@@ -1051,10 +1051,11 @@ static unsigned char *scsi_inq_str(unsigned char *buf, unsigned char *inq, ...@@ -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. * allocate and set it up by calling scsi_add_lun.
* *
* Return: * 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 * 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, static int scsi_probe_and_add_lun(struct scsi_target *starget,
u64 lun, int *bflagsp, u64 lun, int *bflagsp,
......
...@@ -2914,16 +2914,18 @@ EXPORT_SYMBOL(fc_remote_port_add); ...@@ -2914,16 +2914,18 @@ EXPORT_SYMBOL(fc_remote_port_add);
* port is no longer part of the topology. Note: Although a port * 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 * 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: * 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. * 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 * This allows the port to temporarily disappear, then reappear without
* disrupting the SCSI device tree attached to it. During the "blocked" * disrupting the SCSI device tree attached to it. During the "blocked"
* period the port will still exist. * period the port will still exist.
*
* 2) If the port was a scsi target and disappears for longer than we * 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 * 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 * attached to it. However, we want to semi-persist the target id assigned
* to that port if it eventually does exist. The port structure will * to that port if it eventually does exist. The port structure will
* remain (although with minimal information) so that the target id * remain (although with minimal information) so that the target id
* bindings remails. * bindings remails.
* *
* If the remote port is not an FCP Target, it will be fully torn down * If the remote port is not an FCP Target, it will be fully torn down
* and deallocated, including the fc_remote_port class device. * and deallocated, including the fc_remote_port class device.
......
...@@ -116,8 +116,8 @@ EXPORT_SYMBOL(scsicam_bios_param); ...@@ -116,8 +116,8 @@ EXPORT_SYMBOL(scsicam_bios_param);
* @hds: put heads here * @hds: put heads here
* @secs: put sectors here * @secs: put sectors here
* *
* Description: determine the BIOS mapping/geometry used to create the partition * Determine the BIOS mapping/geometry used to create the partition
* table, storing the results in *cyls, *hds, and *secs * table, storing the results in @cyls, @hds, and @secs
* *
* Returns: -1 on failure, 0 on success. * Returns: -1 on failure, 0 on success.
*/ */
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment