This commit does the following: - Splits the podman-systemd.unit.5.md into multiple files - one for each quadlet file type. - Adds the podman-quadlet-basic-usage.7.md for quadlet examples. - Majority of the text in the new files is copied from the podman-systemd.unit.5.md - Adds support for very simple condditional in the markdown_preprocess. - Uses new logic in markdown_preprocess in options/*.md to use a single .md file for both podman subcommands man-pages and quadlet man-pages. This deduplicates the Quadlet man-pages a lot. - Adds new `@@option quadlet:source.md`` preprocess command to import such .md files from options directory. Signed-off-by: Jan Kaluza <jkaluza@redhat.com>
1.2 KiB
####> This option file is used in: ####> podman build, podman-build.unit.5.md.in, farm build ####> If file is edited, make sure the changes ####> are applicable to all of those. << if is_quadlet >>
File=Containerfile
<< else >>
--file, -f=Containerfile
<< endif >>
Specifies a Containerfile which contains instructions for building the image, either a local file or an http or https URL. If more than one Containerfile is specified, FROM instructions are only accepted from the last specified file.
<< if is_quadlet >>
Note that for a given relative path to a Containerfile, or when using a http(s):// URL, also set
SetWorkingDirectory= in order for podman build to find a valid context directory for the
resources specified in the Containerfile.
Note that setting a File= field is mandatory for a .build file, unless SetWorkingDirectory (or
a WorkingDirectory in the Service group) has also been set.
<< else >>
If a build context is not specified, and at least one Containerfile is a
local file, the directory in which it resides is used as the build
context.
<< endif >>
Specifying the option << 'File=-' if is_quadlet else '-f -' >> causes
the Containerfile contents to be read from stdin.