Add a document about nightly feature

PyO3 · Jun 19, 2020 · e27c4d7 · e27c4d7
1 parent ac922e5
commit e27c4d7
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/guide/src/advanced.md b/guide/src/advanced.md
@@ -28,3 +28,9 @@ version = "0.8.1"
 extension-module = ["pyo3/extension-module"]
 default = ["extension-module"]
 ```
+
+## `nightly` flag
+
+`pyo3/nightly` feature needs nightly compiler, but enables some optimizations as follows:
+- `FromPyObject` for `Vec` and array is optimized when the object can be `PyBuffer`
+- `ToBorrowedObject`, used by `PyDict::set_item` or so, is optimized when the taken object is a Python native type.