{"action":"created","issue":{"url":"https://api.github.com/repos/rust-lang/cargo/issues/1520","labels_url":"https://api.github.com/repos/rust-lang/cargo/issues/1520/labels{/name}","comments_url":"https://api.github.com/repos/rust-lang/cargo/issues/1520/comments","events_url":"https://api.github.com/repos/rust-lang/cargo/issues/1520/events","html_url":"https://github.com/rust-lang/cargo/issues/1520","id":68090539,"number":1520,"title":"cargo doc: add option to document private types","user":{"login":"SimonSapin","id":291359,"avatar_url":"https://avatars.githubusercontent.com/u/291359?v=3","gravatar_id":"","url":"https://api.github.com/users/SimonSapin","html_url":"https://github.com/SimonSapin","followers_url":"https://api.github.com/users/SimonSapin/followers","following_url":"https://api.github.com/users/SimonSapin/following{/other_user}","gists_url":"https://api.github.com/users/SimonSapin/gists{/gist_id}","starred_url":"https://api.github.com/users/SimonSapin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SimonSapin/subscriptions","organizations_url":"https://api.github.com/users/SimonSapin/orgs","repos_url":"https://api.github.com/users/SimonSapin/repos","events_url":"https://api.github.com/users/SimonSapin/events{/privacy}","received_events_url":"https://api.github.com/users/SimonSapin/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/rust-lang/cargo/labels/A-configuration","name":"A-configuration","color":"fbca04"},{"url":"https://api.github.com/repos/rust-lang/cargo/labels/C-doc","name":"C-doc","color":"5319e7"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2015-04-13T12:59:58Z","updated_at":"2015-08-27T00:57:44Z","closed_at":null,"body":"rustdoc can include private items in the generated documentation: https://github.com/rust-lang/rust/issues/15347#issuecomment-56939049\r\nThis is triggered by passing `--no-defaults --passes \"collapse-docs\" --passes \"unindent-comments\"` to it. This has two issues:\r\n\r\n* It’s very hard to discover\r\n* Cargo does not allow giving arbitrary parameters to rustdoc: https://github.com/rust-lang/cargo/issues/331\r\n\r\nCould Cargo do this itself e.g. when `[lib] doc-private = true` is set in `Cargo.toml`?"},"comment":{"url":"https://api.github.com/repos/rust-lang/cargo/issues/comments/135223109","html_url":"https://github.com/rust-lang/cargo/issues/1520#issuecomment-135223109","issue_url":"https://api.github.com/repos/rust-lang/cargo/issues/1520","id":135223109,"user":{"login":"ssokolow","id":46915,"avatar_url":"https://avatars.githubusercontent.com/u/46915?v=3","gravatar_id":"","url":"https://api.github.com/users/ssokolow","html_url":"https://github.com/ssokolow","followers_url":"https://api.github.com/users/ssokolow/followers","following_url":"https://api.github.com/users/ssokolow/following{/other_user}","gists_url":"https://api.github.com/users/ssokolow/gists{/gist_id}","starred_url":"https://api.github.com/users/ssokolow/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ssokolow/subscriptions","organizations_url":"https://api.github.com/users/ssokolow/orgs","repos_url":"https://api.github.com/users/ssokolow/repos","events_url":"https://api.github.com/users/ssokolow/events{/privacy}","received_events_url":"https://api.github.com/users/ssokolow/received_events","type":"User","site_admin":false},"created_at":"2015-08-27T00:57:44Z","updated_at":"2015-08-27T00:57:44Z","body":"@LukasKalbertodt \r\n\r\nI have to agree. In my Python projects, I use ePyDoc to get a structured overview of my code when I'm returning from working on something else and the Rust book didn't even mention that private types wouldn't get documented.\r\n\r\nSince my first project was an application project, that led me to get really frustrated because I thought it was something that was supposed to work and, thus, something I'd done wrong."}}