{"action":"created","issue":{"url":"https://api.github.com/repos/docker/docker/issues/10458","repository_url":"https://api.github.com/repos/docker/docker","labels_url":"https://api.github.com/repos/docker/docker/issues/10458/labels{/name}","comments_url":"https://api.github.com/repos/docker/docker/issues/10458/comments","events_url":"https://api.github.com/repos/docker/docker/issues/10458/events","html_url":"https://github.com/docker/docker/issues/10458","id":56033437,"number":10458,"title":"docker rm --link documentation is incomplete","user":{"login":"amouat","id":246775,"avatar_url":"https://avatars.githubusercontent.com/u/246775?v=3","gravatar_id":"","url":"https://api.github.com/users/amouat","html_url":"https://github.com/amouat","followers_url":"https://api.github.com/users/amouat/followers","following_url":"https://api.github.com/users/amouat/following{/other_user}","gists_url":"https://api.github.com/users/amouat/gists{/gist_id}","starred_url":"https://api.github.com/users/amouat/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/amouat/subscriptions","organizations_url":"https://api.github.com/users/amouat/orgs","repos_url":"https://api.github.com/users/amouat/repos","events_url":"https://api.github.com/users/amouat/events{/privacy}","received_events_url":"https://api.github.com/users/amouat/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/docker/docker/labels/exp/beginner","name":"exp/beginner","color":"A8DBA8"},{"url":"https://api.github.com/repos/docker/docker/labels/kind/docs","name":"kind/docs","color":"A8E6CE"},{"url":"https://api.github.com/repos/docker/docker/labels/kind/feature","name":"kind/feature","color":"AAB3AB"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":14,"created_at":"2015-01-30T13:31:36Z","updated_at":"2016-05-25T12:52:47Z","closed_at":null,"body":"If you want to remove a link between containers, you can use `docker rm --link`. The current documentation says:\r\n\r\n     $ docker help rm\r\n\r\n    Usage: docker rm [OPTIONS] CONTAINER [CONTAINER...]\r\n\r\n    Remove one or more containers\r\n\r\n      -f, --force=false      Force the removal of a running container (uses SIGKILL)\r\n      -l, --link=false       Remove the specified link and not the underlying container\r\n      -v, --volumes=false    Remove the volumes associated with the container\r\n\r\nI eventually figured out that you need to use the syntax `docker rm -l HOSTCON/LINKCON`, but I'm not sure how I was meant to know that. It doesn't feel symmetrical to the syntax used to create a link or other commands which typically use : as a separator.\r\n\r\nAlso, I'm really not convinced `docker rm` is the right place for the functionality - all other flags remove the container including `-v`. Could this be moved to a `docker unlink` subcommand or similar and the documentation improved?"},"comment":{"url":"https://api.github.com/repos/docker/docker/issues/comments/221566202","html_url":"https://github.com/docker/docker/issues/10458#issuecomment-221566202","issue_url":"https://api.github.com/repos/docker/docker/issues/10458","id":221566202,"user":{"login":"gianarb","id":1630267,"avatar_url":"https://avatars.githubusercontent.com/u/1630267?v=3","gravatar_id":"","url":"https://api.github.com/users/gianarb","html_url":"https://github.com/gianarb","followers_url":"https://api.github.com/users/gianarb/followers","following_url":"https://api.github.com/users/gianarb/following{/other_user}","gists_url":"https://api.github.com/users/gianarb/gists{/gist_id}","starred_url":"https://api.github.com/users/gianarb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gianarb/subscriptions","organizations_url":"https://api.github.com/users/gianarb/orgs","repos_url":"https://api.github.com/users/gianarb/repos","events_url":"https://api.github.com/users/gianarb/events{/privacy}","received_events_url":"https://api.github.com/users/gianarb/received_events","type":"User","site_admin":false},"created_at":"2016-05-25T12:52:47Z","updated_at":"2016-05-25T12:52:47Z","body":"Hello,\r\nThis PR https://github.com/docker/docker/pull/12921 fixed this problem I think.\r\nThis issue could be closed.\r\n\r\nI verified few minutes ago and this docs works well"}}
{"actor":{"display_login":"gianarb"}}