doc: Add instructions for generating bindings

Describe what needs to be done to not break serialization support.

Signed-off-by: Patrick Roy <[email protected]>

Author: roypat

README.md

@@ -45,3 +45,30 @@ bindings happens as opaque binary blobs via [`zerocopy`](https://google.github.i
 Due to the kernel's ABI compatibility, this means that bindings serialized
 in version `x` of `kvm-bindings` can be deserialized in version `y` of the
 crate, even if the bindings have had been regenerated in the meantime.
+
+## Regenerating Bindings
+
+When regenerating bindings, care must be taken to re-add various `zerocopy`
+derives under the `with-serde` feature. All items that require derives are
+listed in the `x86_64/serialize.rs` and `arm64/serialize.rs` inside the
+`serde_impls!` macro invocation, and missing derives will cause these
+modules to fail compilation. For all items listed here, the following
+derive should be present:
+
+```rs
+#[cfg_attr(
+    feature = "with-serde",
+    derive(zerocopy::AsBytes, zerocopy::FromBytes, zerocopy::FromZeroes)
+)]
+```
+
+Any types whose name contains a suffix akin to `__bindgen_ty_<number>` and
+which is contained in any struct listed in `serialize.rs` will also need
+to have this derive added (otherwise compilation will fail). Note that
+these types are not explicitly listed in `serialize.rs`, as their names
+can change across `bindgen.rs` versions.
+
+Lastly, in `x86_64/bindings.rs`, the derives also need to be added to
+`struct __BindgenBitfieldUnit<Storage>` and `struct __IncompleteArrayField<T>`.
+Additionally, these structs need to have their layout changed from `#[repr(C)]`
+to `#[repr(transparent)]`.