mirror of https://github.com/containers/podman.git
4334135491
Very belated successor to #14046. I don't know why this is so important to me. Probably because we're doing a halfhearted sloppy job of documenting, and new options get added, and not documented, and that's just wrong. I've given up on documenting internal structs. This iteration has a $Format_Exceptions table defined at the top of the xref script, enumerating a hardcoded defined set of podman commands and fields that should remain undocumented. This iteration also forgives completely-undocumented formats. If podman-foo has a --format, but podman-foo.1.md does not list *any* valid fields, the script warns but does not fail. This at least is better than documenting a random mix of fields. This version of the xref script is much slower: 10s vs 4. I think we can live with that in a CI-only script. Signed-off-by: Ed Santiago <santiago@redhat.com> |
||
|---|---|---|
| .. | ||
| perf | ||
| podman-registry-go | ||
| apparmor_tag.sh | ||
| bats | ||
| branch_commits.rb | ||
| btrfs_installed_tag.sh | ||
| btrfs_tag.sh | ||
| buildah-vendor-treadmill | ||
| check_root.sh | ||
| get_ci_vm.sh | ||
| golangci-lint.sh | ||
| install_catatonit.sh | ||
| install_golangci.sh | ||
| install_swagger.sh | ||
| libdm_tag.sh | ||
| libsubid_tag.sh | ||
| make-and-check-size | ||
| man-page-checker | ||
| markdown-preprocess | ||
| markdown-preprocess-review | ||
| markdown-preprocess.t | ||
| parse-localbenchmarks | ||
| podman-commands.sh | ||
| podman-registry | ||
| podman-socat | ||
| podmansnoop | ||
| podmanv2-retry | ||
| release.sh | ||
| selinux_tag.sh | ||
| swagger-check | ||
| systemd_tag.sh | ||
| tree_status.sh | ||
| xref-docker-options | ||
| xref-helpmsgs-manpages | ||