docs(tvix/nix-compat): document the name ordering requirement
Change-Id: Ia2c5f0b357a23d4bfac1fd52cf01845c78ebfa22 Reviewed-on: https://cl.tvl.fyi/c/depot/+/9612 Autosubmit: edef <edef@edef.eu> Tested-by: BuildkiteCI Reviewed-by: flokli <flokli@flokli.de>
This commit is contained in:
parent
49b106b0cb
commit
ca1ede17cb
1 changed files with 4 additions and 0 deletions
|
@ -163,6 +163,10 @@ impl<'a, 'w> Directory<'a, 'w> {
|
|||
///
|
||||
/// The entry is simply another [`Node`], which can then be filled like the
|
||||
/// root of a NAR (including, of course, by nesting directories).
|
||||
///
|
||||
/// It is the caller's responsibility to ensure that directory entries are
|
||||
/// written in order of ascending name. If this is not ensured, this method
|
||||
/// may panic or silently produce invalid archives.
|
||||
pub fn entry(&mut self, name: &[u8]) -> io::Result<Node<'_, 'w>> {
|
||||
debug_assert!(
|
||||
name.len() <= wire::MAX_NAME_LEN,
|
||||
|
|
Loading…
Reference in a new issue