Doc: missing for some modules

[unkcpz]

In https://docs.rs/keyring/latest/keyring/#modules, it only has the secret-service module where I can go and check the doc of credential description.
I was expect also the doc for the keyutils and for ios/macos.

I assume build-xplat-docs.sh is for building cross-platform doc. But the build OS is linux so the apple part is ignored.
I believe this is a more standard way to build doc with cross-platform doc?

[brotskydotcom]

Hi Jusong, thanks for raising this question. Because I've assumed that people only need docs for the platforms they can actually build for, and because docs.rs builds for all the "common" platforms (including macOS, although not iOS), I've never thought about doing an "all-platforms" build of the doc. I would be happy to look at a PR if you're interested in providing one.

[unkcpz]

Thanks for quick reply. It is mostly for the python binding keyringrs you may notice through another issue I opened. I want to redirect from the readme to docs.rs for all platforms for options such as definition of target option of different platform.

I am surely willing to fire a PR. Could you tell me is build-xplot-docs.sh is used or it can replace with trying to use #[cfg(doc)].

[brotskydotcom]

The build-xplat-docs.sh file is just for local development purposes and should be removed as part of your PR. By all means try getting the docs working using #[cfg(doc)]

[unkcpz]

thanks, I draft a PR in #237, let's move the discussion there. It actually not trivial to make docs build for cross-platfrom, which regard as [the 'holy grail of rustdoc'](https://doc.rust-lang.org/rustdoc/advanced-features.html?search=dox) :)