diff options
| -rw-r--r-- | system/rmw/README | 13 | ||||
| -rw-r--r-- | system/rmw/README.Slackware | 154 | ||||
| -rw-r--r-- | system/rmw/rmw.SlackBuild | 3 | ||||
| -rw-r--r-- | system/rmw/rmw.info | 6 | ||||
| -rw-r--r-- | system/rmw/slack-desc | 14 |
5 files changed, 132 insertions, 58 deletions
diff --git a/system/rmw/README b/system/rmw/README index fc7ef5356f..58925fd054 100644 --- a/system/rmw/README +++ b/system/rmw/README @@ -1,7 +1,6 @@ -Rmw is a program written in C, designed to help manage your files and -prevent accidents at the command line. Rmw can send files to your "Desktop" -trash, or a completely separate folder. It can also: restore files; permanently -delete files that were rmw'ed more than xx number of days ago; skip files or -directories that have a "PROTECT" directive in the configuration file; and -append a unique string to the filenames so they won't get overwritten -(duplication protection). +rmw is an OS portable cli trash can utility written in C. It can send files to +your "Desktop" trash, or a completely separate folder. It can also: restore +files; permanently delete files that were rmw'ed more than xx number of days +ago; skip files or directories that have a "PROTECT" directive in the +configuration file; and append a unique string to the filenames so they won't +be overwritten (duplication protection). diff --git a/system/rmw/README.Slackware b/system/rmw/README.Slackware index 1ae90e2390..09bd495fd7 100644 --- a/system/rmw/README.Slackware +++ b/system/rmw/README.Slackware @@ -1,18 +1,73 @@ -Rmw is a program written in C, designed to help manage your files and -prevent accidents at the command line. Rmw can send files to your "Desktop" -trash, or a completely separate folder. It can also: restore files; permanently -delete files that were rmw'ed more than xx number of days ago; skip files or -directories that have a "PROTECT" directive in the configuration file; and -append a unique string to the filenames so they won't get overwritten -(duplication protection). +# rmw 0.4.01 + +rmw is an OS portable cli trash can utility written in C. It can send files to +your "Desktop" trash, or a completely separate folder. It can also: restore +files; permanently delete files that were rmw'ed more than xx number of days +ago; skip files or directories that have a "PROTECT" directive in the +configuration file; and append a unique string to the filenames so they won't +be overwritten (duplication protection). Web site: https://github.com/andy5995/rmw/wiki -See the NEWS file for details about new options for your existing -rmw configuration file. The two new options are: +Anyone interested in this project is welcome to join the [chat +room](https://join.slack.com/t/removetowaste/shared_invite/enQtMjU3NTA0NTI2OTgzLTkzMzQxNDhjYzlkM2UxMTA2MzJjNWYyZjAyYzkyNWNmZjJmYWZmYjUyODk2NzNkNzBhMzFjOGZkMTg2MzAxMTM). -force_not_required -,removable (the leading comma is mandatory) +If you would like to help translate the man page or the output messages for +this program, please see the [Translating wiki +page](https://github.com/andy5995/rmw/wiki/Translating). + +## Required libraries + +libncurses5 + +If you are building from source, you will need the libncurses(5 or 6)-dev +package from your operating system distribution. + +## Installation + +### With superuser privileges: + +Use `./configure --help` to view available compile-time options. + + ./configure --prefix=/usr --sysconfdir=/etc + make + make install + +If the --prefix and --sysconfdir options are omitted, "/usr/local" will be +used instead. If you are using **MacOSX** and have problems installing to +/usr/bin, try omitting those two options. + +### As a normal user: + + ./configure --prefix=$HOME/usr + make + make install + +rmw will be installed to $HOME/usr/bin and the configuration file will be +copied to $HOME/usr/etc + +### Pre-built binary packages + +Packages for some operating systems are available on the +[Downloads](https://github.com/andy5995/rmw/releases) page + +## Uninstall / Cleaning up + + make uninstall + make distclean +``` +man pages are now available in the following languages: + + * de + * en + * es + * fi + * ne + * nl_NL + * pl + * pt_BR + +If you installed rmw as a normal user, this next step can be skipped. After rmw is installed, create the user configuration directory by typing 'rmw' and hitting enter. Afterward, it's recommended to copy /etc/rmwrc (or @@ -29,8 +84,7 @@ in that same directory. == Configuration File == -Documentation explaining the configuration can be found in 'rmwrc', and -extra examples in 'rmwrc_config_example'. +Documentation explaining the configuration can be found in 'etc/rmwrc' Waste folders will be created automatically. (e.g. if '$HOME/trash.rmw' is listed in the config file, these 3 directories will be created: @@ -38,43 +92,52 @@ $HOME/trash.rmw $HOME/trash.rmw/files $HOME/trash.rmw/info -If one of the WASTE folder is on removable media, then the user has the -option of appending ',removable' (More info about that in rmwrc, included -with the rmw package). - -== Purging == - -If purging is 'on', rmw will permanently delete files from the folders -specified in the configuration file after 'x' number of days. Purging -can be disabled by using 'purge_after = 0' in configuration file. rmw will -only check once per day if it's time to purge (use -g to check more often). -Purge requires -f (--force) to run (in your rmw configuration file, add -the line 'force_not_required' if you'd rather not use --force when purging). - -The day of the last purge is stored in $HOME/config/rmw/lastpurge +If one of the WASTE folders is on removable media, then the user has the +option of appending ',removable' (details in etc/rmwrc). == Features and Options == -h, --help +-t, --translate display a translation of the configuration file -c, --config filename use an alternate configuration -l, --list list waste directories --p, --pause wait for a keypress before exiting -g, --purge run purge even if it's been run today +-o, --orphaned check for orphaned files (maintenance) -f, --force allow purge to run --i, --interactive not implemented --r, --recurse not implemented -B, --bypass bypass directory protection -v, --verbose increase output messages -w, --warranty display warranty -V, --version display version and license information - ===] Restoring [=== + ===] Restoring [=== -z, --restore <wildcard filename(s) pattern> -s, --select select files from list to restore -u, --undo-last undo last ReMove +== Purging == + +If purging is 'on', rmw will permanently delete files from the folders +specified in the configuration file after 'x' number of days. Purging can be +disabled by using 'purge_after = 0' in configuration file. rmw will only check +once per day if it's time to purge (use -g to check more often). + +Purge requires -f (--force) to run. + +To skip that requirement, add the line + +force_not_required + +to your configuration file. + +The day of the last purge is stored in $HOME/config/rmw/lastpurge + +== Empty the Trash == + +To empty the trash completely, rmw can use the environmental variable +RMWTRASH. Usage: +RMWTRASH=empty rmw -fg == -z option == @@ -84,22 +147,33 @@ e.g. 'rmw -z ~/.local/share/Trash/files/foo*' Files can also be restored using only the basename, from within any directory. NOTE: That feature will not process wildcards unless the user is in a -<WASTE>/files folder and the filespec actually exists in the present -working directory. +<WASTE>/files folder and the filespec actually exists in the present working +directory. == Protected directories == -explained: -if 'PROTECT = /home/andy' is specified in the config file, /home/andy, and -all dirs and files beneath it will be "protected". This warning will show -up: +If 'PROTECT = /home/andy' is specified in the config file, /home/andy, and all +dirs and files beneath it will be "protected"; they will be skipped, and this +warning will be displayed: "File is in protected directory: <filename/dir>" -And it will not get rmw'ed - WASTE folders and the rmw configuration/data directory are protected by default (there is no need to add a 'PROTECT =' line for them. +Protection can by bypassed using -B + +== -t, --translate == + +If a translation of the configuration file is available in your native +language is available, it will be displayed. + +(If you would be interested in adding a translation, please visit +https://github.com/andy5995/rmw/wiki/Translating) + +== -f, --force == +rmw will normally refuse to purge directories if they contain non-writable +subdirectories. You can use -f 2 times if you ever see a message that tells +you "permission denied; directory still contains files" (e.g. rwm -gff). -This file was last updated 2016-09-19 +``` diff --git a/system/rmw/rmw.SlackBuild b/system/rmw/rmw.SlackBuild index 5b5beda928..27943fa9e3 100644 --- a/system/rmw/rmw.SlackBuild +++ b/system/rmw/rmw.SlackBuild @@ -5,7 +5,7 @@ # Written by (Andy Alt) (andy400-dev@yahoo.com) PRGNAM=rmw -VERSION=${VERSION:-2016.09.19.01a} +VERSION=${VERSION:-0.4.01} BUILD=${BUILD:-1} TAG=${TAG:-_SBo} @@ -56,6 +56,7 @@ CXXFLAGS="$SLKCFLAGS" \ ./configure \ --prefix=/usr \ --sysconfdir=/etc \ + --mandir=/usr/man \ --docdir=/usr/doc/$PRGNAM-$VERSION \ --build=$ARCH-slackware-linux diff --git a/system/rmw/rmw.info b/system/rmw/rmw.info index 4855b7ad3a..47671e219e 100644 --- a/system/rmw/rmw.info +++ b/system/rmw/rmw.info @@ -1,8 +1,8 @@ PRGNAM="rmw" -VERSION="2016.09.19.01a" +VERSION="0.4.01" HOMEPAGE="https://github.com/andy5995/rmw/wiki" -DOWNLOAD="https://sourceforge.net/projects/rmw/files/rmw-2016.09.19.01a.tar.gz" -MD5SUM="f6d5389674e81fb5d523d142a1e63c1a" +DOWNLOAD="https://sourceforge.net/projects/rmw/files/rmw-0.4.01.tar.gz/download" +MD5SUM="f21d06ce9021cfcd0848545070b1f675" DOWNLOAD_x86_64="" MD5SUM_x86_64="" REQUIRES="" diff --git a/system/rmw/slack-desc b/system/rmw/slack-desc index 600845b117..39ea8f8cb2 100644 --- a/system/rmw/slack-desc +++ b/system/rmw/slack-desc @@ -8,12 +8,12 @@ |-----handy-ruler------------------------------------------------------| rmw: rmw (command line trash can/recycle bin) rmw: -rmw: Rmw is a program written in C, designed to help manage your files and -rmw: prevent accidents at the command line. Rmw can send files to your -rmw: "Desktop" trash, or a completely separate folder. It can also: -rmw: restore files; permanently delete files that were rmw'ed more than xx -rmw: number of days ago; skip files or directories that have a "PROTECT" -rmw: directive in the configuration file; and append a unique string to -rmw: the filenames so they won't get overwritten (duplication protection) +rmw: rmw is an OS portable cli trash can utility written in C. It can send +rmw: files to your "Desktop" trash, or a completely separate folder. It +rmw: can rmw: also: restore files; permanently delete files that were +rmw: rmw'ed more than xx number of days ago; skip files or directories +rmw: that have a "PROTECT" directive in the configuration file; and append +rmw: a unique string to the filenames so they won't be overwritten +rmw: (duplication protection). rmw: rmw: Homepage: https://github.com/andy5995/rmw/wiki |