From 3d6809694f058b433d67d96cf42524ec33611f06 Mon Sep 17 00:00:00 2001 From: Andy Alt Date: Fri, 7 Dec 2018 23:00:24 +0700 Subject: system/rmw: Updated for version 0.7.01. Signed-off-by: Willy Sudiarto Raharjo --- system/rmw/README.Slackware | 107 ++++++++++++++++++++++---------------------- 1 file changed, 54 insertions(+), 53 deletions(-) (limited to 'system/rmw/README.Slackware') diff --git a/system/rmw/README.Slackware b/system/rmw/README.Slackware index c7c03d8d8f40..d1e8f1c504a1 100644 --- a/system/rmw/README.Slackware +++ b/system/rmw/README.Slackware @@ -1,49 +1,63 @@ -[![Build Status](https://travis-ci.org/theimpossibleastronaut/rmw.svg?branch=master)](https://travis-ci.org/theimpossibleastronaut/rmw) -[![Build Status](https://semaphoreci.com/api/v1/andy5995/rmw-3/branches/master/badge.svg)](https://semaphoreci.com/andy5995/rmw-3) +# rmw v0.7.01 -# rmw v0.4.05 +rmw (ReMove to Waste) is a cross-platform command-line "trash can" +utility. It can send files to your "Desktop" trash, or a completely +separate folder; restore files and append a unique string to the +filenames so they won't be overwritten (duplication protection). -rmw is a cross-platform command-line "trash can" utility. 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 x 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://remove-to-waste.info/ -Web site: https://github.com/theimpossibleastronaut/rmw/wiki +## Build Status -Anyone interested in this project is welcome to join the [Matrix chat -room](https://matrix.to/#/!XeJxcdkywroPaRKKtr:matrix.org). +* [Travis Build](https://travis-ci.org/theimpossibleastronaut/rmw) ![Build Status](https://travis-ci.org/theimpossibleastronaut/rmw.svg?branch=master) +* [Semaphore Build](https://semaphoreci.com/andy5995/rmw-3) ![Build Status](https://semaphoreci.com/api/v1/andy5995/rmw-3/branches/master/badge.svg) -## For Translators +## Screenshots -We use Transifex to translate the output messages. To start translating -rmw, ​create an account in Transifex and ask to join a translation -team (or create a new one) at -https://www.transifex.com/na-309/rmw/ +![rmw usage output](https://remove-to-waste.info/images/Screenshot_2018-11-01_21-45-05_911x795.png) +[More Screenshots](https://remove-to-waste.info/screenshots.html) + +## Contact / Support + +See website [Help and Support section](https://remove-to-waste.info/#support) ## Required libraries -libncurses5 +libncursesw -If you are building from source, you will need the libncurses(5 or 6)-dev +If you are building from source, you will need the libncursesw(5 or 6)-dev package from your operating system distribution. -## Installation +Note: On OpenBSD, you must precede `./configure` with `MENU_LIBS=-lmenuw`. +Example: -### With superuser privileges: + MENU_LIBS=-lmenuw ./configure -Use `./configure --help` to view available compile-time options. +Note: rmw has been built on Windows 2 years ago using Cygwin but it +didn't use the proper directories. We have no Windows developers +working on this project and are hoping that some will join soon!. As +stated in the description, the goal of this project is a +"cross-platform" utility; so getting rmw to work reliably on Windows is +still on the TODO list. - ./configure - make - make install +## Compiling ### As a normal user: - ./configure --prefix=$HOME/usr +Use `../configure --help` to view available compile-time options. + + mkdir build + cd build + ../configure + make + +### Installing without superuser privileges + +If you would like to install rmw without superuser privileges, use a prefix +that you have write access to. Example: + + ../configure --prefix=$HOME/usr make make install @@ -75,16 +89,8 @@ Add a tap and install rmw: 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, copy rmwrc to -$HOME/.config/rmw and rename it to 'config': - - cd ~/.config/rmw - ~/.config/rmw$ cp rmwrc config - -Then edit the file to suit your needs. - -rmw will automatically create a 'lastpurge' and 'lastrmw' in that same -directory. +typing 'rmw' and hitting enter. A configuration file will be +automatically created in $HOME/.config/rmw. Edit the file as desired. == Configuration File == @@ -116,7 +122,6 @@ Restore FILE(s) from a WASTE directory -g, --purge run purge even if it's been run today -o, --orphaned check for orphaned files (maintenance) -f, --force allow purge to run --B, --bypass bypass directory protection -v, --verbose increase output messages -w, --warranty display warranty -V, --version display version and license information @@ -162,30 +167,26 @@ NOTE: That feature will not process wildcards unless the user is in a /files folder and the filespec actually exists in the present working directory. -== Protected directories == - -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: " - -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. +A translation of the configuration file in your native +language (if available) will be displayed. (If you would be interested in adding a translation, please visit https://github.com/theimpossibleastronaut/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). +## Notes + +After you use rmw, it will create a 'lastpurge' and 'lastrmw' file in +$HOME/config/rmw. `lastpurge` contains the day of the last time rmw did +a purge check (it only checks once per day). `lastrmw` contains the +filenames of the last rmw operation; the file is read when `rmw -u` is +used. + ``` -- cgit v1.2.3