Is there a way to run cargo doc and only get the documentation for direct dependencies of my project?

[arthmis]

Describe the problem you are trying to solve

Whenever I run cargo doc, it builds the documentation for all the dependencies of the project. The problem is that I don't want all the documentation for every crate. I only want the documentation for the crates that are direct dependencies of my project and not the dependencies of my project's dependencies.

Describe the solution you'd like

I would prefer if the default behavior of cargo doc only builds the documentation for my project and its direct dependencies.

[alexcrichton]

There isn't currently, but a flag could be added!

[dwijnand]

Plausible flag names? --direct-deps-only?

[arthmis]

Is there a reason cargo doc builds the documentation for every dependency of the project and not only the direct dependencies? I can't imagine that someone would want the documentation for all dependencies and also what is the point of the flag --all?

[ehuss]

This may be a duplicate of #2025.

[yuyoyuppe]

I'd like to help implementing this, but I wonder what is the expected behavior of links which refer to the "undocumented" crates? some options OTOH:

• make them lead to a special "not documented" page
• transform the links so they refer to the official docs.rs page

I'm not yet familiar how the doc command works, so maybe those links won't be generated in the first place.

I also wonder if it's possible to avoid building the documentation of the indirect dependencies entirely, not just hiding after the fact, since building them is a time-consuming process.

[ehuss]

Closing as a duplicate of #2025.