Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Feedback-ID: i58a146ae:Fastmail
Date:   Fri, 5 May 2023 20:12:08 +1000 (AEST)
From:   Finn Thain <fthain@linux-m68k.org>
To:     Bagas Sanjaya <bagasdotme@gmail.com>
cc:     Linux SCSI <linux-scsi@vger.kernel.org>,
        Linux Documentation <linux-doc@vger.kernel.org>,
        Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
        Linux Kernel Janitors <kernel-janitors@vger.kernel.org>,
        Oliver Neukum <oliver@neukum.org>,
        Ali Akcaagac <aliakc@web.de>,
        Jamie Lenehan <lenehan@twibble.org>,
        Jonathan Corbet <corbet@lwn.net>,
        "James E.J. Bottomley" <jejb@linux.ibm.com>,
        "Martin K. Petersen" <martin.petersen@oracle.com>
Subject: Re: [PATCH 3/3] Documentation: scsi: dc395x: Remove reference to
 2.4 driver
In-Reply-To: <20230505082704.16228-4-bagasdotme@gmail.com>
Message-ID: <d919a2e1-5749-13f8-7867-1f17277190f4@linux-m68k.org>
References: <20230505082704.16228-1-bagasdotme@gmail.com> <20230505082704.16228-4-bagasdotme@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Precedence: bulk


On Fri, 5 May 2023, Bagas Sanjaya wrote:

> The 2.4 driver link returns 404. 

It's still potentially useful:
https://web.archive.org/web/20140129181343/http://www.garloff.de/kurt/linux/dc395/

> As no one runs 2.4 kernel anymore,

Would it make a difference if someone does run that? Were you planning to 
delete the source code for the 2.4 kernel too?

> remove the stale reference.
> 

It was always stale inasmuch as it is apparently there to give credit for 
prior contributions, plus a changelog (see archive.org).

Any published link should probably be accompanied by a "retrieved on 
yyyy-mm-dd" qualification. But no qualification is better than no link at 
all, IMO.

Of course, there is a reason for an edit here. Yet it's not the one you 
gave. "This is a 2.5 only driver" is simply incorrect. (If it was correct 
you'd get to delete the whole thing.)

This is not a nak as I'm not the maintainer. But this patch just looks 
like churn with no justification. Perhaps I'm not the only one who can't 
see it.

> Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
> ---
>  Documentation/scsi/dc395x.rst | 4 ----
>  1 file changed, 4 deletions(-)
> 
> diff --git a/Documentation/scsi/dc395x.rst b/Documentation/scsi/dc395x.rst
> index c413b629809bcd..a6320561543650 100644
> --- a/Documentation/scsi/dc395x.rst
> +++ b/Documentation/scsi/dc395x.rst
> @@ -11,10 +11,6 @@ be safe to use. Testing with hard disks has not been done to any
>  great degree and caution should be exercised if you want to attempt
>  to use this driver with hard disks.
>  
> -This is a 2.5 only driver. For a 2.4 driver please see the original
> -driver (which this driver started from) at
> -http://www.garloff.de/kurt/linux/dc395/
> -
>  Problems, questions and patches should be submitted to the `Linux SCSI
>  mailing list <linux-scsi@vger.kernel.org>`_.
>  
>