README

README.md

@@ -79,7 +79,16 @@ Choices are entered in the following ways:
 *   click on the **`Choices`** button to add a selection of file paths to the current **choices**;
 *   Go to **`File->Choices->Choices from Directory`** menu to add file paths from a selected folder to the current **choices**;
 *   Go to **`File->Choices->Choices from Clipboard`** menu to add files paths from clipboard to the current **choices**. If clipboard contains a folder, then the file paths of the files inside this folder are added;
-*   Go to **`File->Choices->Choices from File`** menu to import choices from a CSV (or XLSX, TXT) file (one choice per row). If 2 values per line (comma separated) the first value is the string used for comparison and the second one is the string used for renaming (=alias). For example, if a candidate to rename is `3DWorldRunner.png` and best choice is `3-D Battles of World Runner, The` but the rename need to be the name 3dbatworru.png, then the CSV should contain a line like `"3-D Battles of World Runner, The", 3dbatworru`;
+*   Go to **`File->Choices->Choices from File`** menu to import choices from a CSV (or XLSX, TXT) file
+    *   Each row or line of the file defined one **choice**;
+    *   A **choice** containing space characters must be surrounded by double-quotes;
+    *   If a line contains a single value, this value is the **choice**;
+    *   If a line contains two values separated by a comma, the first value is the **choice** (=string used for comparison) and the second one is the **choice alias** (=string used for renaming);
+
+        for example, if a candidate to rename is `3DWorldRunner.png` and best **choice** is `3-D Battles of World Runner, The` but one wants to rename the file as `3dbatworru.png`, then the CSV should contain a line like `"3-D Battles of World Runner, The", 3dbatworru`;
+    *   It is possible to define the text of the tooltip shows when hovering over a matched **choice**. Just include the specific text between /* */ in the **choice** name.;
+
+        for example, if the **choice** name is `"Choice Name /* Tooltip text line 1 Tooltip text line 2*/"`, the tooltip will show the lines `"Tooltip text line 1"` and `"Tooltip text line 2"` when hovering over this matched **choice**.
 *   Go to **`File->Choices`** menu to add recently selected folders to the current **choices**;
 *   Drag files or folders into application panel and choose **`Choices`** to add file paths to the current **choices**. For folders, the file paths of the files inside folders are added;
 *   Paste (Ctrl+V) into application panel and choose **`Choices`** to add file paths or folders in clipboard to the current **choices**. For folders, the file paths of the files inside folders are added