rmlint: update page (#10854)

* rmlint: add tagged example

* rmlint: clarify tagged concept

* rmlint: update page

Signed-off-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* rmlint: fix link

---------

Signed-off-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

pages/common/rmlint.md

@@ -1,11 +1,19 @@
 # rmlint
 
-> Identify duplicate files or directories, and other filesystem issues.
+> Find space waste and other broken things on your filesystem.
 > More information: <https://rmlint.readthedocs.io/en/latest/rmlint.1.html>.
 
-- Check a directory for duplicates, empty files, and other issues:
+- Check directories for duplicated, empty and broken files:
 
-`rmlint {{path/to/directory}}`
+`rmlint {{path/to/directory1 path/to/directory2 ...}}`
+
+- Check for space wasters, preferably keeping files in tagged directories (after the double slash):
+
+`rmlint {{path/to/directory}} // {{path/to/original_directory}}`
+
+- Check for space wasters, keeping everything in the untagged directories:
+
+`rmlint --keep-all-untagged {{path/to/directory}} // {{path/to/original_directory}}`
 
 - Delete duplicate files found by an execution of `rmlint`:
 
@@ -15,18 +23,14 @@
 
 `rmlint --merge-directories {{path/to/directory}}`
 
-- Mark files at lower path [d]epth as originals:
+- Mark files at lower path [d]epth as originals, on tie choose shorter [l]ength:
 
-`rmlint --rank-by={{d}} {{path/to/directory}}`
-
-- Mark files with shortest name [l]ength as originals:
-
-`rmlint --rank-by={{l}} {{path/to/directory}}`
+`rmlint --rank-by={{dl}} {{path/to/directory}}`
 
 - Find only duplicates that have the same filename in addition to the same contents:
 
 `rmlint --match-basename {{path/to/directory}}`
 
-- Find all duplicates with the same extension:
+- Find only duplicates that have the same extension in addition to the same contents:
 
 `rmlint --match-extension {{path/to/directory}}`