Package: libarchive-tools
Version: 3.6.2-1
Severity: normal

Dear Maintainer,

Thanks for this, bsdcat fills the niche of generalised zcat much nicer
than whatever I'd come up with. However, to evaluate this
(and to actually try to consult the bsdcat manual for,
 for example, "what will it unpack")
is much more complicated than it ought to be.

The main issue is that 
  SEE ALSO
       bzcat(1), uncompress(1), xzcat(1), zcat(1), libarchive-formats(5)
points to libarchive-formats(5). This file is in libarchive-dev,
so you're SOL unless you manage to find that ‒ the procedure for this is
obvious to me, but may not be to everyone.

If you assume this is a complete list of the formats supported
you assume wrong, because zstdcat(1) is missing.

This is quite easy to solve IMO: libarchive-formats(5)
should live in the libarchive13 package
(or a libarchive-doc which is Recommends:ed by libarchive13
 for multiarch compat, you get my point),
since it's of general usefulness to all users using libarchive-using programs.

The second issue is that the SEE ALSO shouldn't point to
libarchive-formats(5), since that only describes archive formats,
not compression formats.

It should either point to libarchive(3)
(which for some reason isn't in libarchive-formats(5)'s SEE ALSO),
which should also live in libarchive13/libarchive-doc,
or libarchive-formats(5) should at least include a version of the
  The library automatically detects archives compressed with
  compress(1), bzip2(1), grzip(1), gzip(1), lrzip(1), lz4(1), lzip(1),
  lzop(1), xz(1), or zstd(1) and decompresses them transparently.
  Decompression of some formats requires external decompressor
  utilities. It can similarly detect and decode archives processed with
  uuencode(1) or which have an rpm(1) header.
sentence.

Thanks,
наб

-- System Information:
Debian Release: 12.2
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable-security'), (500, 
'stable-debug'), (500, 'stable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 6.1.0-9-amd64 (SMP w/24 CPU threads; PREEMPT)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_FIRMWARE_WORKAROUND, 
TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), 
LANGUAGE=en_GB:en
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages libarchive-tools depends on:
ii  libarchive13  3.6.2-1
ii  libc6         2.36-9+deb12u3

libarchive-tools recommends no packages.

libarchive-tools suggests no packages.

-- no debconf information

Attachment: signature.asc
Description: PGP signature

Reply via email to