Add docstring for `encode_empty_shape`
diff --git a/vello_encoding/src/encoding.rs b/vello_encoding/src/encoding.rs
index d5c4684..8cf6aff 100644
--- a/vello_encoding/src/encoding.rs
+++ b/vello_encoding/src/encoding.rs
@@ -240,6 +240,11 @@
encoder.finish(true) != 0
}
+ /// Encode an empty path.
+ ///
+ /// This is useful for bookkeeping when a path is absolutely required (for example in
+ /// pushing a clip layer). It is almost always the case, however, that an application
+ /// can be optimized to not use this method.
pub fn encode_empty_shape(&mut self) {
let mut encoder = self.encode_path(true);
encoder.empty_path();