mirror of https://github.com/containers/podman.git
Merge pull request #26370 from mheon/manpage_fixes
Bunch of trivial manpage fixes
This commit is contained in:
commit
c94f5fd318
|
@ -25,7 +25,7 @@ Alter the output into a different format. The only valid format for **podman con
|
|||
|
||||
@@option latest
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
```
|
||||
# podman container diff container1
|
||||
|
|
|
@ -76,7 +76,7 @@ Valid placeholders for the Go template are listed below:
|
|||
In addition to normal output, display the total file size if the type is a container.
|
||||
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Inspect the specified container and print its information in json format.
|
||||
```
|
||||
|
|
|
@ -159,7 +159,7 @@ option is ignored. Defaults to not restoring *containers* with established TCP
|
|||
connections.\
|
||||
The default is **false**.
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
Restore the container "mywebserver".
|
||||
```
|
||||
# podman container restore mywebserver
|
||||
|
|
|
@ -25,7 +25,7 @@ Alter the output into a different format. The only valid format for **podman di
|
|||
|
||||
@@option latest
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Show container-modified files versus the container's image:
|
||||
```
|
||||
|
|
|
@ -13,16 +13,14 @@ Create a new farm with connections that Podman knows about which were added via
|
|||
An empty farm can be created without adding any connections to it. Add or remove
|
||||
connections from a farm via the *podman farm update* command.
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
|
||||
|
||||
Create the specified farm:
|
||||
Create the specified farm with no connections:
|
||||
```
|
||||
$ podman farm create farm2
|
||||
```
|
||||
|
||||
Create multiple farms:
|
||||
Create a farm with connections:
|
||||
```
|
||||
$ podman farm create farm1 f37 f38
|
||||
```
|
||||
|
|
|
@ -23,7 +23,7 @@ The output is prefixed with the following symbols:
|
|||
|
||||
Alter the output into a different format. The only valid format for **podman image diff** is `json`.
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Display image differences from images parent layer:
|
||||
```
|
||||
|
|
|
@ -30,7 +30,7 @@ Mount all images.
|
|||
|
||||
Print the mounted images in specified format (json).
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Mount multiple images. Note: In rootless mode, image mounting works only after executing the podman unshare command to enter the user namespace.
|
||||
```
|
||||
|
|
|
@ -119,7 +119,7 @@ Lists only the image IDs.
|
|||
Sort by *created*, *id*, *repository*, *size* or *tag* (default: **created**)
|
||||
When sorting by *repository* it also sorts by the *tag* as second criteria to provide a stable output.
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
List all non-dangling images in local storage:
|
||||
```
|
||||
|
|
|
@ -38,7 +38,7 @@ In addition to normal output, display the total file size if the type is a conta
|
|||
Return JSON for the specified type. Type can be 'container', 'image', 'volume', 'network', 'pod', or 'all' (default: all)
|
||||
(Only meaningful when invoked as *podman inspect*)
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Inspect the fedora image:
|
||||
```
|
||||
|
|
|
@ -17,13 +17,6 @@ The local client further supports loading an **oci-dir** or a **docker-dir** as
|
|||
The **quiet** option suppresses the progress output when set.
|
||||
Note: `:` is a restricted character and cannot be part of the file name.
|
||||
|
||||
|
||||
**podman [GLOBAL OPTIONS]**
|
||||
|
||||
**podman load [GLOBAL OPTIONS]**
|
||||
|
||||
**podman load [OPTIONS]**
|
||||
|
||||
## OPTIONS
|
||||
|
||||
#### **--help**, **-h**
|
||||
|
|
|
@ -139,7 +139,7 @@ configuration information.
|
|||
|
||||
$ podman manifest add oci-archive:/tmp/myimage
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Add specified default image from source manifest list to destination manifest list:
|
||||
```
|
||||
|
|
|
@ -50,7 +50,7 @@ associated with, at most, one subject.
|
|||
|
||||
@@option variant.manifest
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Update arch and variant information to specified manifest list for image:
|
||||
```
|
||||
|
|
|
@ -9,6 +9,7 @@ podman\-manifest\-inspect - Display a manifest list or image index
|
|||
## DESCRIPTION
|
||||
|
||||
Displays the manifest list or image index stored using the specified image name.
|
||||
|
||||
## RETURN VALUE
|
||||
|
||||
A formatted JSON representation of the manifest list or image index.
|
||||
|
|
|
@ -78,7 +78,7 @@ Sign the pushed images with a sigstore signature using a private key at the spec
|
|||
|
||||
DESTINATION is the location the container image is pushed to. It supports all transports from `containers-transports(5)`. If no transport is specified, the `docker` (i.e., container registry) transport is used. For remote clients, including Mac and Windows (excluding WSL2) machines, `docker` is the only supported transport.
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Push manifest list to container registry:
|
||||
```
|
||||
|
|
|
@ -15,17 +15,15 @@ Removes one or more locally stored manifest lists.
|
|||
|
||||
If a specified manifest does not exist in the local storage, ignore it and do not throw an error.
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
podman manifest rm `<list>`
|
||||
```
|
||||
podman manifest rm listid
|
||||
```
|
||||
|
||||
podman manifest rm listid1 listid2
|
||||
|
||||
**storage.conf** (`/etc/containers/storage.conf`)
|
||||
|
||||
storage.conf is the storage configuration file for all tools using containers/storage
|
||||
|
||||
The storage configuration file specifies all of the available container storage options for tools using shared container storage.
|
||||
```
|
||||
podman manifest rm --ignore listid1 listid2
|
||||
```
|
||||
|
||||
## SEE ALSO
|
||||
**[podman(1)](podman.1.md)**, **[podman-manifest(1)](podman-manifest.1.md)**, **[containers-storage.conf(5)](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md)**
|
||||
|
|
|
@ -39,7 +39,7 @@ Print the mounted containers in specified format (json).
|
|||
|
||||
Do not truncate the output (default *false*).
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
In rootful mode, Mount specified container.
|
||||
```
|
||||
|
|
|
@ -26,7 +26,7 @@ Set a static ipv6 address for this container on this network.
|
|||
#### **--mac-address**=*address*
|
||||
Set a static mac address for this container on this network.
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Connect specified container to a named network:
|
||||
```
|
||||
|
|
|
@ -151,7 +151,7 @@ The subnet in CIDR notation. Can be specified multiple times to allocate more th
|
|||
The argument order of the **--subnet**, **--gateway** and **--ip-range** options must match.
|
||||
This is useful to set a static ipv4 and ipv6 subnet.
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Create a network with no options.
|
||||
```
|
||||
|
|
|
@ -19,7 +19,7 @@ running, the container is stopped and removed.
|
|||
|
||||
Seconds to wait before forcibly stopping the running containers that are using the specified network. The --force option must be specified to use the --time option. Use -1 for infinite wait.
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Delete specified network:
|
||||
```
|
||||
|
|
|
@ -42,7 +42,7 @@ When using a Go template, precede the format with `table` to print headers.
|
|||
|
||||
@@option no-stream
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
List statistics about all pods without streaming:
|
||||
```
|
||||
|
|
|
@ -213,9 +213,6 @@ fd7b786b5c32 docker.io/library/alpine:latest buildah 2 hours ago storage
|
|||
f78620804e00 scratch buildah 2 hours ago storage working-container
|
||||
```
|
||||
|
||||
## ps
|
||||
Print a list of containers
|
||||
|
||||
## SEE ALSO
|
||||
**[podman(1)](podman.1.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[crio(8)](https://github.com/cri-o/cri-o/blob/main/docs/crio.8.md)**
|
||||
|
||||
|
|
|
@ -102,7 +102,7 @@ Add a sigstore signature at the destination using a private key at the specified
|
|||
|
||||
@@option tls-verify
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
|
||||
Push the specified image to a local directory:
|
||||
```
|
||||
|
|
|
@ -75,7 +75,7 @@ The --force option must be specified to use the --time option.
|
|||
Remove anonymous volumes associated with the container. This does not include named volumes
|
||||
created with **podman volume create**, or the **--volume** option of **podman run** and **podman create**.
|
||||
|
||||
## EXAMPLE
|
||||
## EXAMPLES
|
||||
Remove container with a given name:
|
||||
```
|
||||
$ podman rm mywebserver
|
||||
|
|
|
@ -32,6 +32,8 @@ If a specified image does not exist in the local storage, ignore it and do not t
|
|||
|
||||
This option does not remove dangling parents of the specified image.
|
||||
|
||||
## EXAMPLES
|
||||
|
||||
Remove an image by its short ID
|
||||
```
|
||||
$ podman rmi c0ed59d05ff7
|
||||
|
|
|
@ -16,12 +16,6 @@ file using the **output** flag. The **quiet** flag suppresses the output when se
|
|||
To export the containers, use the **podman export**.
|
||||
Note: `:` is a restricted character and cannot be part of the file name.
|
||||
|
||||
**podman [GLOBAL OPTIONS]**
|
||||
|
||||
**podman save [GLOBAL OPTIONS]**
|
||||
|
||||
**podman save [OPTIONS] NAME[:TAG]**
|
||||
|
||||
## OPTIONS
|
||||
|
||||
@@option dir-compress
|
||||
|
|
|
@ -98,7 +98,6 @@ Do not truncate the output (default *false*).
|
|||
Search for images containing the specified name, returning the first three images from each defined registry.
|
||||
```
|
||||
$ podman search --limit 3 fedora
|
||||
NAME DESCRIPTION
|
||||
NAME DESCRIPTION
|
||||
registry.fedoraproject.org/f29/fedora-toolbox
|
||||
registry.fedoraproject.org/f30/fedora-toolbox
|
||||
|
|
Loading…
Reference in New Issue