pub fn document_in(archive: &[u8]) -> Result<Document>Expand description
The document an archive holds.
Laid down in memory and opened exactly as the library opens one, so what
an archive reads as and what it opens as cannot come apart. Reading
one file off the top would be cheaper, and was how this started: the
container used to carry a pretty-printed copy of its head beside the
revs. That copy was allowed to fall behind, so an archive packed between
an edit and the save after it read as a drawing missing its most recent
edits — and the file is gone now
(docs/retire-projection-playbook.md).
§Errors
std::io::ErrorKind::InvalidData for an archive that is not a
container, and for a container that will not open.