hyprpaper: document wallpaper#paths

Author: y0usaf

content/Hypr Ecosystem/hyprpaper.md

@@ -43,11 +43,12 @@ Wallpapers are set as anonymous special categories. Monitor can be left empty fo
 | variable | description | value |
 | --- | --- | --- |
 | `monitor` | Monitor to display this wallpaper on. If empty, will use this wallpaper as a fallback | monitor ID |
-| `path` | Path to an image file or a directory containing image files | path |
+| `path` | Path to an image file or a directory containing image files. Mutually exclusive with `paths` | path |
+| `paths` | Comma-separated list of image files and/or directories. Picks one wallpaper for the current run. Mutually exclusive with `path` | string |
 | `fit_mode` | Determines how to display the image. Optional and defaults to `cover` | `contain`\|`cover`\|`tile`\|`fill` |
-| `timeout` | Timeout between each wallpaper change (in seconds, if `path` is a directory). Optional and defaults to 30 seconds | int |
-| `order`    | Determines the order to display images when a directory is passed to the `path` option. Optional, currently only supported value is `random` | `random`                             |
-| `recursive` | Whether to scan subdirectories recursively when `path` is a directory. Optional and defaults to `false` | bool |
+| `timeout` | Timeout between each wallpaper change (in seconds, if `path` is a directory). Optional and defaults to 30 seconds. Does not apply to `paths` | int |
+| `order`    | Determines the order to display images when `path` is a directory. For `paths`, supported values are `default` and `random`; `random` picks one for the current run | `random`\|`random-shuffle` |
+| `recursive` | Whether to scan subdirectories recursively when `path` points to a directory or `paths` contains directories. Optional and defaults to `false` | bool |
 
 ```ini
 wallpaper {
@@ -62,6 +63,13 @@ wallpaper {
     fit_mode = cover
 }
 
+wallpaper {
+    monitor = DP-1
+    paths = ~/wallpapers/favs, ~/wallpapers/one.jxl, ~/wallpapers/two.jxl
+    fit_mode = cover
+    order = random
+}
+
 wallpaper {
     monitor = 
     path = ~/fallback.jxl