git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: Denton Liu <liu.denton@gmail.com>
To: Git Mailing List <git@vger.kernel.org>
Cc: Jeff King <peff@peff.net>,
	Konstantin Ryabitsev <konstantin@linuxfoundation.org>,
	Eric Wong <e@80x24.org>, Junio C Hamano <gitster@pobox.com>
Subject: [PATCH v2 0/3] Doc: replace opaque mail archive links with lore.kernel.org
Date: Mon, 2 Dec 2019 11:26:15 -0800	[thread overview]
Message-ID: <cover.1575314676.git.liu.denton@gmail.com> (raw)
In-Reply-To: <cover.1574882812.git.liu.denton@gmail.com>

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 <liu.denton@gmail.com>
     
      ## 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/20160419091055.GF2345@dinwoodie.org/
    -+   and https://lkml.org/git/20150811100527.GW14466@dinwoodie.org/.
    ++   See https://lore.kernel.org/git/20160419091055.GF2345@dinwoodie.org/
    ++   and https://lore.kernel.org/git/20150811100527.GW14466@dinwoodie.org/.
      
       * "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/20160419091055.GF2345@dinwoodie.org/
    ++   See https://lore.kernel.org/git/20160419091055.GF2345@dinwoodie.org/
      
       * "merge-octopus" strategy did not ensure that the index is clean
         when merge begins.
-:  ---------- > 3:  a7c8981ba5 doc: replace LKML link with lore.kernel.org
-- 
2.24.0.504.g3cd56eb17d


  parent reply	other threads:[~2019-12-02 19:26 UTC|newest]

Thread overview: 28+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-11-20 15:43 This list is now also archived on lore.kernel.org/git Konstantin Ryabitsev
2019-11-20 19:55 ` Eric Wong
2019-11-27 15:31   ` Ævar Arnfjörð Bjarmason
2019-11-27 16:18     ` Jeff King
2019-11-27 20:25     ` Eric Wong
2019-11-27 12:52 ` Jeff King
2019-11-27 12:53   ` [PATCH 1/2] doc: recommend lore.kernel.org over public-inbox.org Jeff King
2019-11-27 12:59     ` Eric Wong
2019-11-27 20:00       ` Johannes Schindelin
2019-11-27 20:04         ` Eric Wong
2019-11-28 10:25           ` Johannes Schindelin
2019-11-28 19:48             ` Eric Wong
2019-11-28 22:17               ` Johannes Schindelin
2019-11-28 22:31                 ` Eric Wong
2019-11-29  9:32                   ` Johannes Schindelin
2019-11-29  9:59                     ` Eric Wong
2019-11-27 12:54   ` [PATCH 2/2] doc: replace public-inbox links with lore.kernel.org Jeff King
2019-11-27 14:37     ` Derrick Stolee
2019-11-27 19:28   ` [PATCH 0/2] Hi Peff, Denton Liu
2019-11-27 19:28     ` [PATCH 1/2] doc: replace MARC links with LKML Denton Liu
2019-11-27 19:28     ` [PATCH 2/2] RelNotes: replace Gmane with real Message-IDs Denton Liu
2019-11-28  0:16       ` Denton Liu
2019-11-30 17:14     ` [PATCH 0/2] Hi Peff, Junio C Hamano
2019-12-02 19:26     ` Denton Liu [this message]
2019-12-02 19:26       ` [PATCH v2 1/3] doc: replace MARC links with lore.kernel.org Denton Liu
2019-12-02 19:26       ` [PATCH v2 2/3] RelNotes: replace Gmane with real Message-IDs Denton Liu
2019-12-02 19:26       ` [PATCH v2 3/3] doc: replace LKML link with lore.kernel.org Denton Liu
2019-12-04 18:28       ` [PATCH v2 0/3] Doc: replace opaque mail archive links " Junio C Hamano

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: http://vger.kernel.org/majordomo-info.html

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=cover.1575314676.git.liu.denton@gmail.com \
    --to=liu.denton@gmail.com \
    --cc=e@80x24.org \
    --cc=git@vger.kernel.org \
    --cc=gitster@pobox.com \
    --cc=konstantin@linuxfoundation.org \
    --cc=peff@peff.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).