krino: release 0.0.1 — man pages, install, examples, cross and release, README, changelogv0.0.1

Also: undo removes the directories its run created; a hardlink is never a
duplicate of its own other name; a flag written before "undo" is honoured;
--version prints no leading v. Duplicate conditions with different scopes
not sharing an original is documented as a known limitation.

1 files changed, 27 insertions, 0 deletions

diff --git a/examples/screenshots.conf b/examples/screenshots.conf
new file mode 100644
index 0000000..6532bab
--- /dev/null
+++ b/examples/screenshots.conf
@@ -0,0 +1,27 @@
+;; -*- mode: lisp -*-
+;; vim: set ft=lisp :
+;;
+;; screenshots.conf — rename screenshots by date, then file them by year.
+;;
+;; Demonstrates: (rename ...) with the {mtime:FMT} placeholder run before
+;; (move ...) — a rule's steps run in the order written, and a later step
+;; sees the name or path an earlier one just produced — so the date lands
+;; in the file's own name, not only in its destination.
+;;
+;; To use: copy this to dirs/<name>.conf, fix (path ...) below, and add
+;; <name> to (include ...) in krino.conf. A short tutorial on the syntax is
+;; docs/sexp-primer.md in the source repository, installed alongside this
+;; file at $PREFIX/share/doc/krino/sexp-primer.md; every form is described
+;; in krino.conf(5).
+
+(path "~/Pictures")             ; CHANGE THIS to the directory to sort
+
+;; Leave partial downloads and dotfiles alone.
+(ignore "*.part" "*.crdownload" "*.aria2" ".*")
+
+(rule "screenshots"
+  (when (type image)
+        (name "screenshot"))    ; case-insensitive by default; adjust to taste
+  (rename "{mtime:%Y-%m-%d}_{name}")
+  (move "Filed/Screenshots/{mtime:%Y}")
+  (stop))