[PATCH net-next v2] Documentation: ARCnet: Update obsolete contact info

[PATCH net-next v2] Documentation: ARCnet: Update obsolete contact info

[Bagas Sanjaya]

ARCnet docs states that inquiries on the subsystem should be emailed to
Avery Pennarun <apenwarr@worldvisions.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@gmail.com>
---
Changes since v1 [1]:

  - s/hesistate/hesitate/ (Simon)

netdev maintainers: Since there is no reply from Avery on v1, can this patch
be acked and merged into net-next?

[1]: https://lore.kernel.org/linux-doc/20250912042252.19901-1-bagasdotme@gmail.com/

 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..e75346f112920a 100644
--- a/Documentation/networking/arcnet-hardware.rst
+++ b/Documentation/networking/arcnet-hardware.rst
@@ -4,6 +4,8 @@
 ARCnet Hardware
 ===============
 
+:Author: Avery Pennarun <apenwarr@worldvisions.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@worldvisions.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 hesitate to :ref:`email to netdev <arcnet-netdev>`.
 
 
 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@worldvisions.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@worldvisions.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@worldvisions.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@tichy.ch.uj.edu.pl.  Then, to submit messages to the
-list, mail to linux-arcnet@tichy.ch.uj.edu.pl.
-
-There are archives of the mailing list at:
-
-	http://epistolary.org/mailman/listinfo.cgi/arcnet
-
-The people on linux-net@vger.kernel.org (now defunct, replaced by
-netdev@vger.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@vger.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@worldvisions.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: 26ab9830beabda863766be4a79dc590c7645f4d9
-- 
An old man doll... just what I always wanted! - Clara

Re: [PATCH net-next v2] Documentation: ARCnet: Update obsolete contact info

[Randy Dunlap]

Hi,

On 10/22/25 7:55 PM, Bagas Sanjaya wrote:
> ARCnet docs states that inquiries on the subsystem should be emailed to
> Avery Pennarun <apenwarr@worldvisions.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@gmail.com>

The patch LGTM and causes no errors/warnings.

Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>

I'm wondering about one thing in arcnet-hardware.rst:
  it refers to www.arcnet.com.
Did you happen to try that web site?
Looks like it is something about AIoT.
I found the ARCnet Trade Association at
  www.arcnet.cc

> ---
> Changes since v1 [1]:
> 
>   - s/hesistate/hesitate/ (Simon)
> 
> netdev maintainers: Since there is no reply from Avery on v1, can this patch
> be acked and merged into net-next?
> 
> [1]: https://lore.kernel.org/linux-doc/20250912042252.19901-1-bagasdotme@gmail.com/
> 
>  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..e75346f112920a 100644
> --- a/Documentation/networking/arcnet-hardware.rst
> +++ b/Documentation/networking/arcnet-hardware.rst
> @@ -4,6 +4,8 @@
>  ARCnet Hardware
>  ===============
>  
> +:Author: Avery Pennarun <apenwarr@worldvisions.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@worldvisions.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 hesitate to :ref:`email to netdev <arcnet-netdev>`.
>  
>  
>  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@worldvisions.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@worldvisions.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@worldvisions.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@tichy.ch.uj.edu.pl.  Then, to submit messages to the
> -list, mail to linux-arcnet@tichy.ch.uj.edu.pl.
> -
> -There are archives of the mailing list at:
> -
> -	http://epistolary.org/mailman/listinfo.cgi/arcnet
> -
> -The people on linux-net@vger.kernel.org (now defunct, replaced by
> -netdev@vger.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@vger.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@worldvisions.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: 26ab9830beabda863766be4a79dc590c7645f4d9

-- 
~Randy

Re: [PATCH net-next v2] Documentation: ARCnet: Update obsolete contact info

[Bagas Sanjaya]

[-- Attachment #1: Type: text/plain, Size: 516 bytes --]

On Wed, Oct 22, 2025 at 09:21:43PM -0700, Randy Dunlap wrote:
> I'm wondering about one thing in arcnet-hardware.rst:
>   it refers to www.arcnet.com.
> Did you happen to try that web site?
> Looks like it is something about AIoT.

And it's membership application form, though. (I'm on the err side to not
enter my personal data there.)

> I found the ARCnet Trade Association at
>   www.arcnet.cc

That's ARCNET Resource Center.

Thanks.

-- 
An old man doll... just what I always wanted! - Clara

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

Re: [PATCH net-next v2] Documentation: ARCnet: Update obsolete contact info

[Randy Dunlap]

On 10/23/25 1:43 AM, Bagas Sanjaya wrote:
> On Wed, Oct 22, 2025 at 09:21:43PM -0700, Randy Dunlap wrote:
>> I'm wondering about one thing in arcnet-hardware.rst:
>>   it refers to www.arcnet.com.
>> Did you happen to try that web site?
>> Looks like it is something about AIoT.
> 
> And it's membership application form, though. (I'm on the err side to not
> enter my personal data there.)

Same here.

>> I found the ARCnet Trade Association at
>>   www.arcnet.cc
> 
> That's ARCNET Resource Center.

OK, the ATA is  https://arcnet.cc/abtata.htm

I suggest changing the link.  what do you think?

-- 
~Randy

Re: [PATCH net-next v2] Documentation: ARCnet: Update obsolete contact info

[Bagas Sanjaya]

On 10/23/25 23:43, Randy Dunlap wrote:
> 
> 
> On 10/23/25 1:43 AM, Bagas Sanjaya wrote:
>> On Wed, Oct 22, 2025 at 09:21:43PM -0700, Randy Dunlap wrote:
>>> I found the ARCnet Trade Association at
>>>    www.arcnet.cc
>>
>> That's ARCNET Resource Center.
> 
> OK, the ATA is  https://arcnet.cc/abtata.htm
> 
> I suggest changing the link.  what do you think?
> 

Fair enough.

-- 
An old man doll... just what I always wanted! - Clara