1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00

Docs: Be more clear when specifying valid formats for strings

- Use the word letter rather than character to refer to letters ;) when trying to specify that only letters and numbers can be used, and not ANY character...
- Small corrections

Fixes #29821

Signed-off-by: Timothy Hobbs <timothy@hobbs.cz>
This commit is contained in:
Timothy Hobbs 2017-01-02 22:06:46 +01:00
parent 2ef6d80454
commit b71b4e1fb9
3 changed files with 11 additions and 10 deletions

View file

@ -29,13 +29,13 @@ by a registry hostname. The hostname must comply with standard DNS rules, but
may not contain underscores. If a hostname is present, it may optionally be may not contain underscores. If a hostname is present, it may optionally be
followed by a port number in the format `:8080`. If not present, the command followed by a port number in the format `:8080`. If not present, the command
uses Docker's public registry located at `registry-1.docker.io` by default. Name uses Docker's public registry located at `registry-1.docker.io` by default. Name
components may contain lowercase characters, digits and separators. A separator components may contain lowercase letters, digits and separators. A separator
is defined as a period, one or two underscores, or one or more dashes. A name is defined as a period, one or two underscores, or one or more dashes. A name
component may not start or end with a separator. component may not start or end with a separator.
A tag name may contain lowercase and uppercase characters, digits, underscores, A tag name must be valid ASCII and may contain lowercase and uppercase letters,
periods and dashes. A tag name may not start with a period or a dash and may digits, underscores, periods and dashes. A tag name may not start with a
contain a maximum of 128 characters. period or a dash and may contain a maximum of 128 characters.
You can group your images together using names and tags, and then upload them You can group your images together using names and tags, and then upload them
to [*Share Images via Repositories*](https://docs.docker.com/engine/tutorials/dockerrepos/#/contributing-to-docker-hub). to [*Share Images via Repositories*](https://docs.docker.com/engine/tutorials/dockerrepos/#/contributing-to-docker-hub).

View file

@ -92,7 +92,7 @@ This specification uses the following terms:
often referred to as a tag as well, though it strictly refers to the often referred to as a tag as well, though it strictly refers to the
full name of an image. Acceptable values for a tag suffix are full name of an image. Acceptable values for a tag suffix are
implementation specific, but they SHOULD be limited to the set of implementation specific, but they SHOULD be limited to the set of
alphanumeric characters <code>[a-zA-z0-9]</code>, punctuation alphanumeric characters <code>[a-zA-Z0-9]</code>, punctuation
characters <code>[._-]</code>, and MUST NOT contain a <code>:</code> characters <code>[._-]</code>, and MUST NOT contain a <code>:</code>
character. character.
</dd> </dd>
@ -105,7 +105,7 @@ This specification uses the following terms:
<code>my-app:3.1.4</code>, <code>my-app</code> is the <i>Repository</i> <code>my-app:3.1.4</code>, <code>my-app</code> is the <i>Repository</i>
component of the name. Acceptable values for repository name are component of the name. Acceptable values for repository name are
implementation specific, but they SHOULD be limited to the set of implementation specific, but they SHOULD be limited to the set of
alphanumeric characters <code>[a-zA-z0-9]</code>, and punctuation alphanumeric characters <code>[a-zA-Z0-9]</code>, and punctuation
characters <code>[._-]</code>, however it MAY contain additional characters <code>[._-]</code>, however it MAY contain additional
<code>/</code> and <code>:</code> characters for organizational <code>/</code> and <code>:</code> characters for organizational
purposes, with the last <code>:</code> character being interpreted purposes, with the last <code>:</code> character being interpreted

View file

@ -9,15 +9,16 @@ entire image name including the optional `TAG` after the ':'.
present, it may optionally be followed by a port number in the format present, it may optionally be followed by a port number in the format
`:8080`. If not present, the command uses Docker's public registry located at `:8080`. If not present, the command uses Docker's public registry located at
`registry-1.docker.io` by default. Name components may contain lowercase `registry-1.docker.io` by default. Name components may contain lowercase
characters, digits and separators. A separator is defined as a period, one or letters, digits and separators. A separator is defined as a period, one or
two underscores, or one or more dashes. A name component may not start or end two underscores, or one or more dashes. A name component may not start or end
with a separator. with a separator.
**TAG** **TAG**
The tag assigned to the image to version and distinguish images with the same The tag assigned to the image to version and distinguish images with the same
name. The tag name may contain lowercase and uppercase characters, digits, name. The tag name must be valid ASCII and may contain lowercase and
underscores, periods and dashes. A tag name may not start with a period or a uppercase letters, digits, underscores, periods and hyphens. A tag name
dash and may contain a maximum of 128 characters. may not start with a period or a hyphen and may contain a maximum of 128
characters.
# EXAMPLES # EXAMPLES