{"action":"opened","issue":{"url":"https://api.github.com/repos/yarnpkg/yarn/issues/947","repository_url":"https://api.github.com/repos/yarnpkg/yarn","labels_url":"https://api.github.com/repos/yarnpkg/yarn/issues/947/labels{/name}","comments_url":"https://api.github.com/repos/yarnpkg/yarn/issues/947/comments","events_url":"https://api.github.com/repos/yarnpkg/yarn/issues/947/events","html_url":"https://github.com/yarnpkg/yarn/issues/947","id":182657605,"number":947,"title":"Improve `yarn -h`","user":{"login":"lorensr","id":251288,"avatar_url":"https://avatars.githubusercontent.com/u/251288?v=3","gravatar_id":"","url":"https://api.github.com/users/lorensr","html_url":"https://github.com/lorensr","followers_url":"https://api.github.com/users/lorensr/followers","following_url":"https://api.github.com/users/lorensr/following{/other_user}","gists_url":"https://api.github.com/users/lorensr/gists{/gist_id}","starred_url":"https://api.github.com/users/lorensr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lorensr/subscriptions","organizations_url":"https://api.github.com/users/lorensr/orgs","repos_url":"https://api.github.com/users/lorensr/repos","events_url":"https://api.github.com/users/lorensr/events{/privacy}","received_events_url":"https://api.github.com/users/lorensr/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2016-10-12T23:16:47Z","updated_at":"2016-10-12T23:16:47Z","closed_at":null,"body":"<!-- *Before creating an issue please make sure you are using the latest version of yarn.* -->\r\n\r\n**Do you want to request a *feature* or report a *bug*?**\r\n\r\nFeature\r\n\r\n**What is the current behavior?**\r\n\r\n```\r\n# yarn -h\r\n  Usage: yarn install [flags]\r\n\r\n  Options:\r\n\r\n    -h, --help                  output usage information\r\n    -V, --version               output the version number\r\n    --offline                   \r\n    --prefer-offline            \r\n    --strict-semver             \r\n    --json                      \r\n    --global-folder [path]      \r\n    --modules-folder [path]     rather than installing modules into the node_modules folder relative to the cwd, output them here\r\n    --packages-root [path]      rather than storing modules into a global packages root, store them here\r\n    --mutex [type][:specifier]  use a mutex to ensure only one yarn instance is executing\r\n    --har                       save HAR output of network traffic\r\n    --ignore-engines            ignore engines check\r\n    --ignore-scripts            \r\n    --ignore-optional           \r\n    --force                     \r\n    --flat                      only allow one version of a package\r\n    --prod, --production        \r\n    --no-lockfile               don't read or generate a lockfile\r\n    --pure-lockfile             don't generate a lockfile\r\n    -g, --global                DEPRECATED\r\n    -S, --save                  DEPRECATED - save package to your `dependencies`\r\n    -D, --save-dev              DEPRECATED - save package to your `devDependencies`\r\n    -P, --save-peer             DEPRECATED - save package to your `peerDependencies`\r\n    -O, --save-optional         DEPRECATED - save package to your `optionalDependencies`\r\n    -E, --save-exact            DEPRECATED\r\n    -T, --save-tilde            DEPRECATED\r\n```\r\n\r\n\r\n\r\n**What is the expected behavior?**\r\n\r\nI would like it to print enough to teach me how to use `yarn`. With the above output, I don't know what the top-level commands are besides `install`. When I do `yarn install -h`, the output is the same. I expect #407 would help with some of this if/when it happens. \r\n\r\nAlso, I assume `Usage: yarn install [flags]` is incomplete – it doesn't cover eg `yarn install a-single-packagename` (eg `Usage: yarn install <packagename>`. I think flags are always implied.) \r\n\r\n**Please mention your node.js, yarn and operating system version.**\r\n\r\n```\r\nnode v5.4.1\r\nyarn install v0.15.1\r\nSierra 10.12\r\n```\r\n"}}
{"actor":{"display_login":"lorensr"}}