Package: aria2 Version: 1.36.0-1 Severity: wishlist Tags: upstream X-Debbugs-Cc: debbug.ar...@sideload.33mail.com
The -o option is documented as follows: ===8<---------------------------------------- -o, --out=<FILE> The file name of the downloaded file. It is always relative to the directory given in --dir option. When the --force-sequential option is used, this option is ignored. NOTE: You cannot specify a file name for Metalink or BitTorrent downloads. The file name specified here is only used when the URIs fed to aria2 are given on the command line directly, but not when using --input-file, --force-sequential op‐ tion. Example: $ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip" ===8<---------------------------------------- There is an ambiguity in the first sentence: “The file name of the downloaded file.” It’s unclear from that phrasing if the parameter will be taken as the name of the source file or the a potentially new name. The example disambiguates it but it would be better if the wording were more clear to begin with so readers are not confused until they study the example. Simply changing it to: “The name to give the downloaded file” would make a difference. I also suggest introducing a pattern substitution mechanism. It’s very common to want to preserve the original filename but add something to the name to clarify what it is. For example, consider this file: http://download.virtualbox.org/virtualbox/UserManual.pdf It’s contextually clear from the source path that it’s a user manual for vbox. But we typically do not want to preserve the original path. A good filename to produce would be: virtualbox_UserManual.pdf But if there are a lot of files it’s tedious to copy-paste and error prone to retype them. If a token like “%o” were designated to hold the original basename, a user could simply write: -o virtualbox_%o. -- System Information: Debian Release: 12.5 APT prefers stable-updates APT policy: (990, 'stable-updates'), (990, 'stable-security'), (990, 'stable'), (500, 'oldstable') Architecture: amd64 (x86_64) Foreign Architectures: i386 Kernel: Linux 5.10.0-28-amd64 (SMP w/2 CPU threads) Kernel taint flags: TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set Shell: /bin/sh linked to /usr/bin/dash Init: systemd (via /run/systemd/system) LSM: AppArmor: enabled Versions of packages aria2 depends on: ii libaria2-0 1.36.0-1 ii libc6 2.36-9+deb12u6 ii libgcc-s1 12.2.0-14 ii libstdc++6 12.2.0-14 Versions of packages aria2 recommends: ii ca-certificates 20230311 aria2 suggests no packages. -- no debconf information