Add delvewheel shoutout

Fix #459
pypa · Apr 23, 2021 · 9c797c2 · 9c797c2 · myselfhimself · Apr 30, 2021
1 parent 86b00da
commit 9c797c2
Showing 1 changed file with 14 additions and 0 deletions.
diff --git a/docs/options.md b/docs/options.md
@@ -432,14 +432,28 @@ The command is run in a shell, so you can run multiple commands like `cmd1 && cm
 Platform-specific variants also available:<br/>
 `CIBW_REPAIR_WHEEL_COMMAND_MACOS` | `CIBW_REPAIR_WHEEL_COMMAND_WINDOWS` | `CIBW_REPAIR_WHEEL_COMMAND_LINUX`
 
+!!! tip
+    cibuildwheel doesn't yet ship a default repair command for Windows.
+
+    **If that's an issue for you, check out [delvewheel]** - a new package that aims to do the same as `auditwheel` or `delocate` for Windows.
+
+    Because delvewheel is still relatively early-stage,  cibuildwheel does not yet run it by default. However, we'd recommend giving it a try! See the examples below for usage.
+
+    [Delvewheel]: https://github.com/adang1345/delvewheel
+
 #### Examples
 
 ```yaml
+# use delvewheel on windows
+CIBW_BEFORE_BUILD_WINDOWS: "pip install delvewheel"
+CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: "delvewheel repair -w {dest_dir} {wheel}"
+
 # don't repair macOS wheels
 CIBW_REPAIR_WHEEL_COMMAND_MACOS: ""
 
 # pass the `--lib-sdir .` flag to auditwheel on Linux
 CIBW_REPAIR_WHEEL_COMMAND_LINUX: "auditwheel repair --lib-sdir . -w {dest_dir} {wheel}"
+
 ```