mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: Randy Dunlap <rdunlap@infradead.org>
To: linux-kernel@vger.kernel.org
Cc: Randy Dunlap <rdunlap@infradead.org>,
	"James E.J. Bottomley" <jejb@linux.ibm.com>,
	"Martin K. Petersen" <martin.petersen@oracle.com>,
	linux-scsi@vger.kernel.org, Jonathan Corbet <corbet@lwn.net>,
	linux-doc@vger.kernel.org
Subject: [PATCH 02/11] Docs/scsi: introduction: multiple cleanups
Date: Thu, 18 May 2023 14:27:40 -0700	[thread overview]
Message-ID: <20230518212749.18266-3-rdunlap@infradead.org> (raw)
In-Reply-To: <20230518212749.18266-1-rdunlap@infradead.org>

Modify URLs to use https instead of http.
Remove ancient URLs that don't work.
Change "scsi" in text to "SCSI".
Change "cdrom" in text to "CD-ROM".
Drop the reference to "autoclean" for modules since I can't
  find it in any current documentation.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: "James E.J. Bottomley" <jejb@linux.ibm.com>
Cc: "Martin K. Petersen" <martin.petersen@oracle.com>
Cc: linux-scsi@vger.kernel.org
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
---
 Documentation/scsi/scsi.rst |   23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff -- a/Documentation/scsi/scsi.rst b/Documentation/scsi/scsi.rst
--- a/Documentation/scsi/scsi.rst
+++ b/Documentation/scsi/scsi.rst
@@ -6,30 +6,28 @@ SCSI subsystem documentation
 
 The Linux Documentation Project (LDP) maintains a document describing
 the SCSI subsystem in the Linux kernel (lk) 2.4 series. See:
-http://www.tldp.org/HOWTO/SCSI-2.4-HOWTO . The LDP has single
+https://www.tldp.org/HOWTO/SCSI-2.4-HOWTO . The LDP has single
 and multiple page HTML renderings as well as postscript and pdf.
-It can also be found at:
-http://web.archive.org/web/%2E/http://www.torque.net/scsi/SCSI-2.4-HOWTO
 
 Notes on using modules in the SCSI subsystem
 ============================================
-The scsi support in the linux kernel can be modularized in a number of
+The SCSI support in the Linux kernel can be modularized in a number of
 different ways depending upon the needs of the end user.  To understand
 your options, we should first define a few terms.
 
-The scsi-core (also known as the "mid level") contains the core of scsi
-support.  Without it you can do nothing with any of the other scsi drivers.
-The scsi core support can be a module (scsi_mod.o), or it can be built into
-the kernel. If the core is a module, it must be the first scsi module
+The scsi-core (also known as the "mid level") contains the core of SCSI
+support.  Without it you can do nothing with any of the other SCSI drivers.
+The SCSI core support can be a module (scsi_mod.o), or it can be built into
+the kernel. If the core is a module, it must be the first SCSI module
 loaded, and if you unload the modules, it will have to be the last one
-unloaded.  In practice the modprobe and rmmod commands (and "autoclean")
+unloaded.  In practice the modprobe and rmmod commands
 will enforce the correct ordering of loading and unloading modules in
 the SCSI subsystem.
 
 The individual upper and lower level drivers can be loaded in any order
-once the scsi core is present in the kernel (either compiled in or loaded
-as a module).  The disk driver (sd_mod.o), cdrom driver (sr_mod.o),
-tape driver [1]_ (st.o) and scsi generics driver (sg.o) represent the upper
+once the SCSI core is present in the kernel (either compiled in or loaded
+as a module).  The disk driver (sd_mod.o), CD-ROM driver (sr_mod.o),
+tape driver [1]_ (st.o) and SCSI generics driver (sg.o) represent the upper
 level drivers to support the various assorted devices which can be
 controlled.  You can for example load the tape driver to use the tape drive,
 and then unload it once you have no further need for the driver (and release
@@ -44,4 +42,3 @@ built into the kernel.
 
 .. [1] There is a variant of the st driver for controlling OnStream tape
        devices. Its module name is osst.o .
-

  parent reply	other threads:[~2023-05-18 21:28 UTC|newest]

Thread overview: 17+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-05-18 21:27 [PATCH 00/11] Documentation/scsi: organize SCSI docs & make more readable Randy Dunlap
2023-05-18 21:27 ` [PATCH 01/11] Docs/scsi: organize the SCSI documentation Randy Dunlap
2023-05-18 21:27 ` Randy Dunlap [this message]
2023-05-19  4:53   ` [PATCH 02/11] Docs/scsi: introduction: multiple cleanups Finn Thain
2023-05-18 21:27 ` [PATCH 03/11] Docs/scsi: arcmsr: use a chapter heading for clarity Randy Dunlap
2023-05-18 21:27 ` [PATCH 04/11] Docs/scsi: scsi-changer: shorten the chapter heading Randy Dunlap
2023-05-18 21:27 ` [PATCH 05/11] Docs/scsi: dc395x: " Randy Dunlap
2023-06-01  2:08   ` Bagas Sanjaya
2023-05-18 21:27 ` [PATCH 06/11] Docs/scsi: scsi_fc_transport: fix typo in heading Randy Dunlap
2023-05-18 21:27 ` [PATCH 07/11] Docs/scsi: scsi-generic: multiple cleanups Randy Dunlap
2023-05-18 21:27 ` [PATCH 08/11] Docs/scsi: g_NCR5380: shorten chapter heading Randy Dunlap
2023-05-19  4:45   ` Finn Thain
2023-05-18 21:27 ` [PATCH 09/11] Docs/scsi: megaraid: clarify " Randy Dunlap
2023-05-18 21:27 ` [PATCH 10/11] Docs/scsi: ncr53c8xx: shorten " Randy Dunlap
2023-05-18 21:27 ` [PATCH 11/11] Docs/scsi: sym53c8xx_2: " Randy Dunlap
2023-05-22 22:38 ` [PATCH 00/11] Documentation/scsi: organize SCSI docs & make more readable Martin K. Petersen
2023-06-01  0:43 ` Martin K. Petersen

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20230518212749.18266-3-rdunlap@infradead.org \
    --to=rdunlap@infradead.org \
    --cc=corbet@lwn.net \
    --cc=jejb@linux.ibm.com \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-scsi@vger.kernel.org \
    --cc=martin.petersen@oracle.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®