6566f5ff2c
The biggest motivation for this is proper table rendering; in the old version it was broken so tables were not rendered at al (i.e. anything that was put into table was lost, for example, description of LOG_* log levels in dockerd(8) page). This also fixes lists, including nested lists. This fixes the description of behavior in docker-cp(1) which is rendered as a tree: BEFORE: ``` Assuming a path separator of /, a first argument of SRC_PATH and second argument of DEST_PATH, the behavior is as follows: · SRC_PATH specifies a file · DEST_PATH does not exist · the file is saved to a file created at DEST_PATH · DEST_PATH does not exist and ends with / · Error condition: the destination directory must exist. ... ``` AFTER: ``` Assuming a path separator of /, a first argument of SRC_PATH and second argument of DEST_PATH, the behavior is as follows: · SRC_PATH specifies a file · DEST_PATH does not exist · the file is saved to a file created at DEST_PATH · DEST_PATH does not exist and ends with / · Error condition: the destination directory must exist. ... ``` Manually checking the diff between the man pages generated by the old and the new version, there are no changes other than the indentation (.RS/.RE) for lists, and proper formatting for tables. Formatted man pages also look decent, nothing seems broken. Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com> |
||
---|---|---|
.github | ||
cli | ||
cmd/docker | ||
contrib/completion | ||
dockerfiles | ||
docs | ||
e2e | ||
experimental | ||
internal/test | ||
kubernetes | ||
man | ||
opts | ||
scripts | ||
service/logs | ||
templates | ||
vendor | ||
.dockerignore | ||
.gitignore | ||
.mailmap | ||
AUTHORS | ||
CONTRIBUTING.md | ||
Jenkinsfile | ||
LICENSE | ||
MAINTAINERS | ||
Makefile | ||
NOTICE | ||
README.md | ||
TESTING.md | ||
VERSION | ||
circle.yml | ||
codecov.yml | ||
docker.Makefile | ||
gometalinter.json | ||
poule.yml | ||
vendor.conf |
README.md
docker/cli
This repository is the home of the cli used in the Docker CE and Docker EE products.
Development
docker/cli
is developed using Docker.
Build a linux binary:
$ make -f docker.Makefile binary
Build binaries for all supported platforms:
$ make -f docker.Makefile cross
Run all linting:
$ make -f docker.Makefile lint
List all the available targets:
$ make help
In-container development environment
Start an interactive development environment:
$ make -f docker.Makefile shell
In the development environment you can run many tasks, including build binaries:
$ make binary
Legal
Brought to you courtesy of our legal counsel. For more context, please see the NOTICE document in this repo.
Use and transfer of Docker may be subject to certain restrictions by the United States and other governments.
It is your responsibility to ensure that your use and/or transfer does not violate applicable laws.
For more information, please see https://www.bis.doc.gov
Licensing
docker/cli is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.