{"action":"created","issue":{"url":"https://api.github.com/repos/TeXitoi/structopt/issues/60","repository_url":"https://api.github.com/repos/TeXitoi/structopt","labels_url":"https://api.github.com/repos/TeXitoi/structopt/issues/60/labels{/name}","comments_url":"https://api.github.com/repos/TeXitoi/structopt/issues/60/comments","events_url":"https://api.github.com/repos/TeXitoi/structopt/issues/60/events","html_url":"https://github.com/TeXitoi/structopt/issues/60","id":295529551,"number":60,"title":"Help text not shown in subcommand summary","user":{"login":"andor44","id":496456,"avatar_url":"https://avatars1.githubusercontent.com/u/496456?v=4","gravatar_id":"","url":"https://api.github.com/users/andor44","html_url":"https://github.com/andor44","followers_url":"https://api.github.com/users/andor44/followers","following_url":"https://api.github.com/users/andor44/following{/other_user}","gists_url":"https://api.github.com/users/andor44/gists{/gist_id}","starred_url":"https://api.github.com/users/andor44/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/andor44/subscriptions","organizations_url":"https://api.github.com/users/andor44/orgs","repos_url":"https://api.github.com/users/andor44/repos","events_url":"https://api.github.com/users/andor44/events{/privacy}","received_events_url":"https://api.github.com/users/andor44/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-02-08T14:21:51Z","updated_at":"2018-02-08T14:27:22Z","closed_at":null,"author_association":"NONE","body":"I have something that looks like this:\r\n\r\n```rust\r\n#[derive(StructOpt, Debug)]\r\n#[structopt(name = \"foo\", about = \"bar\")]\r\nstruct Config {\r\n    // a couple fields for common options, their `help` works fine\r\n    // ...\r\n\r\n    #[structopt(subcommand)]\r\n    subcommand: Subcommand,\r\n}\r\n\r\n#[derive(StructOpt, Debug)]\r\nenum Subcommand {\r\n    #[structopt(name = \"foo\", help = \"Do foo\")]\r\n    Foo,\r\n    #[structopt(name = \"bar\", help = \"Do bar\")]\r\n    Bar,\r\n    #[structopt(name = \"baz\", help = \"Do baz\")]\r\n    Baz {\r\n        #[structopt(subcommand)]\r\n        some_subsubcommand: SubSubcommand,\r\n    }\r\n}\r\n```\r\n\r\n```\r\n$ cargo run -- help\r\n...\r\nSUBCOMMANDS:\r\n    bar\r\n    baz\r\n    foo\r\n    help                  Prints this message or the help of the given subcommand(s)\r\n```\r\n\r\nWhen I invoke the automatically generated `help`, my subcommands show up, but only `help`'s short help will be shown, my subcommands' will not. `help <subcommand>` does show the help though. I think it would make sense to show the help description in the subcommands summary too."},"comment":{"url":"https://api.github.com/repos/TeXitoi/structopt/issues/comments/364127478","html_url":"https://github.com/TeXitoi/structopt/issues/60#issuecomment-364127478","issue_url":"https://api.github.com/repos/TeXitoi/structopt/issues/60","id":364127478,"user":{"login":"TeXitoi","id":5787066,"avatar_url":"https://avatars0.githubusercontent.com/u/5787066?v=4","gravatar_id":"","url":"https://api.github.com/users/TeXitoi","html_url":"https://github.com/TeXitoi","followers_url":"https://api.github.com/users/TeXitoi/followers","following_url":"https://api.github.com/users/TeXitoi/following{/other_user}","gists_url":"https://api.github.com/users/TeXitoi/gists{/gist_id}","starred_url":"https://api.github.com/users/TeXitoi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/TeXitoi/subscriptions","organizations_url":"https://api.github.com/users/TeXitoi/orgs","repos_url":"https://api.github.com/users/TeXitoi/repos","events_url":"https://api.github.com/users/TeXitoi/events{/privacy}","received_events_url":"https://api.github.com/users/TeXitoi/received_events","type":"User","site_admin":false},"created_at":"2018-02-08T14:27:22Z","updated_at":"2018-02-08T14:27:22Z","author_association":"OWNER","body":"Looking at https://docs.rs/clap/2.29.4/clap/struct.SubCommand.html I think you want to use `about` instead of `help` on `enum Subcommand`:\r\n```rust\r\nenum Subcommand {\r\n    #[structopt(name = \"foo\", about = \"Do foo\")]\r\n    Foo,\r\n    #[structopt(name = \"bar\", about = \"Do bar\")]\r\n    Bar,\r\n    #[structopt(name = \"baz\", about = \"Do baz\")]\r\n    Baz {\r\n        #[structopt(subcommand)]\r\n        some_subsubcommand: SubSubcommand,\r\n    }\r\n}\r\n```\r\n\r\nDoes it fix your problem?"}}
{"actor":{"display_login":"TeXitoi"}}