Skip to content

Doc: replace opaque mail archive links with lore.kernel.org

Denton Liu git 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v2 Latest3 patches 1 replyIn review

Patches in v2 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/3doc: replace MARC links with lore.kernel.orgDocumentation/git-bisect-lk2009.txt Documentation/gitcli.txt Documentation/user-manual.txt +1 more+6 -60 replies
2/3RelNotes: replace Gmane with real Message-IDsDocumentation/RelNotes/1.6.2.txt Documentation/RelNotes/1.6.3.txt Documentation/RelNotes/1.6.4.txt +6 more+11 -100 replies
3/3doc: replace LKML link with lore.kernel.orgDocumentation/technical/racy-git.txt+1 -10 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v2 yet.

Read the v2 thread

Cover letter [PATCH v2 0/3] Doc: replace opaque mail archive links with lore.kernel.org

We reference many mail archives that use opaque links. Even though many have been around for a long time, they may still be liable to go down (see Gmane) leaving us with dead links that we cannot reference in the future. Replace these links with links to lore.kernel.org which use Message-IDs so that if lore.kernel.org ever goes down, it will be much easier to find these messages in the future.

My series is based on top of 'jk/lore-is-the-archive'.

Denton Liu (3):
doc: replace MARC links with lore.kernel.org
RelNotes: replace Gmane with real Message-IDs
doc: replace LKML link with lore.kernel.org

 Documentation/RelNotes/1.6.2.txt     | 2 +-
 Documentation/RelNotes/1.6.3.txt     | 2 +-
 Documentation/RelNotes/1.6.4.txt     | 2 +-
 Documentation/RelNotes/1.6.5.txt     | 2 +-
 Documentation/RelNotes/1.6.6.txt     | 2 +-
 Documentation/RelNotes/1.8.4.txt     | 2 +-
 Documentation/RelNotes/2.5.0.txt     | 3 ++-
 Documentation/RelNotes/2.8.3.txt     | 4 ++--
 Documentation/RelNotes/2.9.0.txt     | 2 +-
 Documentation/git-bisect-lk2009.txt  | 2 +-
 Documentation/gitcli.txt             | 4 ++--
 Documentation/technical/racy-git.txt | 2 +-
 Documentation/user-manual.txt        | 4 ++--
 t/t6021-merge-criss-cross.sh         | 2 +-
 14 files changed, 18 insertions(+), 17 deletions(-)

Range-diff against v1:
1: 14167012a1 ! 1: 0f100f06c5 doc: replace MARC links with LKML
@@ Metadata
Author: Denton Liu <[email protected]>

## Commit message ##
- doc: replace MARC links with LKML
+ doc: replace MARC links with lore.kernel.org

Since we're now recommending lore.kernel.org, replace marc.info links with lore.kernel.org.

Although MARC has been around for a long time, nothing lasts forever (see Gmane). Since MARC uses opaque message identifiers, switching to
- LKML should be a strict improvement since, even if LKML goes
- down, the Message-ID will allow future readers to look up the referenced
- messages on any other archive.
+ lore.kernel.org should be a strict improvement since, even if
+ lore.kernel.org goes down, the Message-ID will allow future readers to
+ look up the referenced messages on any other archive.

We leave behind one reference to MARC in the README.md since it's a perfectly fine mail archive for personal reading, just not for linking
2: ebb2328a02 ! 2: cad77e0989 RelNotes: replace Gmane with real Message-IDs
@@ Commit message
are definitely not in active use, they might be of historical interest for future readers so let's ensure that mail references are more robust.

- Replace links to Gmane with links to LKML (which is our new preferred
- mailing list archive and has the Message-ID in the URL) and bare Gmane
- ID references with Message-IDs.
+ Replace links to Gmane with links to lore.kernel.org (which is our new
+ preferred mailing list archive and has the Message-ID in the URL) and
+ bare Gmane ID references with Message-IDs.

The Message-IDs were found by searching for "gmane:<id>" on
https://public-inbox.org/git/ and taking the resulting message.
@@ Documentation/RelNotes/2.8.3.txt: Fixes since v2.8.2
has been used in Cygwin packaged versions of Git for quite a while.
- See http://thread.gmane.org/gmane.comp.version-control.git/291853
- and http://thread.gmane.org/gmane.comp.version-control.git/275680.
-+ See https://lkml.org/git/[email protected]/
-+ and https://lkml.org/git/[email protected]/.
++ See https://lore.kernel.org/git/[email protected]/
++ and https://lore.kernel.org/git/[email protected]/.

* "git replace -e" did not honour "core.editor" configuration.

@@ Documentation/RelNotes/2.9.0.txt: notes for details).
already enabled for the MinGW and plain Windows builds. It also has been used in Cygwin packaged versions of Git for quite a while.
- See http://thread.gmane.org/gmane.comp.version-control.git/291853
-+ See https://lkml.org/git/[email protected]/
++ See https://lore.kernel.org/git/[email protected]/

* "merge-octopus" strategy did not ensure that the index is clean when merge begins.
-: ---------- > 3: a7c8981ba5 doc: replace LKML link with lore.kernel.org

Signature · 1 line
2.24.0.504.g3cd56eb17d