podman/hack
Ed Santiago d7f134d687 Refactor common man page options, phase 2
Followup to #15174. These are the options that are easy(ish)
to review: those that have only drifted slightly, and need
only minor tweaks to bring back to sanity. For the most part,
I went with the text in podman-run because that was cleaned up
in #5192 way back in 2020. These diffs primarily consist of
using '**' (star star) instead of backticks, plus other
formatting and punctuation changes.

This PR also adds a README in the options dir, and a new
convention: <<container text...|pod text...>> which tries
to do the right thing based on whether the man page name
includes "-pod-" or not. Since that's kind of hairy code,
I've also added a test suite for it.

Finally, since this is impossible to review by normal means,
I'm temporarily committing hack/markdown-preprocess-review,
a script that will diff option-by-option. I will remove it
once we finish this cleanup, but be advised that there are
still 130+ options left to examine, and some of those are
going to be really hard to reunite.

Review script usage: simply run it (you need to have 'diffuse'
installed). It isn't exactly obvious, but it shouldn't take more
than a minute to figure out. The rightmost column (zzz-chosen.md)
is the "winner", the actual content that will be used henceforth.
You really want an ultrawide screen here.

Signed-off-by: Ed Santiago <santiago@redhat.com>
2022-08-09 06:33:17 -06:00
..
podman-registry-go hack/test/utils: switch to golang native error wrapping 2022-07-05 12:13:33 +02:00
apparmor_tag.sh Use `bash` binary from env instead of /bin/bash for scripts 2020-08-17 10:42:23 +02:00
bats hack/bats: fix broken usage message 2022-02-02 11:26:22 -07:00
branch_commits.rb Add script for identifying commits in release branches 2021-05-17 16:40:35 -04:00
btrfs_installed_tag.sh Use CPP, CC and flags in dep check scripts 2020-11-06 10:44:27 +01:00
btrfs_tag.sh Use CPP, CC and flags in dep check scripts 2020-11-06 10:44:27 +01:00
buildah-vendor-treadmill [CI:DOCS] Treadmill script: add --reset option 2022-05-12 13:14:04 -06:00
check_root.sh Use `bash` binary from env instead of /bin/bash for scripts 2020-08-17 10:42:23 +02:00
get_ci_vm.sh Cirrus: Support EC2 instances in hack/get_ci_vm.sh 2022-08-03 14:25:09 -04:00
golangci-lint.sh enable linter for pkg/machine/e2e 2022-07-21 18:04:10 +02:00
install_catatonit.sh cirrus: force-install catatonit 2021-11-15 12:53:25 +01:00
install_golangci.sh golangci install: explicitly set BINDIR 2022-07-05 15:59:32 -06:00
libdm_tag.sh Use CPP, CC and flags in dep check scripts 2020-11-06 10:44:27 +01:00
libsubid_tag.sh build: fix test for subid 4 2021-12-20 10:09:34 +01:00
make-and-check-size Fix size-check to display more context 2022-04-21 14:07:20 -04:00
man-page-checker Switch use of Flags to Options 2020-10-21 08:37:57 -04:00
markdown-preprocess Refactor common man page options, phase 2 2022-08-09 06:33:17 -06:00
markdown-preprocess-review Refactor common man page options, phase 2 2022-08-09 06:33:17 -06:00
markdown-preprocess.t Refactor common man page options, phase 2 2022-08-09 06:33:17 -06:00
parse-localbenchmarks [CI:DOCS] Benchmarks: new tool for parsing results 2022-05-11 11:44:17 -06:00
podman-commands.sh Add shell completion with cobra 2020-11-12 11:38:31 +01:00
podman-registry Update the registry server we test against from 2.6 to 2.8 2022-07-30 17:24:31 +02:00
podman-socat rename --cni-config-dir to --network-config-dir 2022-01-18 19:28:25 +01:00
podmanv2-retry Use `bash` binary from env instead of /bin/bash for scripts 2020-08-17 10:42:23 +02:00
release.sh Remove changelog.txt from the repository 2021-09-07 10:53:26 -04:00
selinux_tag.sh Use `bash` binary from env instead of /bin/bash for scripts 2020-08-17 10:42:23 +02:00
swagger-check switch from "kube/play" endpoint to "play/kube" endpoint. 2022-08-02 12:09:59 +01:00
systemd_tag.sh Use CPP, CC and flags in dep check scripts 2020-11-06 10:44:27 +01:00
tree_status.sh Use `bash` binary from env instead of /bin/bash for scripts 2020-08-17 10:42:23 +02:00
xref-helpmsgs-manpages man page checker: enforce stricter options format 2022-07-14 06:35:51 -06:00