From: Bruce Richardson <bruce.richardson@intel.com>
To: Robin Jarry <robin.jarry@6wind.com>
Cc: Kevin Laatz <kevin.laatz@intel.com>,
Maxime Coquelin <maxime.coquelin@redhat.com>,
Chenbo Xia <chenbo.xia@intel.com>,
Zhihong Wang <zhihong.wang@intel.com>,
Ray Kinsella <mdr@ashroe.eu>, Neil Horman <nhorman@tuxdriver.com>,
Nicolas Chautru <nicolas.chautru@intel.com>,
dev@dpdk.org, David Marchand <david.marchand@redhat.com>
Subject: Re: [dpdk-dev] [PATCH] doc: remove references to python 2
Date: Fri, 2 Oct 2020 16:52:37 +0100 [thread overview]
Message-ID: <20201002155237.GC1325@bricha3-MOBL.ger.corp.intel.com> (raw)
In-Reply-To: <20201002154753.1015-1-robin.jarry@6wind.com>
On Fri, Oct 02, 2020 at 05:47:53PM +0200, Robin Jarry wrote:
> Python 2 support has now been dropped. Remove references to it in the
> documentation.
>
> Since all python scripts now have a proper shebang that calls python3,
> execute the scripts directly without specifying the interpreter.
>
> Sphinx version from most Linux distros is OK in 2020, do not encourage
> people to break their system by installing with pip. Use the distros
> official packages.
>
> Signed-off-by: Robin Jarry <robin.jarry@6wind.com>
> ---
> doc/guides/conf.py | 2 +-
> doc/guides/contributing/documentation.rst | 8 ++------
> doc/guides/howto/telemetry.rst | 2 +-
> doc/guides/nics/virtio.rst | 4 ++--
> doc/guides/rel_notes/deprecation.rst | 4 ++--
> doc/guides/tools/testbbdev.rst | 2 +-
> 6 files changed, 9 insertions(+), 13 deletions(-)
>
> diff --git a/doc/guides/conf.py b/doc/guides/conf.py
> index ef550f68c056..270754b90131 100644
> --- a/doc/guides/conf.py
> +++ b/doc/guides/conf.py
> @@ -22,7 +22,7 @@
> html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
> except:
> print('Install the sphinx ReadTheDocs theme for improved html documentation '
> - 'layout: pip install sphinx_rtd_theme')
> + 'layout: https://sphinx-rtd-theme.readthedocs.io/')
> pass
>
> project = 'Data Plane Development Kit'
> diff --git a/doc/guides/contributing/documentation.rst b/doc/guides/contributing/documentation.rst
> index 375ea64ba8ee..be985e6cf87a 100644
> --- a/doc/guides/contributing/documentation.rst
> +++ b/doc/guides/contributing/documentation.rst
> @@ -164,14 +164,10 @@ For full support with figure and table captioning the latest version of Sphinx c
> .. code-block:: console
>
> # Ubuntu/Debian.
> - sudo apt-get -y install python-pip
> - sudo pip install --upgrade sphinx
> - sudo pip install --upgrade sphinx_rtd_theme
> + sudo apt-get -y install python3-sphinx python3-sphinx-rtd-theme
>
> # Red Hat/Fedora.
> - sudo dnf -y install python-pip
> - sudo pip install --upgrade sphinx
> - sudo pip install --upgrade sphinx_rtd_theme
> + sudo dnf -y install python3-sphinx python3-sphinx_rtd_theme
Minor nit, I see no reason to preserve the big whitespace gap here.
>
> For further information on getting started with Sphinx see the
> `Sphinx Getting Started <http://www.sphinx-doc.org/en/master/usage/quickstart.html>`_.
> diff --git a/doc/guides/howto/telemetry.rst b/doc/guides/howto/telemetry.rst
> index e7b5434152de..cf73dc41ce6b 100644
> --- a/doc/guides/howto/telemetry.rst
> +++ b/doc/guides/howto/telemetry.rst
> @@ -50,7 +50,7 @@ and query information using the telemetry client python script.
>
> #. Launch the telemetry client script::
>
> - python usertools/dpdk-telemetry.py
> + ./usertools/dpdk-telemetry.py
>
> #. When connected, the script displays the following, waiting for user input::
>
> diff --git a/doc/guides/nics/virtio.rst b/doc/guides/nics/virtio.rst
> index 33ce0c247e5f..4477c1c16088 100644
> --- a/doc/guides/nics/virtio.rst
> +++ b/doc/guides/nics/virtio.rst
> @@ -154,7 +154,7 @@ Host2VM communication example
> modprobe uio
> echo 512 > /sys/devices/system/node/node0/hugepages/hugepages-2048kB/nr_hugepages
> modprobe uio_pci_generic
> - python usertools/dpdk-devbind.py -b uio_pci_generic 00:03.0
> + ./usertools/dpdk-devbind.py -b uio_pci_generic 00:03.0
>
> We use testpmd as the forwarding application in this example.
>
> @@ -329,7 +329,7 @@ To support Rx interrupts,
>
> .. code-block:: console
>
> - python usertools/dpdk-devbind.py -b vfio-pci 00:03.0
> + ./usertools/dpdk-devbind.py -b vfio-pci 00:03.0
>
> Example
> ~~~~~~~
> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> index 0be208edcad8..8080a28896ad 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -14,8 +14,8 @@ Deprecation Notices
> * meson: The minimum supported version of meson for configuring and building
> DPDK will be increased to v0.47.1 (from 0.41) from DPDK 19.05 onwards. For
> those users with a version earlier than 0.47.1, an updated copy of meson
> - can be got using the ``pip``, or ``pip3``, tool for downloading python
> - packages.
> + can be got using the ``pip3`` tool (or ``python3 -m pip``) for downloading
> + python packages.
>
> * kvargs: The function ``rte_kvargs_process`` will get a new parameter
> for returning key match count. It will ease handling of no-match case.
> diff --git a/doc/guides/tools/testbbdev.rst b/doc/guides/tools/testbbdev.rst
> index 393c3e9d0d24..99692314513f 100644
> --- a/doc/guides/tools/testbbdev.rst
> +++ b/doc/guides/tools/testbbdev.rst
> @@ -43,7 +43,7 @@ The tool application has a number of command line options:
>
> .. code-block:: console
>
> - python test-bbdev.py [-h] [-p TESTAPP_PATH] [-e EAL_PARAMS] [-t TIMEOUT]
> + test-bbdev.py [-h] [-p TESTAPP_PATH] [-e EAL_PARAMS] [-t TIMEOUT]
> [-c TEST_CASE [TEST_CASE ...]]
> [-v TEST_VECTOR [TEST_VECTOR...]] [-n NUM_OPS]
> [-b BURST_SIZE [BURST_SIZE ...]] [-l NUM_LCORES]
> --
> 2.28.0
>
Acked-by: Bruce Richardson <bruce.richardson@intel.com>
next prev parent reply other threads:[~2020-10-02 15:52 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-10-02 15:47 Robin Jarry
2020-10-02 15:52 ` Bruce Richardson [this message]
2020-10-02 15:55 ` Robin Jarry
2020-10-02 16:05 ` Bruce Richardson
2020-10-02 16:04 ` Kevin Laatz
2020-10-05 8:23 ` David Marchand
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20201002155237.GC1325@bricha3-MOBL.ger.corp.intel.com \
--to=bruce.richardson@intel.com \
--cc=chenbo.xia@intel.com \
--cc=david.marchand@redhat.com \
--cc=dev@dpdk.org \
--cc=kevin.laatz@intel.com \
--cc=maxime.coquelin@redhat.com \
--cc=mdr@ashroe.eu \
--cc=nhorman@tuxdriver.com \
--cc=nicolas.chautru@intel.com \
--cc=robin.jarry@6wind.com \
--cc=zhihong.wang@intel.com \
/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.
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 NNTP newsgroup(s).