Bug 1259239

Summary: "man docker" says nothing about "docker daemon" subcommand
Product: [Fedora] Fedora Reporter: Robert P. J. Day <rpjday>
Component: dockerAssignee: Sally <somalley>
Status: CLOSED CURRENTRELEASE QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: low Docs Contact:
Priority: unspecified    
Version: 22CC: adimania, admiller, dwalsh, ichavero, jcajka, jchaloup, lsm5, miminar, vbatts
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-02-16 17:43:14 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Robert P. J. Day 2015-09-02 09:24:21 UTC
Seems that "man docker" (as of version 1.8) should mention the "docker daemon" subcommand -- certainly, "docker --help" has a reference to it.

https://docs.docker.com/misc/deprecated/

Comment 1 Daniel Walsh 2015-09-02 12:10:00 UTC
Docker man page needs a rewrite,   We need to eliminate mention or options that are appropriate to the docker daemon command.

Comment 2 smahajan@redhat.com 2015-09-03 21:05:01 UTC
PR Opened upstream

https://github.com/docker/docker/pull/16063

Shishir

Comment 3 Robert P. J. Day 2015-09-05 09:06:31 UTC
Not sure if I mentioned this elsewhere, but would there also not be a need for a "man docker-daemon" man page?

Comment 4 Daniel Walsh 2015-09-06 10:50:10 UTC
Yes their should be a docker daemon man page.

Comment 5 smahajan@redhat.com 2015-09-06 14:12:49 UTC
I am not sure if a man page for "docker daemon" will make it upstream.

Even though with docker 1.8 onwards, we can start docker using "daemon" keyword. Docker never made it a registered command. You don't see "daemon" in the list of commands.

In docker words, "docker is both a server, as a daemon, and a client to the daemon, through the CLI" so I feel docker would like to keep this information in the "docker man page" rather than having a "docker-daemon" man page for this.

Comment 6 Daniel Walsh 2015-09-07 10:49:33 UTC
Lets make the attempt.  I would prefer the docker-daemon man page not to cover all of the other content about the docker command.

Comment 7 Daniel Walsh 2015-09-29 13:23:03 UTC
Fixed in docker-1.9