Minki/linux
1
0
Fork 1
mirror of https://github.com/torvalds/linux.git synced 2024-11-22 12:11:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

Documentation: fix links to mailing list services

Browse Source 
There have been some changes to the way mailing lists are hosted at
kernel.org. This patch does the following:

1. fixes links that are pointing at the outdated resources
2. removes an outdated patchbomb admonition

We still don't particularly want or welcome huge patchbombs, but they
are less likely to overload our systems.

Acked-by: Dan Williams <dan.j.williams@intel.com>
Signed-off-by: Konstantin Ryabitsev <konstantin@linuxfoundation.org>
Reviewed-by: Carlos Bilbao <carlos.bilbao.osdev@gmail.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20240619-docs-patch-msgid-link-v2-1-72dd272bfe37@linuxfoundation.org
This commit is contained in:
Konstantin Ryabitsev 2024-06-19 14:24:06 -04:00 committed by Jonathan Corbet
parent b393590992
commit 413e775efa
5 changed files with 18 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
Documentation/process/2.Process.rst
View File

@ -392,13 +392,13 @@ represent a potential hazard to developers, who risk getting buried under a
load of electronic mail, running afoul of the conventions used on the Linux load of electronic mail, running afoul of the conventions used on the Linux
lists, or both. lists, or both.
Most kernel mailing lists are run on vger.kernel.org; the master list can Most kernel mailing lists are hosted at kernel.org; the master list can
be found at: be found at:
http://vger.kernel.org/vger-lists.html https://subspace.kernel.org
There are lists hosted elsewhere, though; a number of them are at There are lists hosted elsewhere; please check the MAINTAINERS file for
redhat.com/mailman/listinfo. the list relevant for any particular subsystem.
The core mailing list for kernel development is, of course, linux-kernel. The core mailing list for kernel development is, of course, linux-kernel.
This list is an intimidating place to be; volume can reach 500 messages per This list is an intimidating place to be; volume can reach 500 messages per

10
Documentation/process/howto.rst
View File

@ -331,7 +331,7 @@ they need to be integration-tested. For this purpose, a special
testing repository exists into which virtually all subsystem trees are testing repository exists into which virtually all subsystem trees are
pulled on an almost daily basis: pulled on an almost daily basis:
https://git.kernel.org/?p=linux/kernel/git/next/linux-next.git https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git
This way, the linux-next gives a summary outlook onto what will be This way, the linux-next gives a summary outlook onto what will be
expected to go into the mainline kernel at the next merge period. expected to go into the mainline kernel at the next merge period.
@ -373,12 +373,12 @@ As some of the above documents describe, the majority of the core kernel
developers participate on the Linux Kernel Mailing list. Details on how developers participate on the Linux Kernel Mailing list. Details on how
to subscribe and unsubscribe from the list can be found at: to subscribe and unsubscribe from the list can be found at:
http://vger.kernel.org/vger-lists.html#linux-kernel https://subspace.kernel.org/subscribing.html
There are archives of the mailing list on the web in many different There are archives of the mailing list on the web in many different
places. Use a search engine to find these archives. For example: places. Use a search engine to find these archives. For example:
https://lore.kernel.org/lkml/ https://lore.kernel.org/linux-kernel/
It is highly recommended that you search the archives about the topic It is highly recommended that you search the archives about the topic
you want to bring up, before you post it to the list. A lot of things you want to bring up, before you post it to the list. A lot of things
@ -393,13 +393,13 @@ groups.
Many of the lists are hosted on kernel.org. Information on them can be Many of the lists are hosted on kernel.org. Information on them can be
found at: found at:
http://vger.kernel.org/vger-lists.html https://subspace.kernel.org
Please remember to follow good behavioral habits when using the lists. Please remember to follow good behavioral habits when using the lists.
Though a bit cheesy, the following URL has some simple guidelines for Though a bit cheesy, the following URL has some simple guidelines for
interacting with the list (or any list): interacting with the list (or any list):
http://www.albion.com/netiquette/ https://subspace.kernel.org/etiquette.html
If multiple people respond to your mail, the CC: list of recipients may If multiple people respond to your mail, the CC: list of recipients may
get pretty large. Don't remove anybody from the CC: list without a good get pretty large. Don't remove anybody from the CC: list without a good

5
Documentation/process/kernel-docs.rst
View File

@ -205,9 +205,8 @@ Miscellaneous
* Name: **linux-kernel mailing list archives and search engines** * Name: **linux-kernel mailing list archives and search engines**
:URL: http://vger.kernel.org/vger-lists.html :URL: https://subspace.kernel.org
:URL: http://www.uwsg.indiana.edu/hypermail/linux/kernel/index.html :URL: https://lore.kernel.org
:URL: http://groups.google.com/group/mlist.linux.kernel
:Keywords: linux-kernel, archives, search. :Keywords: linux-kernel, archives, search.
:Description: Some of the linux-kernel mailing list archivers. If :Description: Some of the linux-kernel mailing list archivers. If
you have a better/another one, please let me know. you have a better/another one, please let me know.

5
Documentation/process/maintainer-netdev.rst
View File

@ -25,9 +25,8 @@ drivers/net (i.e. hardware specific drivers) in the Linux source tree.
Note that some subsystems (e.g. wireless drivers) which have a high Note that some subsystems (e.g. wireless drivers) which have a high
volume of traffic have their own specific mailing lists and trees. volume of traffic have their own specific mailing lists and trees.
The netdev list is managed (like many other Linux mailing lists) through Like many other Linux mailing lists, the netdev list is hosted at
VGER (http://vger.kernel.org/) with archives available at kernel.org with archives available at https://lore.kernel.org/netdev/.
https://lore.kernel.org/netdev/
Aside from subsystems like those mentioned above, all network-related Aside from subsystems like those mentioned above, all network-related
Linux development (i.e. RFC, review, comments, etc.) takes place on Linux development (i.e. RFC, review, comments, etc.) takes place on

15
Documentation/process/submitting-patches.rst
View File

@ -119,10 +119,10 @@ web, point to it.
When linking to mailing list archives, preferably use the lore.kernel.org When linking to mailing list archives, preferably use the lore.kernel.org
message archiver service. To create the link URL, use the contents of the message archiver service. To create the link URL, use the contents of the
``Message-Id`` header of the message without the surrounding angle brackets. ``Message-ID`` header of the message without the surrounding angle brackets.
For example:: For example::
Link: https://lore.kernel.org/r/30th.anniversary.repost@klaava.Helsinki.FI/ Link: https://lore.kernel.org/30th.anniversary.repost@klaava.Helsinki.FI
Please check the link to make sure that it is actually working and points Please check the link to make sure that it is actually working and points
to the relevant message. to the relevant message.
@ -243,11 +243,9 @@ linux-kernel@vger.kernel.org should be used by default for all patches, but the
volume on that list has caused a number of developers to tune it out. Please volume on that list has caused a number of developers to tune it out. Please
do not spam unrelated lists and unrelated people, though. do not spam unrelated lists and unrelated people, though.
Many kernel-related lists are hosted on vger.kernel.org; you can find a Many kernel-related lists are hosted at kernel.org; you can find a list
list of them at http://vger.kernel.org/vger-lists.html. There are of them at https://subspace.kernel.org. There are kernel-related lists
kernel-related lists hosted elsewhere as well, though. hosted elsewhere as well, though.
Do not send more than 15 patches at once to the vger mailing lists!!!
Linus Torvalds is the final arbiter of all changes accepted into the Linus Torvalds is the final arbiter of all changes accepted into the
Linux kernel. His e-mail address is <torvalds@linux-foundation.org>. Linux kernel. His e-mail address is <torvalds@linux-foundation.org>.
@ -866,9 +864,6 @@ Greg Kroah-Hartman, "How to piss off a kernel subsystem maintainer".
<http://www.kroah.com/log/linux/maintainer-06.html> <http://www.kroah.com/log/linux/maintainer-06.html>
NO!!!! No more huge patch bombs to linux-kernel@vger.kernel.org people!
<https://lore.kernel.org/r/20050711.125305.08322243.davem@davemloft.net>
Kernel Documentation/process/coding-style.rst Kernel Documentation/process/coding-style.rst
Linus Torvalds's mail on the canonical patch format: Linus Torvalds's mail on the canonical patch format: