Closed
Description
Problem
From #11646 (comment), people struggle to run src/doc/build-man.sh
on Windows. This might prevent Windows users from contributing Cargo documentations. We may want to find a way making every contributor feel inclusive without introducing more external tool dependencies.
Proposed Solution
Two options off the top of my head:
- EASY: Translate
src/doc/build-man.sh
to Windows batch script or powershell. - EASY: Use a python script instead. See this comment.
- HARD?: Introduce some workflow like
cargo-xtask
(blocked on nested workspaces feature).
Need to take care of crates/mdman/build-man.sh
as well.
Notes
Was reading this article and it reminded me this issue.