From a584bb4e740a92d91c156d6bae4120938675179a Mon Sep 17 00:00:00 2001 From: Ed Santiago Date: Wed, 12 Oct 2022 14:50:29 -0600 Subject: [PATCH] Man pages: refactor common options: --attach Only between podman-create and -run; podman-start was too different. (But please look into it, maybe there's a way to reconcile the diffs). Very minor formatting changes made to reconcile the two. Easy to review using hack/markdown-preprocess-review Signed-off-by: Ed Santiago --- docs/source/markdown/options/attach.md | 10 ++++++++++ docs/source/markdown/podman-create.1.md.in | 11 +---------- docs/source/markdown/podman-run.1.md.in | 11 +---------- 3 files changed, 12 insertions(+), 20 deletions(-) create mode 100644 docs/source/markdown/options/attach.md 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