From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 62FE2A04A4 for ; Wed, 27 May 2020 11:25:28 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 50E221D654; Wed, 27 May 2020 11:25:28 +0200 (CEST) Received: from mail-wr1-f44.google.com (mail-wr1-f44.google.com [209.85.221.44]) by dpdk.org (Postfix) with ESMTP id BFC4E1D909 for ; Wed, 27 May 2020 11:25:26 +0200 (CEST) Received: by mail-wr1-f44.google.com with SMTP id x14so17908261wrp.2 for ; Wed, 27 May 2020 02:25:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=B/EoNO/aG7XIKuhYF250/YKd2ZR3QZITboXKTm8BENg=; b=O+ZDBQPRK/Ork/SHFaVuf5nEk/2LBIG4R5H8AZkRlAV2JDT+DL5NY3HEsyCWaCg2zg BSiTVKTAVvsd7riTCSGLPOSzAcg25tmJ1D7emqT9hKEL5QrWW0tU452cZAxNplw3to9d WdFvY+ZjMXjTpfAviOFANlO+FL44GYVILZGLHKWjFLLUywhcdPA9DkLmNNbTJNxam734 p2WOq3lpJmATHmmoi43yucaaAm4oC8ULdgFzx/ksHZHU63hKPBVRSBdBTeA3U6Vk7z5o 0Tx20StCU6MV9ExcBH+6T5vdVegDOLRNmXpmKYP0w+6bnYE/YCyQXEDbf1gQ3ucfjvNa KudA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=B/EoNO/aG7XIKuhYF250/YKd2ZR3QZITboXKTm8BENg=; b=iazYFrcetgMzNSNlR6UU3Hs7hHq6zi/TX2IDG7pJjSjU1wgJchvwxP7xWAMr/0Md2N ac4fEGD2LBmrpRN1cTvtcN8jG8Tc8zEiV9DMnxrNS5q50oMxSLoJC7lM8O6HhX5o6ziP VoDEw/oHNaI5Mguocr5hbJB2SvIdTFRP+lxNPlI0//qEfJpuBvoyPsNy6XPUc64rtmVq +U+30bp17iIjc4bXZuI6HioBglp8lnHtlvKPzVAoQ17p99M+bZbGDaDAlyhCMhvBNo+D PEXE/3f30QcQpRNpdWD37xNi/9VgHTeFaDCJzH6n/mX5TpXHXNL8IKLhtCNUoDCgH/Vz 9CNw== X-Gm-Message-State: AOAM530r8HAPsVsWuzFMwi4Jx+S2cayY4dAkIi3uGQxCXQ+g2AGR29p3 yRs/Pry9r9VBm56RhkTnspACOVjuB4U= X-Google-Smtp-Source: ABdhPJzqt1I2BxTeqEzmsbvYe18MknsrcVvsfnnGEaWy7IZ0NU1SteSK6CL+r5KFB+bBwnAhhO0ttQ== X-Received: by 2002:a5d:44c6:: with SMTP id z6mr23604384wrr.20.1590571526360; Wed, 27 May 2020 02:25:26 -0700 (PDT) Received: from localhost ([88.98.246.218]) by smtp.gmail.com with ESMTPSA id q13sm2231584wrn.84.2020.05.27.02.25.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 27 May 2020 02:25:25 -0700 (PDT) From: luca.boccassi@gmail.com To: David Marchand Cc: Kevin Traynor , dpdk stable Date: Wed, 27 May 2020 10:24:22 +0100 Message-Id: <20200527092422.258652-19-luca.boccassi@gmail.com> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20200527092422.258652-1-luca.boccassi@gmail.com> References: <20200522094022.1025696-43-luca.boccassi@gmail.com> <20200527092422.258652-1-luca.boccassi@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-stable] patch 'doc: prefer https when pointing to dpdk.org' has been queued to stable release 19.11.3 X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org Sender: "stable" Hi, FYI, your patch has been queued to stable release 19.11.3 Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet. It will be pushed if I get no objections before 05/29/20. So please shout if anyone has objections. Also note that after the patch there's a diff of the upstream commit vs the patch applied to the branch. This will indicate if there was any rebasing needed to apply to the stable branch. If there were code changes for rebasing (ie: not only metadata diffs), please double check that the rebase was correctly done. Thanks. Luca Boccassi --- >From 106dddaf877636331d25b24a0e7085c544e84ed2 Mon Sep 17 00:00:00 2001 From: David Marchand Date: Thu, 19 Mar 2020 09:28:59 +0100 Subject: [PATCH] doc: prefer https when pointing to dpdk.org [ upstream commit 3d4b2afb73f7f0988f8e66ba1b37f2a446e33868 ] for file in $(git grep -l http://.*dpdk.org doc/); do sed -i -e 's#http://\(.*dpdk.org\)#https://\1#g' $file; done Signed-off-by: David Marchand Acked-by: Kevin Traynor --- devtools/checkpatches.sh | 8 ++++++++ doc/guides/contributing/documentation.rst | 12 ++++++------ doc/guides/contributing/patches.rst | 16 ++++++++-------- doc/guides/contributing/stable.rst | 8 ++++---- doc/guides/contributing/vulnerability.rst | 6 +++--- doc/guides/freebsd_gsg/install_from_ports.rst | 2 +- doc/guides/linux_gsg/nic_perf_intel_platform.rst | 2 +- doc/guides/nics/enic.rst | 2 +- doc/guides/prog_guide/cryptodev_lib.rst | 2 +- 9 files changed, 33 insertions(+), 25 deletions(-) diff --git a/devtools/checkpatches.sh b/devtools/checkpatches.sh index b16bace927..9902e2a9bc 100755 --- a/devtools/checkpatches.sh +++ b/devtools/checkpatches.sh @@ -70,6 +70,14 @@ check_forbidden_additions() { # -f $(dirname $(readlink -f $0))/check-forbidden-tokens.awk \ "$1" || res=1 + # links must prefer https over http + awk -v FOLDERS='doc' \ + -v EXPRESSIONS='http://.*dpdk.org' \ + -v RET_ON_FAIL=1 \ + -v MESSAGE='Using non https link to dpdk.org' \ + -f $(dirname $(readlink -f $0))/check-forbidden-tokens.awk \ + "$1" || res=1 + return $res } diff --git a/doc/guides/contributing/documentation.rst b/doc/guides/contributing/documentation.rst index 27e4b13be1..3924771cf0 100644 --- a/doc/guides/contributing/documentation.rst +++ b/doc/guides/contributing/documentation.rst @@ -82,7 +82,7 @@ added to by the developer. * **API documentation** The API documentation explains how to use the public DPDK functions. - The `API index page `_ shows the generated API documentation with related groups of functions. + The `API index page `_ shows the generated API documentation with related groups of functions. The API documentation should be updated via Doxygen comments when new functions are added. @@ -561,14 +561,14 @@ Hyperlinks ~~~~~~~~~~ * Links to external websites can be plain URLs. - The following is rendered as http://dpdk.org:: + The following is rendered as https://dpdk.org:: - http://dpdk.org + https://dpdk.org * They can contain alternative text. - The following is rendered as `Check out DPDK `_:: + The following is rendered as `Check out DPDK `_:: - `Check out DPDK `_ + `Check out DPDK `_ * An internal link can be generated by placing labels in the document with the format ``.. _label_name``. @@ -666,7 +666,7 @@ The following are some guidelines for use of Doxygen in the DPDK API documentati */ In the API documentation the functions will be rendered as links, see the - `online section of the rte_ethdev.h docs `_ that contains the above text. + `online section of the rte_ethdev.h docs `_ that contains the above text. * The ``@see`` keyword can be used to create a *see also* link to another file or library. This directive should be placed on one line at the bottom of the documentation section. diff --git a/doc/guides/contributing/patches.rst b/doc/guides/contributing/patches.rst index e5c565b984..5ca037757e 100644 --- a/doc/guides/contributing/patches.rst +++ b/doc/guides/contributing/patches.rst @@ -28,9 +28,9 @@ The DPDK development process has the following features: * All sub-repositories are merged into main repository for ``-rc1`` and ``-rc2`` versions of the release. * After the ``-rc2`` release all patches should target the main repository. -The mailing list for DPDK development is `dev@dpdk.org `_. -Contributors will need to `register for the mailing list `_ in order to submit patches. -It is also worth registering for the DPDK `Patchwork `_ +The mailing list for DPDK development is `dev@dpdk.org `_. +Contributors will need to `register for the mailing list `_ in order to submit patches. +It is also worth registering for the DPDK `Patchwork `_ If you are using the GitHub service, you can link your repository to the ``travis-ci.org`` build service. When you push patches to your GitHub @@ -130,12 +130,12 @@ The source code can be cloned using either of the following: main repository:: git clone git://dpdk.org/dpdk - git clone http://dpdk.org/git/dpdk + git clone https://dpdk.org/git/dpdk -sub-repositories (`list `_):: +sub-repositories (`list `_):: git clone git://dpdk.org/next/dpdk-next-* - git clone http://dpdk.org/git/next/dpdk-next-* + git clone https://dpdk.org/git/next/dpdk-next-* Make your Changes ----------------- @@ -320,7 +320,7 @@ Patch for Stable Releases ~~~~~~~~~~~~~~~~~~~~~~~~~ All fix patches to the master branch that are candidates for backporting -should also be CCed to the `stable@dpdk.org `_ +should also be CCed to the `stable@dpdk.org `_ mailing list. In the commit message body the Cc: stable@dpdk.org should be inserted as follows:: @@ -548,7 +548,7 @@ If the patch is in relation to a previous email thread you can add it to the sam git send-email --to dev@dpdk.org --in-reply-to <1234-foo@bar.com> 000*.patch The Message ID can be found in the raw text of emails or at the top of each Patchwork patch, -`for example `_. +`for example `_. Shallow threading (``--thread --no-chain-reply-to``) is preferred for a patch series. Once submitted your patches will appear on the mailing list and in Patchwork. diff --git a/doc/guides/contributing/stable.rst b/doc/guides/contributing/stable.rst index 4d38bb8606..021c762fc6 100644 --- a/doc/guides/contributing/stable.rst +++ b/doc/guides/contributing/stable.rst @@ -51,7 +51,7 @@ agreement and a commitment from a maintainer. The current policy is that each year's November (X.11) release will be maintained as an LTS for 2 years. After the X.11 release, an LTS branch will be created for it at -http://git.dpdk.org/dpdk-stable where bugfixes will be backported to. +https://git.dpdk.org/dpdk-stable where bugfixes will be backported to. A LTS release may align with the declaration of a new major ABI version, please read the :doc:`abi_policy` for more information. @@ -107,7 +107,7 @@ The Stable and LTS release are coordinated on the stable@dpdk.org mailing list. All fix patches to the master branch that are candidates for backporting -should also be CCed to the `stable@dpdk.org `_ +should also be CCed to the `stable@dpdk.org `_ mailing list. @@ -118,7 +118,7 @@ A Stable Release will be released by: * Tagging the release with YY.MM.n (year, month, number). * Uploading a tarball of the release to dpdk.org. -* Sending an announcement to the `announce@dpdk.org `_ +* Sending an announcement to the `announce@dpdk.org `_ list. -Stable releases are available on the `dpdk.org download page `_. +Stable releases are available on the `dpdk.org download page `_. diff --git a/doc/guides/contributing/vulnerability.rst b/doc/guides/contributing/vulnerability.rst index 5484119d19..da00acd4f0 100644 --- a/doc/guides/contributing/vulnerability.rst +++ b/doc/guides/contributing/vulnerability.rst @@ -36,11 +36,11 @@ Report Do not use Bugzilla (unsecured). Instead, send GPG-encrypted emails -to `security@dpdk.org `_. +to `security@dpdk.org `_. Anyone can post to this list. In order to reduce the disclosure of a vulnerability in the early stages, membership of this list is intentionally limited to a `small number of people -`_. +`_. It is additionally encouraged to GPG-sign one-on-one conversations as part of the security process. @@ -188,7 +188,7 @@ Downstream stakeholders are expected not to deploy or disclose patches until the embargo is passed, otherwise they will be removed from the list. Downstream stakeholders (in `security-prerelease list -`_), are: +`_), are: * Operating system vendors known to package DPDK * Major DPDK users, considered trustworthy by the technical board, who diff --git a/doc/guides/freebsd_gsg/install_from_ports.rst b/doc/guides/freebsd_gsg/install_from_ports.rst index 29f16cc6c5..dce028bc62 100644 --- a/doc/guides/freebsd_gsg/install_from_ports.rst +++ b/doc/guides/freebsd_gsg/install_from_ports.rst @@ -62,7 +62,7 @@ environmental variables should be set as below: .. note:: To install a copy of the DPDK compiled using gcc, please download the - official DPDK package from http://core.dpdk.org/download/ and install manually using + official DPDK package from https://core.dpdk.org/download/ and install manually using the instructions given in the next chapter, :ref:`building_from_source` An example application can therefore be copied to a user's home directory and diff --git a/doc/guides/linux_gsg/nic_perf_intel_platform.rst b/doc/guides/linux_gsg/nic_perf_intel_platform.rst index c554c2159c..1dabbce244 100644 --- a/doc/guides/linux_gsg/nic_perf_intel_platform.rst +++ b/doc/guides/linux_gsg/nic_perf_intel_platform.rst @@ -64,7 +64,7 @@ This aligns with the previous output which showed that each channel has one memo Network Interface Card Requirements ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Use a `DPDK supported `_ high end NIC such as the Intel XL710 40GbE. +Use a `DPDK supported `_ high end NIC such as the Intel XL710 40GbE. Make sure each NIC has been flashed the latest version of NVM/firmware. diff --git a/doc/guides/nics/enic.rst b/doc/guides/nics/enic.rst index 65e536d422..24d2b5713a 100644 --- a/doc/guides/nics/enic.rst +++ b/doc/guides/nics/enic.rst @@ -14,7 +14,7 @@ How to obtain ENIC PMD integrated DPDK -------------------------------------- ENIC PMD support is integrated into the DPDK suite. dpdk-.tar.gz -should be downloaded from http://core.dpdk.org/download/ +should be downloaded from https://core.dpdk.org/download/ Configuration information diff --git a/doc/guides/prog_guide/cryptodev_lib.rst b/doc/guides/prog_guide/cryptodev_lib.rst index ac16437740..c839379885 100644 --- a/doc/guides/prog_guide/cryptodev_lib.rst +++ b/doc/guides/prog_guide/cryptodev_lib.rst @@ -1097,4 +1097,4 @@ Asymmetric Crypto Device API ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The cryptodev Library API is described in the -`DPDK API Reference `_ +`DPDK API Reference `_ -- 2.20.1 --- Diff of the applied patch vs upstream commit (please double-check if non-empty: --- --- - 2020-05-27 10:23:32.282826964 +0100 +++ 0019-doc-prefer-https-when-pointing-to-dpdk.org.patch 2020-05-27 10:23:31.659934021 +0100 @@ -1,14 +1,14 @@ -From 3d4b2afb73f7f0988f8e66ba1b37f2a446e33868 Mon Sep 17 00:00:00 2001 +From 106dddaf877636331d25b24a0e7085c544e84ed2 Mon Sep 17 00:00:00 2001 From: David Marchand Date: Thu, 19 Mar 2020 09:28:59 +0100 Subject: [PATCH] doc: prefer https when pointing to dpdk.org +[ upstream commit 3d4b2afb73f7f0988f8e66ba1b37f2a446e33868 ] + for file in $(git grep -l http://.*dpdk.org doc/); do sed -i -e 's#http://\(.*dpdk.org\)#https://\1#g' $file; done -Cc: stable@dpdk.org - Signed-off-by: David Marchand Acked-by: Kevin Traynor --- @@ -21,14 +21,13 @@ doc/guides/linux_gsg/nic_perf_intel_platform.rst | 2 +- doc/guides/nics/enic.rst | 2 +- doc/guides/prog_guide/cryptodev_lib.rst | 2 +- - doc/guides/rel_notes/deprecation.rst | 2 +- - 10 files changed, 34 insertions(+), 26 deletions(-) + 9 files changed, 33 insertions(+), 25 deletions(-) diff --git a/devtools/checkpatches.sh b/devtools/checkpatches.sh -index 42b833e0d7..158087f1ca 100755 +index b16bace927..9902e2a9bc 100755 --- a/devtools/checkpatches.sh +++ b/devtools/checkpatches.sh -@@ -78,6 +78,14 @@ check_forbidden_additions() { # +@@ -70,6 +70,14 @@ check_forbidden_additions() { # -f $(dirname $(readlink -f $0))/check-forbidden-tokens.awk \ "$1" || res=1 @@ -44,7 +43,7 @@ } diff --git a/doc/guides/contributing/documentation.rst b/doc/guides/contributing/documentation.rst -index 550d8dec28..375ea64ba8 100644 +index 27e4b13be1..3924771cf0 100644 --- a/doc/guides/contributing/documentation.rst +++ b/doc/guides/contributing/documentation.rst @@ -82,7 +82,7 @@ added to by the developer. @@ -85,7 +84,7 @@ * The ``@see`` keyword can be used to create a *see also* link to another file or library. This directive should be placed on one line at the bottom of the documentation section. diff --git a/doc/guides/contributing/patches.rst b/doc/guides/contributing/patches.rst -index 01e0a2f6ba..16b40225f2 100644 +index e5c565b984..5ca037757e 100644 --- a/doc/guides/contributing/patches.rst +++ b/doc/guides/contributing/patches.rst @@ -28,9 +28,9 @@ The DPDK development process has the following features: @@ -126,7 +125,7 @@ mailing list. In the commit message body the Cc: stable@dpdk.org should be inserted as follows:: -@@ -565,7 +565,7 @@ If the patch is in relation to a previous email thread you can add it to the sam +@@ -548,7 +548,7 @@ If the patch is in relation to a previous email thread you can add it to the sam git send-email --to dev@dpdk.org --in-reply-to <1234-foo@bar.com> 000*.patch The Message ID can be found in the raw text of emails or at the top of each Patchwork patch, @@ -136,7 +135,7 @@ Once submitted your patches will appear on the mailing list and in Patchwork. diff --git a/doc/guides/contributing/stable.rst b/doc/guides/contributing/stable.rst -index 626cebf655..890bbeccc3 100644 +index 4d38bb8606..021c762fc6 100644 --- a/doc/guides/contributing/stable.rst +++ b/doc/guides/contributing/stable.rst @@ -51,7 +51,7 @@ agreement and a commitment from a maintainer. The current policy is that each @@ -148,7 +147,7 @@ A LTS release may align with the declaration of a new major ABI version, please read the :doc:`abi_policy` for more information. -@@ -108,7 +108,7 @@ The Stable and LTS release are coordinated on the stable@dpdk.org mailing +@@ -107,7 +107,7 @@ The Stable and LTS release are coordinated on the stable@dpdk.org mailing list. All fix patches to the master branch that are candidates for backporting @@ -157,7 +156,7 @@ mailing list. -@@ -119,7 +119,7 @@ A Stable Release will be released by: +@@ -118,7 +118,7 @@ A Stable Release will be released by: * Tagging the release with YY.MM.n (year, month, number). * Uploading a tarball of the release to dpdk.org. @@ -195,10 +194,10 @@ * Operating system vendors known to package DPDK * Major DPDK users, considered trustworthy by the technical board, who diff --git a/doc/guides/freebsd_gsg/install_from_ports.rst b/doc/guides/freebsd_gsg/install_from_ports.rst -index 36dc4a417b..d946f3f3b2 100644 +index 29f16cc6c5..dce028bc62 100644 --- a/doc/guides/freebsd_gsg/install_from_ports.rst +++ b/doc/guides/freebsd_gsg/install_from_ports.rst -@@ -72,7 +72,7 @@ These examples can be compiled and run as described in :ref:`compiling_sample_ap +@@ -62,7 +62,7 @@ environmental variables should be set as below: .. note:: To install a copy of the DPDK compiled using gcc, please download the @@ -221,7 +220,7 @@ Make sure each NIC has been flashed the latest version of NVM/firmware. diff --git a/doc/guides/nics/enic.rst b/doc/guides/nics/enic.rst -index aa4fdc0e39..a28a7f4e47 100644 +index 65e536d422..24d2b5713a 100644 --- a/doc/guides/nics/enic.rst +++ b/doc/guides/nics/enic.rst @@ -14,7 +14,7 @@ How to obtain ENIC PMD integrated DPDK @@ -234,28 +233,15 @@ Configuration information diff --git a/doc/guides/prog_guide/cryptodev_lib.rst b/doc/guides/prog_guide/cryptodev_lib.rst -index b91f7c8b7f..c14f750fa8 100644 +index ac16437740..c839379885 100644 --- a/doc/guides/prog_guide/cryptodev_lib.rst +++ b/doc/guides/prog_guide/cryptodev_lib.rst -@@ -1128,4 +1128,4 @@ Asymmetric Crypto Device API +@@ -1097,4 +1097,4 @@ Asymmetric Crypto Device API ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The cryptodev Library API is described in the -`DPDK API Reference `_ +`DPDK API Reference `_ -diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst -index cf8b1eb7b0..e8fd441696 100644 ---- a/doc/guides/rel_notes/deprecation.rst -+++ b/doc/guides/rel_notes/deprecation.rst -@@ -43,7 +43,7 @@ Deprecation Notices - kernel module to the dpdk-kmods repository in the /linux/igb_uio/ directory - in 20.11. - Minutes of Technical Board Meeting of `2019-11-06 -- `_. -+ `_. - - * lib: will fix extending some enum/define breaking the ABI. There are multiple - samples in DPDK that enum/define terminated with a ``.*MAX.*`` value which is -- 2.20.1