From dceaa7603f0b4ade886dcf5bf00262abd4329780 Mon Sep 17 00:00:00 2001 From: Paul Holzinger Date: Fri, 11 Nov 2022 17:45:33 +0100 Subject: [PATCH] docs: deprecate pasta network name Since pasta is now considered a network mode using it as network name causes a conflict. For now we will prefer the named network but in a future major version bump we want to remove this and just use pasta(1). The docs should reflect that this name is considered deprecated. Signed-off-by: Paul Holzinger --- docs/source/markdown/options/network.md | 3 +++ docs/source/markdown/podman-network-create.1.md | 3 +++ 2 files changed, 6 insertions(+) diff --git a/docs/source/markdown/options/network.md b/docs/source/markdown/options/network.md index f2eec7a28b..faad284a4e 100644 --- a/docs/source/markdown/options/network.md +++ b/docs/source/markdown/options/network.md @@ -74,3 +74,6 @@ Valid _mode_ values are: - **pasta:-T,5201**: enable forwarding of TCP port 5201 from container to host, using the loopback interface instead of the tap interface for improved performance + + NOTE: For backward compatibility reasons, if you have a network named `pasta`, + Podman will use this instead of the pasta mode. diff --git a/docs/source/markdown/podman-network-create.1.md b/docs/source/markdown/podman-network-create.1.md index 6fd31dd4d1..4dc47db35c 100644 --- a/docs/source/markdown/podman-network-create.1.md +++ b/docs/source/markdown/podman-network-create.1.md @@ -15,6 +15,9 @@ If no options are provided, Podman will assign a free subnet and name for your n Upon completion of creating the network, Podman will display the name of the newly added network. +NOTE: The support for the network name pasta is deprecated and will be removed in the next major +release because it is used as a special network mode in **podman run/create --network**. + ## OPTIONS #### **--disable-dns**