Skip to content

docs: remove hardcoded config paths in favor of man page references (#29187) - #29540

Open
hihry wants to merge 3 commits into
podman-container-tools:mainfrom
hihry:fix/updateDocs
Open

docs: remove hardcoded config paths in favor of man page references (#29187)#29540
hihry wants to merge 3 commits into
podman-container-tools:mainfrom
hihry:fix/updateDocs

Conversation

@hihry

@hihry hihry commented Aug 16, 2026

Copy link
Copy Markdown

Overview

Fixes #29187 by updating outdated configuration file documentation in the Podman man pages.

Instead of hardorcoding specific directory paths (which can quickly become outdated as configuration parsing rules change or expand), this update removes the hardcoded paths from the headings and text, pointing users directly to their respective manual pages for the complete source of truth.

Changes Made

  1. docs/source/markdown/podman.1.md:

    • Removed hardcoded path lists from the headings of containers.conf, mounts.conf, policy.json, registries.conf, and storage.conf.
    • Updated the body text to direct users to their corresponding man pages (e.g., containers.conf(5), containers-mounts.conf(5), etc.) for full override and path resolution details.
  2. docs/source/markdown/podman-image-trust.1.md.in:

    • Updated the DESCRIPTION section to stop assuming /etc/containers/policy.json is the sole policy location.
    • Replaced it with a general reference to policy.json and a link to containers-policy.json(5) for exact system and user path handling.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs not fully updated for new config file parsing

1 participant