{"action":"created","issue":{"url":"https://api.github.com/repos/weaveworks/weave/issues/1084","labels_url":"https://api.github.com/repos/weaveworks/weave/issues/1084/labels{/name}","comments_url":"https://api.github.com/repos/weaveworks/weave/issues/1084/comments","events_url":"https://api.github.com/repos/weaveworks/weave/issues/1084/events","html_url":"https://github.com/weaveworks/weave/pull/1084","id":93291907,"number":1084,"title":"Consistent option naming","user":{"login":"squaremo","id":62033,"avatar_url":"https://avatars.githubusercontent.com/u/62033?v=3","gravatar_id":"","url":"https://api.github.com/users/squaremo","html_url":"https://github.com/squaremo","followers_url":"https://api.github.com/users/squaremo/followers","following_url":"https://api.github.com/users/squaremo/following{/other_user}","gists_url":"https://api.github.com/users/squaremo/gists{/gist_id}","starred_url":"https://api.github.com/users/squaremo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/squaremo/subscriptions","organizations_url":"https://api.github.com/users/squaremo/orgs","repos_url":"https://api.github.com/users/squaremo/repos","events_url":"https://api.github.com/users/squaremo/events{/privacy}","received_events_url":"https://api.github.com/users/squaremo/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-07-06T14:23:56Z","updated_at":"2015-07-06T14:51:15Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/weaveworks/weave/pulls/1084","html_url":"https://github.com/weaveworks/weave/pull/1084","diff_url":"https://github.com/weaveworks/weave/pull/1084.diff","patch_url":"https://github.com/weaveworks/weave/pull/1084.patch"},"body":"Namely:\r\n\r\n * long options get two hyphens at the start; e.g., `--password`; and,\r\n * options made from multiple whole words are hyphenated; e.g., `--no-discovery`; and,\r\n * some options that are applied to DNS but sound universal have `dns` prepended, e.g., `--dns-port`.\r\n\r\nThere are exceptions; \"ipalloc\" is treated as one word for hyphenation; the `--tls*` options are left as-is since they correspond to Docker options; some niche options don't get hyphenated e.g., `--bufsz`; some options that are likely to disappear are left alone.\r\n\r\nIn all cases, the old version of an option will work, while outputting a deprecation warning. Mostly these will end up in container logs. Renamed options that are mentioned in the script usage, or otherwise specially-treated in the script, have a deprecation notice output to the console.\r\n\r\nCloses #602."},"comment":{"url":"https://api.github.com/repos/weaveworks/weave/issues/comments/118878864","html_url":"https://github.com/weaveworks/weave/pull/1084#issuecomment-118878864","issue_url":"https://api.github.com/repos/weaveworks/weave/issues/1084","id":118878864,"user":{"login":"squaremo","id":62033,"avatar_url":"https://avatars.githubusercontent.com/u/62033?v=3","gravatar_id":"","url":"https://api.github.com/users/squaremo","html_url":"https://github.com/squaremo","followers_url":"https://api.github.com/users/squaremo/followers","following_url":"https://api.github.com/users/squaremo/following{/other_user}","gists_url":"https://api.github.com/users/squaremo/gists{/gist_id}","starred_url":"https://api.github.com/users/squaremo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/squaremo/subscriptions","organizations_url":"https://api.github.com/users/squaremo/orgs","repos_url":"https://api.github.com/users/squaremo/repos","events_url":"https://api.github.com/users/squaremo/events{/privacy}","received_events_url":"https://api.github.com/users/squaremo/received_events","type":"User","site_admin":false},"created_at":"2015-07-06T14:51:15Z","updated_at":"2015-07-06T14:51:15Z","body":"> So no --option= except for the tls args?\r\n\r\nThe mflag library will in general treat `--option=value` and `--option value` as the same. The exception, as usual, is boolean flags, where the `--option bool` variety is ruled out."}}