From 058595d58217fc062ed95c8a5621d2bc26a7a9bb Mon Sep 17 00:00:00 2001 From: Mauro Carvalho Chehab Date: Mon, 2 Mar 2020 09:15:59 +0100 Subject: [PATCH] scsi: docs: convert qlogicfas.txt to ReST Link: https://lore.kernel.org/r/b69f795c781811b9a908abe43485f1dca0ee8ac5.1583136624.git.mchehab+huawei@kernel.org Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Martin K. Petersen --- Documentation/scsi/index.rst | 1 + .../scsi/{qlogicfas.txt => qlogicfas.rst} | 17 +++++++++++++---- drivers/scsi/Kconfig | 2 +- 3 files changed, 15 insertions(+), 5 deletions(-) rename Documentation/scsi/{qlogicfas.txt => qlogicfas.rst} (92%) diff --git a/Documentation/scsi/index.rst b/Documentation/scsi/index.rst index 17327f67af68..29e211ee9145 100644 --- a/Documentation/scsi/index.rst +++ b/Documentation/scsi/index.rst @@ -30,5 +30,6 @@ Linux SCSI Subsystem ncr53c8xx NinjaSCSI ppa + qlogicfas scsi_transport_srp/figures diff --git a/Documentation/scsi/qlogicfas.txt b/Documentation/scsi/qlogicfas.rst similarity index 92% rename from Documentation/scsi/qlogicfas.txt rename to Documentation/scsi/qlogicfas.rst index c211d827fef2..b17f1b3676c3 100644 --- a/Documentation/scsi/qlogicfas.txt +++ b/Documentation/scsi/qlogicfas.rst @@ -1,3 +1,8 @@ +.. SPDX-License-Identifier: GPL-2.0 + +================================= +Qlogic FASXXX Family Driver Notes +================================= This driver supports the Qlogic FASXXX family of chips. This driver only works with the ISA, VLB, and PCMCIA versions of the Qlogic @@ -16,7 +21,8 @@ is provided by the qla1280 driver. Nor does it support the PCI-Basic, which is supported by the 'am53c974' driver. -PCMCIA SUPPORT +PCMCIA Support +============== This currently only works if the card is enabled first from DOS. This means you will have to load your socket and card services, and @@ -31,7 +37,8 @@ it from configuring the card. I am working with the PCMCIA group to make it more flexible, but that may take a while. -ALL CARDS +All Cards +========= The top of the qlogic.c file has a number of defines that controls configuration. As shipped, it provides a balance between speed and @@ -46,7 +53,8 @@ command or something. It comes up faster if this is set to zero, and if you have reliable hardware and connections it may be more useful to not reset things. -SOME TROUBLESHOOTING TIPS +Some Troubleshooting Tips +========================= Make sure it works properly under DOS. You should also do an initial FDISK on a new drive if you want partitions. @@ -54,7 +62,8 @@ on a new drive if you want partitions. Don't enable all the speedups first. If anything is wrong, they will make any problem worse. -IMPORTANT +Important +========= The best way to test if your cables, termination, etc. are good is to copy a very big file (e.g. a doublespace container file, or a very diff --git a/drivers/scsi/Kconfig b/drivers/scsi/Kconfig index 82462d6a4ce5..d34c682e94cf 100644 --- a/drivers/scsi/Kconfig +++ b/drivers/scsi/Kconfig @@ -1117,7 +1117,7 @@ config SCSI_QLOGIC_FAS SCSI support"), below. Information about this driver is contained in - . You should also read the + . You should also read the SCSI-HOWTO, available from .