Message-ID: <20250913085926.GI224143@horms.kernel.org>
Date: Sat, 13 Sep 2025 09:59:26 +0100
From: Simon Horman <horms@...nel.org>
To: Bagas Sanjaya <bagasdotme@...il.com>
Cc: Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
	Linux Documentation <linux-doc@...r.kernel.org>,
	Linux Networking <netdev@...r.kernel.org>,
	"David S. Miller" <davem@...emloft.net>,
	Eric Dumazet <edumazet@...gle.com>,
	Jakub Kicinski <kuba@...nel.org>, Paolo Abeni <pabeni@...hat.com>,
	Jonathan Corbet <corbet@....net>,
	Michael Grzeschik <m.grzeschik@...gutronix.de>,
	Avery Pennarun <apenwarr@...ldvisions.ca>
Subject: Re: [PATCH RESEND net-next] Documentation: ARCnet: Update obsolete
 contact info

+ Avery

On Fri, Sep 12, 2025 at 11:22:52AM +0700, Bagas Sanjaya wrote:
> ARCnet docs states that inquiries on the subsystem should be emailed to
> Avery Pennarun <apenwarr@...ldvisions.ca>, for whom has been in CREDITS
> since the beginning of kernel git history and the subsystem is now
> maintained by Michael Grzeschik since c38f6ac74c9980 ("MAINTAINERS: add
> arcnet and take maintainership"). In addition, there used to be a
> dedicated ARCnet mailing list but its archive at epistolary.org has been
> shut down. ARCnet discussion nowadays take place in netdev list.
> 
> Update contact information.
> 
> Signed-off-by: Bagas Sanjaya <bagasdotme@...il.com>

I think it would be good to get buy-in from Avery (now CCed) on these changes.

> ---
>  Documentation/networking/arcnet-hardware.rst | 13 +++---
>  Documentation/networking/arcnet.rst          | 48 +++++---------------
>  2 files changed, 17 insertions(+), 44 deletions(-)
> 
> diff --git a/Documentation/networking/arcnet-hardware.rst b/Documentation/networking/arcnet-hardware.rst
> index 3bf7f99cd7bbf0..1e4484d880fe67 100644
> --- a/Documentation/networking/arcnet-hardware.rst
> +++ b/Documentation/networking/arcnet-hardware.rst
> @@ -4,6 +4,8 @@
>  ARCnet Hardware
>  ===============
>  
> +:Author: Avery Pennarun <apenwarr@...ldvisions.ca>
> +
>  .. note::
>  
>     1) This file is a supplement to arcnet.txt.  Please read that for general
> @@ -13,9 +15,9 @@ ARCnet Hardware
>  
>  Because so many people (myself included) seem to have obtained ARCnet cards
>  without manuals, this file contains a quick introduction to ARCnet hardware,
> -some cabling tips, and a listing of all jumper settings I can find. Please
> -e-mail apenwarr@...ldvisions.ca with any settings for your particular card,
> -or any other information you have!
> +some cabling tips, and a listing of all jumper settings I can find. If you
> +have any settings for your particular card, and/or any other information you
> +have, do not hesistate to :ref:`email to netdev <arcnet-netdev>`.

nit: hesitate

...

>  
>  
>  Introduction to ARCnet
> @@ -3226,9 +3228,6 @@ Settings for IRQ Selection (Lower Jumper Line)
>  Other Cards
>  ===========
>  
> -I have no information on other models of ARCnet cards at the moment.  Please
> -send any and all info to:
> -
> -	apenwarr@...ldvisions.ca
> +I have no information on other models of ARCnet cards at the moment.
>  
>  Thanks.
> diff --git a/Documentation/networking/arcnet.rst b/Documentation/networking/arcnet.rst
> index 82fce606c0f0bc..cd43a18ad1494b 100644
> --- a/Documentation/networking/arcnet.rst
> +++ b/Documentation/networking/arcnet.rst
> @@ -4,6 +4,8 @@
>  ARCnet
>  ======
>  
> +:Author: Avery Pennarun <apenwarr@...ldvisions.ca>
> +
>  .. note::
>  
>     See also arcnet-hardware.txt in this directory for jumper-setting
> @@ -30,18 +32,7 @@ Come on, be a sport!  Send me a success report!
>  
>  (hey, that was even better than my original poem... this is getting bad!)
>  
> -
> -.. warning::
> -
> -   If you don't e-mail me about your success/failure soon, I may be forced to
> -   start SINGING.  And we don't want that, do we?
> -
> -   (You know, it might be argued that I'm pushing this point a little too much.
> -   If you think so, why not flame me in a quick little e-mail?  Please also
> -   include the type of card(s) you're using, software, size of network, and
> -   whether it's working or not.)
> -
> -   My e-mail address is: apenwarr@...ldvisions.ca
> +----
>  
>  These are the ARCnet drivers for Linux.
>  
> @@ -59,23 +50,14 @@ ARCnet 2.10 ALPHA, Tomasz's all-new-and-improved RFC1051 support has been
>  included and seems to be working fine!
>  
>  
> +.. _arcnet-netdev:
> +
>  Where do I discuss these drivers?
>  ---------------------------------
>  
> -Tomasz has been so kind as to set up a new and improved mailing list.
> -Subscribe by sending a message with the BODY "subscribe linux-arcnet YOUR
> -REAL NAME" to listserv@...hy.ch.uj.edu.pl.  Then, to submit messages to the
> -list, mail to linux-arcnet@...hy.ch.uj.edu.pl.
> -
> -There are archives of the mailing list at:
> -
> -	http://epistolary.org/mailman/listinfo.cgi/arcnet
> -
> -The people on linux-net@...r.kernel.org (now defunct, replaced by
> -netdev@...r.kernel.org) have also been known to be very helpful, especially
> -when we're talking about ALPHA Linux kernels that may or may not work right
> -in the first place.
> -
> +ARCnet discussions take place on netdev. Simply send your email to
> +netdev@...r.kernel.org and make sure to Cc: maintainer listed in
> +"ARCNET NETWORK LAYER" heading of Documentation/process/maintainers.rst.
>  
>  Other Drivers and Info
>  ----------------------
> @@ -523,17 +505,9 @@ can set up your network then:
>  It works: what now?
>  -------------------
>  
> -Send mail describing your setup, preferably including driver version, kernel
> -version, ARCnet card model, CPU type, number of systems on your network, and
> -list of software in use to me at the following address:
> -
> -	apenwarr@...ldvisions.ca
> -
> -I do send (sometimes automated) replies to all messages I receive.  My email
> -can be weird (and also usually gets forwarded all over the place along the
> -way to me), so if you don't get a reply within a reasonable time, please
> -resend.
> -
> +Send mail following :ref:`arcnet-netdev`. Describe your setup, preferably
> +including driver version, kernel version, ARCnet card model, CPU type, number
> +of systems on your network, and list of software in use.
>  
>  It doesn't work: what now?
>  --------------------------
> 
> base-commit: 2f186dd5585c3afb415df80e52f71af16c9d3655
> -- 
> An old man doll... just what I always wanted! - Clara
> 

Powered by blists - more mailing lists