Skip to content

Commit 413e775

Browse files
mriconJonathan Corbet
authored andcommitted
Documentation: fix links to mailing list services
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 <[email protected]> Signed-off-by: Konstantin Ryabitsev <[email protected]> Reviewed-by: Carlos Bilbao <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]> Link: https://lore.kernel.org/r/20240619-docs-patch-msgid-link-v2-1-72dd272bfe37@linuxfoundation.org
1 parent b393590 commit 413e775

File tree

5 files changed

+18
-25
lines changed

5 files changed

+18
-25
lines changed

Documentation/process/2.Process.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -392,13 +392,13 @@ represent a potential hazard to developers, who risk getting buried under a
392392
load of electronic mail, running afoul of the conventions used on the Linux
393393
lists, or both.
394394

395-
Most kernel mailing lists are run on vger.kernel.org; the master list can
395+
Most kernel mailing lists are hosted at kernel.org; the master list can
396396
be found at:
397397

398-
http://vger.kernel.org/vger-lists.html
398+
https://subspace.kernel.org
399399

400-
There are lists hosted elsewhere, though; a number of them are at
401-
redhat.com/mailman/listinfo.
400+
There are lists hosted elsewhere; please check the MAINTAINERS file for
401+
the list relevant for any particular subsystem.
402402

403403
The core mailing list for kernel development is, of course, linux-kernel.
404404
This list is an intimidating place to be; volume can reach 500 messages per

Documentation/process/howto.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -331,7 +331,7 @@ they need to be integration-tested. For this purpose, a special
331331
testing repository exists into which virtually all subsystem trees are
332332
pulled on an almost daily basis:
333333

334-
https://git.kernel.org/?p=linux/kernel/git/next/linux-next.git
334+
https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git
335335

336336
This way, the linux-next gives a summary outlook onto what will be
337337
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
373373
developers participate on the Linux Kernel Mailing list. Details on how
374374
to subscribe and unsubscribe from the list can be found at:
375375

376-
http://vger.kernel.org/vger-lists.html#linux-kernel
376+
https://subspace.kernel.org/subscribing.html
377377

378378
There are archives of the mailing list on the web in many different
379379
places. Use a search engine to find these archives. For example:
380380

381-
https://lore.kernel.org/lkml/
381+
https://lore.kernel.org/linux-kernel/
382382

383383
It is highly recommended that you search the archives about the topic
384384
you want to bring up, before you post it to the list. A lot of things
@@ -393,13 +393,13 @@ groups.
393393
Many of the lists are hosted on kernel.org. Information on them can be
394394
found at:
395395

396-
http://vger.kernel.org/vger-lists.html
396+
https://subspace.kernel.org
397397

398398
Please remember to follow good behavioral habits when using the lists.
399399
Though a bit cheesy, the following URL has some simple guidelines for
400400
interacting with the list (or any list):
401401

402-
http://www.albion.com/netiquette/
402+
https://subspace.kernel.org/etiquette.html
403403

404404
If multiple people respond to your mail, the CC: list of recipients may
405405
get pretty large. Don't remove anybody from the CC: list without a good

Documentation/process/kernel-docs.rst

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -205,9 +205,8 @@ Miscellaneous
205205

206206
* Name: **linux-kernel mailing list archives and search engines**
207207

208-
:URL: http://vger.kernel.org/vger-lists.html
209-
:URL: http://www.uwsg.indiana.edu/hypermail/linux/kernel/index.html
210-
:URL: http://groups.google.com/group/mlist.linux.kernel
208+
:URL: https://subspace.kernel.org
209+
:URL: https://lore.kernel.org
211210
:Keywords: linux-kernel, archives, search.
212211
:Description: Some of the linux-kernel mailing list archivers. If
213212
you have a better/another one, please let me know.

Documentation/process/maintainer-netdev.rst

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,8 @@ drivers/net (i.e. hardware specific drivers) in the Linux source tree.
2525
Note that some subsystems (e.g. wireless drivers) which have a high
2626
volume of traffic have their own specific mailing lists and trees.
2727

28-
The netdev list is managed (like many other Linux mailing lists) through
29-
VGER (http://vger.kernel.org/) with archives available at
30-
https://lore.kernel.org/netdev/
28+
Like many other Linux mailing lists, the netdev list is hosted at
29+
kernel.org with archives available at https://lore.kernel.org/netdev/.
3130

3231
Aside from subsystems like those mentioned above, all network-related
3332
Linux development (i.e. RFC, review, comments, etc.) takes place on

Documentation/process/submitting-patches.rst

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -119,10 +119,10 @@ web, point to it.
119119

120120
When linking to mailing list archives, preferably use the lore.kernel.org
121121
message archiver service. To create the link URL, use the contents of the
122-
``Message-Id`` header of the message without the surrounding angle brackets.
122+
``Message-ID`` header of the message without the surrounding angle brackets.
123123
For example::
124124

125-
Link: https://lore.kernel.org/r/[email protected]/
125+
Link: https://lore.kernel.org/[email protected]
126126

127127
Please check the link to make sure that it is actually working and points
128128
to the relevant message.
@@ -243,11 +243,9 @@ [email protected] should be used by default for all patches, but the
243243
volume on that list has caused a number of developers to tune it out. Please
244244
do not spam unrelated lists and unrelated people, though.
245245

246-
Many kernel-related lists are hosted on vger.kernel.org; you can find a
247-
list of them at http://vger.kernel.org/vger-lists.html. There are
248-
kernel-related lists hosted elsewhere as well, though.
249-
250-
Do not send more than 15 patches at once to the vger mailing lists!!!
246+
Many kernel-related lists are hosted at kernel.org; you can find a list
247+
of them at https://subspace.kernel.org. There are kernel-related lists
248+
hosted elsewhere as well, though.
251249

252250
Linus Torvalds is the final arbiter of all changes accepted into the
253251
Linux kernel. His e-mail address is <[email protected]>.
@@ -866,9 +864,6 @@ Greg Kroah-Hartman, "How to piss off a kernel subsystem maintainer".
866864

867865
<http://www.kroah.com/log/linux/maintainer-06.html>
868866

869-
NO!!!! No more huge patch bombs to [email protected] people!
870-
<https://lore.kernel.org/r/[email protected]>
871-
872867
Kernel Documentation/process/coding-style.rst
873868

874869
Linus Torvalds's mail on the canonical patch format:

0 commit comments

Comments
 (0)