Clarify or remove -t option in container run example in docs

[pr0way]

In the running a container example, the -t (pseudo-TTY) option is included when running a simple httpd server, which does not actually require an interactive terminal. This may confuse beginners who see the option but do not understand its necessity.

For better clarity and to improve the documentation for new users, I propose one of the following:

• Remove the -t option from this example, as it is not required for running httpd in detached mode.
• Extend the documentation with an additional example demonstrating interactive shell usage where -i and -t are explained.
• Add a note clarifying that -t is optional for non-interactive services like httpd and can be omitted.

What do you think about this change? I believe this will improve comprehension for beginners using Podman.

[eriksjolund]

Add a note clarifying that -t is optional for non-interactive services like httpd and can be omitted.

edit: I'm not sure my comment is relevant to this issue so I add strikethrough to the text.

side note: -t could lead to unexpected characters. For details, see
troubleshooting tip:

38) Unexpected carriage returns are outputted on the terminal

quote: The --tty (-t) flag should only be used when the program requires user interaction in the termainal, for instance expecting the user to type an answer to a question.

[eriksjolund]

Here is another example that combines -d and -t

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

Line 614 in 90a03ca

$ podman run -p 8080:80 -d -i -t fedora/httpd

Some more investigation:

% git grep -r "podman run" docs| grep -- -dt
docs/tutorials/basic_networking.md:(rootful) $ sudo podman run -dt --name webserver -p 8080:80 quay.io/libpod/banner
docs/tutorials/basic_networking.md:$ podman run -dt --name webserver --network podman1 -p 8081:80 quay.io/libpod/banner
docs/tutorials/basic_networking.md:$ sudo podman run -dt --name webserver --network webnetwork quay.io/libpod/banner
docs/tutorials/basic_networking.md:$ podman run -dt --name webserver -p 8080:80 quay.io/libpod/banner
docs/tutorials/podman_tutorial.md:podman run --name basic_httpd -dt -p 8080:80/tcp docker.io/nginx
docs/tutorials/podman_tutorial_cn.md:podman run --name basic_httpd -dt -p 8080:80/tcp docker.io/nginx

[Luap99]

I agree we should not be using -t unless there is actually a reason for it like an interactive terminal. For these background services there is no reason to have them be attached to a tty. Often it will just mess up the logs as they will also capture the control characters.

Note the website for podman.io is here: https://github.com/containers/podman.io