Merge pull request #15331 from edsantiago/docs_dedup_piecemeal

Man pages: refactor common options: arch

docs/source/markdown/options/README.md

@@ -42,3 +42,5 @@ This allows the shared use of examples in the option file:
 ```
     Example: podman <<subcommand>> --foo --bar
 ```
+As a special case, `podman-pod-X` becomes just `X` (the "pod" is removed).
+This makes the `pod-id-file` man page more useful.

docs/source/markdown/options/arch.md

@@ -0,0 +1,2 @@
+#### **--arch**=*ARCH*
+Override the architecture, defaults to hosts, of the image to be pulled. For example, `arm`.

docs/source/markdown/podman-create.1.md.in

@@ -73,8 +73,7 @@ and specified with a _tag_.
 Add an annotation to the container. The format is key=value.
 The **--annotation** option can be set multiple times.
 
-#### **--arch**=*ARCH*
-Override the architecture, defaults to hosts, of the image to be pulled. For example, `arm`.
+@@option arch
 
 #### **--attach**, **-a**=*location*
 

docs/source/markdown/podman-pull.1.md.in

@@ -49,8 +49,7 @@ All tagged images in the repository will be pulled.
 
 *IMPORTANT: When using the all-tags flag, Podman will not iterate over the search registries in the **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)** but will always use docker.io for unqualified image names.*
 
-#### **--arch**=*ARCH*
-Override the architecture, defaults to hosts, of the image to be pulled. For example, `arm`.
+@@option arch
 
 #### **--authfile**=*path*
 

docs/source/markdown/podman-run.1.md.in

@@ -90,8 +90,7 @@ and specified with a _tag_.
 Add an annotation to the container.
 This option can be set multiple times.
 
-#### **--arch**=*ARCH*
-Override the architecture, defaults to hosts, of the image to be pulled. For example, `arm`.
+@@option arch
 
 #### **--attach**, **-a**=*stdin* | *stdout* | *stderr*