borg2: how to refer to a specific archive when using archive series

[bentolor]

More a feedback (or alternatively just an exhibit of my dumbness):

borg repo-list
This command lists the archives contained in a repository.

root@neptun ~# borg repo-list
ea475845  Sun, 2025-11-30 17:14:10 +0100  neptun                       root        neptun
fb16e4fa  Sun, 2025-11-30 17:27:40 +0100  neptun                       root        neptun
f41ee4bd  Fri, 2025-12-05 08:23:35 +0100  neptun                       root        neptun
c6dff810  Thu, 2026-01-01 14:13:26 +0100  neptun                       root        neptun

borg diff
This command finds differences (file contents, metadata) between ARCHIVE1 and ARCHIVE2.

root@neptun ~ [4]# borg diff fb16e4fa ea475845
Command Error: ['fb16e4fa'] needed to match precisely one archive, but matched 0.

I'm confused and don't get it based on the documentation.

IMHO this should be a straightforward intuitive command chain.

[ThomasWaldmann]

borg2 still defaults to archive names.

But if one uses archive series (as one should), one can not use the name to refer to a specific archive, because the name is always the same within the series.

So, to refer to a specific archive id, one needs to give the archive id:

borg diff aid:fb16e4fa aid:ea475845

Abbreviating the archive id also works, as long as it matches only 1 archive (if the functionality expects one archive).