mirror of
https://github.com/podman-container-tools/podman.git
synced 2026-09-21 07:07:50 +00:00
357eff7235
This proposes a more comprehensible man page. A number of things have been lost in translation and this should be reviewed: - the former docs from --userns say that it is disabled by default. I suppose that this is the same as --userns:host, but this should be confirmed. It also stated that is would use options like pid=host, which confuses me as pid namespaces are a totally different thing from user namespaces. It also mentions the enabling of --privileged. I think the difference between using --userns:host and not using any user namespace options at all is not clear and maybe not very logical. Also what would be the difference between using --userns:host and using --priveleged alone? - I found the syntax for --gidmap at the bottom of the man page in the examples. In the example it doesn't use '=', eg. podman run `--gidmap 0:30000:2000`. For consistency with the other options I have used '=' for now, but if it is optional, I would remove it everywhere, as less tokens is usually improved readability. For now the inconsistency remains between the options doc and the examples section. - It wasn't very clear to me whether one should hard wrap long lines or not as the contains a mix. - I haven't for now looked at user namespace options on other commands, but that should be done surely before merging. - I didn't know which command to run to generate the groff, so that needs doing still. from issue #1374 Signed-off-by: Naja Melan <najamelan@autistici.org> Signed-off-by: Naja Melan <najamelan@autistici.org> Closes: #1380 Approved by: rhatdan |
||
|---|---|---|
| .. | ||
| links | ||
| tutorials | ||
| varlink | ||
| containers-mounts.conf.5.md | ||
| dckrman.sh | ||
| generate.go | ||
| libpod.conf.5.md | ||
| play.png | ||
| podman-attach.1.md | ||
| podman-build.1.md | ||
| podman-commit.1.md | ||
| podman-container-cleanup.1.md | ||
| podman-container-refresh.1.md | ||
| podman-container.1.md | ||
| podman-cp.1.md | ||
| podman-create.1.md | ||
| podman-diff.1.md | ||
| podman-exec.1.md | ||
| podman-export.1.md | ||
| podman-history.1.md | ||
| podman-image.1.md | ||
| podman-images.1.md | ||
| podman-import.1.md | ||
| podman-info.1.md | ||
| podman-inspect.1.md | ||
| podman-kill.1.md | ||
| podman-load.1.md | ||
| podman-login.1.md | ||
| podman-logout.1.md | ||
| podman-logs.1.md | ||
| podman-mount.1.md | ||
| podman-pause.1.md | ||
| podman-pod-create.1.md | ||
| podman-pod-inspect.1.md | ||
| podman-pod-kill.1.md | ||
| podman-pod-pause.1.md | ||
| podman-pod-ps.1.md | ||
| podman-pod-restart.1.md | ||
| podman-pod-rm.1.md | ||
| podman-pod-start.1.md | ||
| podman-pod-stop.1.md | ||
| podman-pod-top.1.md | ||
| podman-pod-unpause.1.md | ||
| podman-pod.1.md | ||
| podman-port.1.md | ||
| podman-ps.1.md | ||
| podman-pull.1.md | ||
| podman-push.1.md | ||
| podman-restart.1.md | ||
| podman-rm.1.md | ||
| podman-rmi.1.md | ||
| podman-run.1.md | ||
| podman-save.1.md | ||
| podman-search.1.md | ||
| podman-start.1.md | ||
| podman-stats.1.md | ||
| podman-stop.1.md | ||
| podman-tag.1.md | ||
| podman-top.1.md | ||
| podman-umount.1.md | ||
| podman-unpause.1.md | ||
| podman-varlink.1.md | ||
| podman-version.1.md | ||
| podman-wait.1.md | ||
| podman.1.md | ||
