Man page refers to "trash-restore" instead of "restore-trash"

[David D Lowe]

At the end of the manpage for "trash", this section is included:

SEE ALSO
       trash-list(1), trash-restore(1), trash-empty(1), and the FreeDesktop.org Trash Specification at http://www.ramendik.ru/docs/trashspec.html.

This should be fixed to replace trash-restore with restore-trash.

ProblemType: Bug
DistroRelease: Ubuntu 13.04
Package: trash-cli 0.12.7-1
ProcVersionSignature: Ubuntu 3.8.0-27.40-generic 3.8.13.4
Uname: Linux 3.8.0-27-generic x86_64
NonfreeKernelModules: nvidia
ApportVersion: 2.9.2-0ubuntu8.1
Architecture: amd64
Date: Fri Aug 2 10:18:15 2013
InstallationDate: Installed on 2013-06-20 (42 days ago)
InstallationMedia: Ubuntu 13.04 "Raring Ringtail" - Release amd64 (20130424)
MarkForUpload: True
PackageArchitecture: all
SourcePackage: trash-cli
UpgradeStatus: No upgrade log present (probably fresh install)

[Andreas Moog (ampelbein)]

Thanks for the report, I opened an issue on the upstream bugtracker at https://github.com/andreafrancia/trash-cli/issues/20. I do not think that this issue warrants a distribution specific patch (it is a very minor issue).

[My name (plmalternate)]

According to Francia upstream, this IS a specific Ubuntu problem, because it was fixed upstream a while back. He says the version Ubuntu is using:

" is very old, is from 2012, unfortunately seems that Ubuntu is still using a old version in its distribution. The current version is 0.17.1.14."

from:
https://github.com/andreafrancia/trash-cli/issues/101

So, no, it doesn't need a "patch" per se, unless I misunderstand the term, it just needs to be replaced with the current version instead of one 5 years old.

[My name (plmalternate)]

And BTW, this is still the case in Xenial, 64 bit version. I wonder how many man-hours have been wasted by people trying to figure out how to use "trash-restore". Probably something under 1 in most individual cases, but how many cases are there? Surely not just the few that reached this page. Most probably either figured it out by reading at github or gave up before getting here.

[David D Lowe (flimm)]

Thank you for looking at this! This is indeed fixed now.

In Ubuntu 23.04 , the correct command to use is "trash-restore", which is the command that upstream uses. The correct commands all start with the `trash-` prefix:

trash-put
trash-empty
trash-list
trash-restore
trash-rm

The package that Ubuntu 23.04 ships is trash-cli 0.17.1.14-5build1 . trash-cli 0.17.1.14 was released upstream 14 January 2017, so it's still old (five years old), but at least it's not 11 years old. The latest upstream release is from 23 September 2023.