about summary refs log tree commit diff stats
diff options
context:
space:
mode:
authorAndinus <andinus@nand.sh>2020-08-27 11:59:21 +0530
committerAndinus <andinus@nand.sh>2020-08-27 11:59:21 +0530
commit8f5f24d37ed0b5954ef3f90c9ea1021ad51b8617 (patch)
tree86a60e5cd69d304c1227e0901a3a3f761e26ad00
parent16112ec453264af340d66a0f625c4914a192ab98 (diff)
downloadleo-8f5f24d37ed0b5954ef3f90c9ea1021ad51b8617.tar.gz
Update README, add documentation
-rw-r--r--README74
1 files changed, 71 insertions, 3 deletions
diff --git a/README b/README
index 1520341..82ab261 100644
--- a/README
+++ b/README
@@ -1,10 +1,78 @@
-                               _________
-
+                               ━━━━━━━━━
                                   LEO
 
                                 Andinus
-                               _________
+                               ━━━━━━━━━
+
+
+Table of Contents
+─────────────────
+
+1 Documentation
+.. 1.1 archive
+.. 1.2 help
+.. 1.3 removed
+..... 1.3.1 sync functions
 
 
 Leo is a program to run my personal scripts. You might not find them
 useful, these were previously shell scripts that I rewrote in Perl.
+
+• Website: [https://andinus.nand.sh/leo]
+• Source: [https://git.tilde.institute/andinus/leo]
+• Source (mirror): [https://github.com/andinus/leo]
+
+
+1 Documentation
+═══════════════
+
+  There is a main dispatch table (`%dispatch') which has all the
+  functions.
+
+
+1.1 archive
+───────────
+
+  `archive' creates tar(1) files from a pre-defined list.
+  `%archive_dispatch' contains that list.
+
+  For example, `documents' will archive `$ENV{HOME}/documents' to
+  `/tmp/archive/documents_$ymd.tar' where `$ymd' is current date in
+  `YYYY-MM-DD' format.
+  ┌────
+  │ my %archive_dispatch = (
+  │     "documents" => sub {
+  │         tar_create("/tmp/archive/documents_$ymd.tar",
+  │                    "-C", "$ENV{HOME}/documents", ".");
+  │     },
+  │     ...
+  │ )
+  └────
+
+  I use this to quickly archive some of my files & copy them to another
+  computer as a backup.
+
+  There is no encryption or compression but it can be added directly to
+  `tar_create' function. I plan to add some encryption later. Currently
+  I store them locally (offline) so it's not required.
+
+
+1.2 help
+────────
+
+  Running just `leo' will print help. There is help message for
+  functions too, run `leo <function>' to print their help message. For
+  example, `leo archive' will print `archive''s help message.
+
+
+1.3 removed
+───────────
+
+  This contains the list of functions that were removed.
+
+
+1.3.1 sync functions
+╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌
+
+  There were sync functions, they synced some of my files to remote
+  servers. I replaced it with simple `sh' scripts instead.