From 10eedd175e99a8be191d116d5c81c340d6c3c5b6 Mon Sep 17 00:00:00 2001
From: Luca Di Sera <luca.disera@qt.io>
Date: Wed, 15 Sep 2021 16:41:31 +0200
Subject: Doc: Centralize RFC documentation-links in rfc.qdoc
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

In the effort of repairing broken links as per QTBUG-96127,
a series of RFC links referring to `tools.ietf.org/html/*` were modified
to point to the new address that the site redirected to.

To simplify executing a similar task and to diminish the duplication of
manually inserted urls, the already existing `rfc.qdoc` file, containing
`\externalpage` commands directing to RFC locations, was enhanced with
links to all RFCs that were mentioned in the current documentation, so
as to aggregate this common category of links.

All links pointing to a `ietf` domain inside QDoc documentation blocks
were then changed to use the newly provided external-references.

Task-number: QTBUG-96127
Pick-to: 6.2
Change-Id: I2a52eb6aa8c9e346f64ef1a627b039220d9f6c2a
Reviewed-by: Mårten Nordheim <marten.nordheim@qt.io>
---
 doc/global/externalsites/rfc.qdoc | 95 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 95 insertions(+)

(limited to 'doc/global')

diff --git a/doc/global/externalsites/rfc.qdoc b/doc/global/externalsites/rfc.qdoc
index 029ea6f055..6d515d8506 100644
--- a/doc/global/externalsites/rfc.qdoc
+++ b/doc/global/externalsites/rfc.qdoc
@@ -46,6 +46,11 @@
     \title RFC 1738
 */
 
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc1918
+    \title RFC 1918
+*/
+
 /*!
     \externalpage https://datatracker.ietf.org/doc/html/rfc1928
     \title RFC 1928
@@ -88,12 +93,102 @@
     \title RFC 3491
 */
 
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc3492
+    \title RFC 3492
+*/
+
 /*!
     \externalpage https://datatracker.ietf.org/doc/html/rfc3986
     \title RFC 3986
 */
 
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc4122
+    \title RFC 4122
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc4627
+    \title RFC 4627
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc4648
+    \title RFC 4648
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc4686
+    \title RFC 4686
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc5280#section-5.3.1
+    \title RFC 5280, section 5.3.1
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc6347
+    \title RFC 6347
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc6347#section-4.2.1
+    \title RFC 6347, section 4.2.1
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc6347#section-4.2.8
+    \title RFC 6347, section 4.2.8
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc6724
+    \title RFC 6724
+*/
+
 /*!
     \externalpage https://datatracker.ietf.org/doc/html/rfc7049
     \title RFC 7049
 */
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc7049#section-3.9
+    \title RFC 7049, section 3.9
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc7049#section-3.10
+    \title RFC 7049, section 3.10
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc7049#section-6
+    \title RFC 7049, section 6
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc7252
+    \title RFC 7252
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc8018#section-5.1
+    \title RFC 8018, section 5.1
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc8018#section-5.2
+    \title RFC 8018, section 5.2
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc8152
+    \title RFC 8152
+*/
+
+/*!
+    \externalpage https://datatracker.ietf.org/doc/html/rfc8446#section-6
+    \title RFC 8446, section 6
+*/
-- 
cgit v1.2.3