aboutsummaryrefslogtreecommitdiff
path: root/docs/podman-history.1.md
diff options
context:
space:
mode:
authorbaude <bbaude@redhat.com>2019-10-24 14:54:57 -0500
committerbaude <bbaude@redhat.com>2019-10-31 12:31:39 -0500
commit52b92023edeba3a5e2c466d92d742e54b14a85cb (patch)
tree44e6193d49afd1277b7d07b0df41fc80d31b3adb /docs/podman-history.1.md
parent5af166ff513265b17aee92a9ce3a1522090d7dec (diff)
downloadpodman-52b92023edeba3a5e2c466d92d742e54b14a85cb.tar.gz
podman-52b92023edeba3a5e2c466d92d742e54b14a85cb.tar.bz2
podman-52b92023edeba3a5e2c466d92d742e54b14a85cb.zip
Restructure documentation dir
Restructuring the docs dir to make integration with sphinx easier. man pages now exist in docs/source/man and the sphinx make files exists in docs. Signed-off-by: baude <bbaude@redhat.com>
Diffstat (limited to 'docs/podman-history.1.md')
-rw-r--r--docs/podman-history.1.md98
1 files changed, 0 insertions, 98 deletions
diff --git a/docs/podman-history.1.md b/docs/podman-history.1.md
deleted file mode 100644
index a67cb0286..000000000
--- a/docs/podman-history.1.md
+++ /dev/null
@@ -1,98 +0,0 @@
-% podman-history(1)
-
-## NAME
-podman\-history - Show the history of an image
-
-## SYNOPSIS
-**podman history** [*options*] *image*[:*tag*|@*digest*]
-
-**podman image history** [*options*] *image*[:*tag*|@*digest*]
-
-## DESCRIPTION
-**podman history** displays the history of an image by printing out information
-about each layer used in the image. The information printed out for each layer
-include Created (time and date), Created By, Size, and Comment. The output can
-be truncated or not using the **--no-trunc** flag. If the **--human** flag is
-set, the time of creation and size are printed out in a human readable format.
-The **--quiet** flag displays the ID of the image only when set and the **--format**
-flag is used to print the information using the Go template provided by the user.
-
-Valid placeholders for the Go template are listed below:
-
-| **Placeholder** | **Description** |
-| --------------- | ----------------------------------------------------------------------------- |
-| .ID | Image ID |
-| .Created | if **--human**, time elapsed since creation, otherwise time stamp of creation |
-| .CreatedBy | Command used to create the layer |
-| .Size | Size of layer on disk |
-| .Comment | Comment for the layer |
-
-## OPTIONS
-
-**--human**, **-H**
-
-Display sizes and dates in human readable format
-
-**--no-trunc**
-
-Do not truncate the output
-
-**--quiet**, **-q**
-
-Print the numeric IDs only
-
-**--format**=*format*
-
-Alter the output for a format like 'json' or a Go template.
-
-**--help**, **-h**
-
-Print usage statement
-
-## EXAMPLES
-
-```
-$ podman history debian
-ID CREATED CREATED BY SIZE COMMENT
-b676ca55e4f2c 9 weeks ago /bin/sh -c #(nop) CMD ["bash"] 0 B
-<missing> 9 weeks ago /bin/sh -c #(nop) ADD file:ebba725fb97cea4... 45.14 MB
-```
-
-```
-$ podman history --no-trunc=true --human=false debian
-ID CREATED CREATED BY SIZE COMMENT
-b676ca55e4f2c 2017-07-24T16:52:55Z /bin/sh -c #(nop) CMD ["bash"] 0
-<missing> 2017-07-24T16:52:54Z /bin/sh -c #(nop) ADD file:ebba725fb97cea4... 45142935
-```
-
-```
-$ podman history --format "{{.ID}} {{.Created}}" debian
-b676ca55e4f2c 9 weeks ago
-<missing> 9 weeks ago
-```
-
-```
-$ podman history --format json debian
-[
- {
- "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
- "created": "2017-07-24T16:52:55.195062314Z",
- "createdBy": "/bin/sh -c #(nop) CMD [\"bash\"]",
- "size": 0,
- "comment": ""
- },
- {
- "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
- "created": "2017-07-24T16:52:54.898893387Z",
- "createdBy": "/bin/sh -c #(nop) ADD file:ebba725fb97cea45d0b1b35ccc8144e766fcfc9a78530465c23b0c4674b14042 in / ",
- "size": 45142935,
- "comment": ""
- }
-]
-```
-
-## SEE ALSO
-podman(1)
-
-## HISTORY
-July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>