summaryrefslogtreecommitdiff
path: root/system
diff options
context:
space:
mode:
Diffstat (limited to 'system')
-rw-r--r--system/rmw/README13
-rw-r--r--system/rmw/README.Slackware154
-rw-r--r--system/rmw/rmw.SlackBuild3
-rw-r--r--system/rmw/rmw.info6
-rw-r--r--system/rmw/slack-desc14
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