diff --git a/docs/source/markdown/options/attach.md b/docs/source/markdown/options/attach.md
new file mode 100644
index 0000000000..028a956ac2
--- /dev/null
+++ b/docs/source/markdown/options/attach.md
@@ -0,0 +1,10 @@
+#### **--attach**, **-a**=*stdin* | *stdout* | *stderr*
+
+Attach to STDIN, STDOUT or STDERR.
+
+In foreground mode (the default when **-d**
+is not specified), **podman run** can start the process in the container
+and attach the console to the process's standard input, output, and
+error. It can even pretend to be a TTY (this is what most command-line
+executables expect) and pass along signals. The **-a** option can be set for
+each of **stdin**, **stdout**, and **stderr**.
diff --git a/docs/source/markdown/podman-create.1.md.in b/docs/source/markdown/podman-create.1.md.in
index b7f621866f..4460e8b281 100644
--- a/docs/source/markdown/podman-create.1.md.in
+++ b/docs/source/markdown/podman-create.1.md.in
@@ -72,16 +72,7 @@ and specified with a _tag_.
 
 @@option arch
 
-#### **--attach**, **-a**=*location*
-
-Attach to STDIN, STDOUT or STDERR.
-
-In foreground mode (the default when **-d**
-is not specified), **podman run** can start the process in the container
-and attach the console to the process's standard input, output, and standard
-error. It can even pretend to be a TTY (this is what most command line
-executables expect) and pass along signals. The **-a** option can be set for
-each of stdin, stdout, and stderr.
+@@option attach
 
 @@option authfile
 
diff --git a/docs/source/markdown/podman-run.1.md.in b/docs/source/markdown/podman-run.1.md.in
index d596ee9029..2155c84257 100644
--- a/docs/source/markdown/podman-run.1.md.in
+++ b/docs/source/markdown/podman-run.1.md.in
@@ -89,16 +89,7 @@ and specified with a _tag_.
 
 @@option arch
 
-#### **--attach**, **-a**=*stdin* | *stdout* | *stderr*
-
-Attach to STDIN, STDOUT or STDERR.
-
-In foreground mode (the default when **-d**
-is not specified), **podman run** can start the process in the container
-and attach the console to the process's standard input, output, and
-error. It can even pretend to be a TTY (this is what most commandline
-executables expect) and pass along signals. The **-a** option can be set for
-each of **stdin**, **stdout**, and **stderr**.
+@@option attach
 
 @@option authfile