Documentation/networking/arcnet-hardware.rst | 13 +++--- Documentation/networking/arcnet.rst | 48 +++++--------------- 2 files changed, 17 insertions(+), 44 deletions(-)
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>
---
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@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 hesistate 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: 2f186dd5585c3afb415df80e52f71af16c9d3655
--
An old man doll... just what I always wanted! - Clara+ 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@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>
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@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 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@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: 2f186dd5585c3afb415df80e52f71af16c9d3655
> --
> An old man doll... just what I always wanted! - Clara
>
On Sat, Sep 13, 2025 at 09:59:26AM +0100, Simon Horman wrote:
> + 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@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>
>
> I think it would be good to get buy-in from Avery (now CCed) on these changes.
OK.
> > 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 hesistate to :ref:`email to netdev <arcnet-netdev>`.
>
> nit: hesitate
Thanks for the suggestion!
--
An old man doll... just what I always wanted! - Clara
© 2016 - 2025 Red Hat, Inc.