make doc does not work, neither does cargo doc

[icefoxen]

Just making an issue for this, since I can't find one already.

cargo doc inconveniently does not have --features or --exclude flags, which means trivially working it into the current makefile's setup is difficult. Trying to build it on any one platform is going to have at least one backend that won't build 'cause it won't have Metal or DirectX or whatever.

Weirdly, you can do cargo build --exclude and it works just fine, it just builds a subset of the workspace's crates. And doing cargo doc in just the src/hal subdirectory seems to work fine. But how to make this play nice with docs.rs is something that is currently beyond me.

Related: rust-lang/cargo#4049 ?

I dunno, there might be a clever way around this but I can't think of it right now.

[scoopr]

Even a documented workaround would be nice. I just commented out other bits from the workspace toml except hal and the backend I wanted, which worked. cargo doc --help says that there is --features flag, but that didn't seem to do anything, it still tried to go through all the backends.