about summary refs log tree commit diff stats
path: root/README
diff options
context:
space:
mode:
authorAndinus <andinus@nand.sh>2020-10-08 16:42:53 +0530
committerAndinus <andinus@nand.sh>2020-10-08 16:42:53 +0530
commit44d2fb9a47b45c693860f5e2e27b1218ee488c84 (patch)
tree8fd882a94ced2cecf61372be75c89a6012f179b5 /README
parent6c9ce6ace5bffde393ce7354b18da55418e89d61 (diff)
downloadleo-44d2fb9a47b45c693860f5e2e27b1218ee488c84.tar.gz
Update README, add install instructions v0.1.0
Diffstat (limited to 'README')
-rw-r--r--README112
1 files changed, 54 insertions, 58 deletions
diff --git a/README b/README
index b76888d..a2e02c8 100644
--- a/README
+++ b/README
@@ -8,42 +8,44 @@
 Table of Contents
 ─────────────────
 
-1 Demo
-2 Documentation
-.. 2.1 Profile
-.. 2.2 Options
-..... 2.2.1 encrypt/sign
-..... 2.2.2 delete
-..... 2.2.3 help
-.. 2.3 Configuration
-3 Example
-4 History
+1. Installation
+2. Documentation
+.. 1. Profile
+.. 2. Options
+..... 1. encrypt/sign
+..... 2. delete
+..... 3. help
+3. Example
+4. Demo
+5. History
 
 
 Leo is a simple backup program. It creates tar(1) files from a
 pre-defined list. It can encrypt/sign files with gpg2(1).
 
-• Web-site: [https://andinus.nand.sh/leo]
-• Source: [https://git.tilde.institute/andinus/leo]
-• Source (mirror): [https://github.com/andinus/leo]
-
-
-1 Demo
-══════
-
-  It's very easy to setup `leo', I made a demo video to show this. I
-  already have Perl environment setup for this.
+• Web-site: <https://andinus.nand.sh/leo>
+• Source: <https://git.tilde.institute/andinus/leo>
+• Source (mirror): <https://github.com/andinus/leo>
 
-  *Note*: It's even more easy now, you don't have to create profiles
-  anymore.
 
-  • Leo 2020-08-31: [https://asciinema.org/a/F97hVfgXDcd9g5IlST1t27ps3]
+1 Installation
+══════════════
 
-  You can also download the [cast file] directly & play it with
-  `asciinema'.
-
-
-[cast file] https://andinus.nand.sh/static/leo/2020-08-31_leo-demo.cast
+  ┌────
+  │ # Install all the dependencies. (OpenBSD)
+  │ doas pkg_add p5-IPC-Run3 p5-Config-Tiny p5-Path-Tiny
+  │
+  │ # Clone the project.
+  │ git clone https://git.tilde.institute/andinus/leo && \
+  │     cd leo
+  │
+  │ # Copy the config.
+  │ cp share/leo.conf $HOME/.config/leo.conf
+  │
+  │ # Copy the script & make it executable.
+  │ cp leo.pl $HOME/bin/leo && \
+  │     chmod +x $HOME/bin/leo
+  └────
 
 
 2 Documentation
@@ -62,10 +64,8 @@ pre-defined list. It can encrypt/sign files with gpg2(1).
 
   You can run `help' to see all the profiles along with the paths.
 
-  Creating profiles is not required anymore, you can pass it
-  file/directory name. Not all kinds of path can be passed. For example,
-  `leo documents/test.txt' is not okay but `cd documents' & then `leo
-  test.txt' is okay.
+  Creating profiles is not required anymore, you can pass it any file in
+  current directory & it'll create a temporary profile.
 
 
 2.2 Options
@@ -93,10 +93,6 @@ pre-defined list. It can encrypt/sign files with gpg2(1).
    0' to `@options'. `-z' specifies the compression level & 0 means no
    compression.
 
-  *Note*: My journal is encrypted so to prevent re-encryption `encrypt'
-   option is not passed to gpg2. This only affects journal profile. So
-   `leo --encrypt journal pass' will still encrypt pass.
-
 
 2.2.2 delete
 ╌╌╌╌╌╌╌╌╌╌╌╌
@@ -111,27 +107,6 @@ pre-defined list. It can encrypt/sign files with gpg2(1).
   Running just `leo' will print help.
 
 
-2.3 Configuration
-─────────────────
-
-  There is an example config file under `share/config.pl', move it to
-  config directory & rename to `leo.pl'.
-
-  ┌────
-  │ cp share/config.pl $HOME/.config/leo.pl # Copy the config.
-  │ chmod -w $HOME/.config/leo.pl # Make it read-only.
-  └────
-
-  *Warning*: Leo will evaluate the configuration file, which means an
-  attacker can use it to run malicious code.
-
-  *Note*: They could always add malicious code to `.profile' & do harm.
-  Just thought I should put the warning.
-
-  To edit the config run `chmod +w' on it but please make it read-only
-  again after editing.
-
-
 3 Example
 ═════════
 
@@ -150,7 +125,26 @@ pre-defined list. It can encrypt/sign files with gpg2(1).
   └────
 
 
-4 History
+4 Demo
+══════
+
+  It's very easy to setup `leo', I made a demo video to show this. I
+  already have Perl environment setup for this.
+
+  *Note*: It's even more easy now, you don't have to create profiles
+  anymore.
+
+  • Leo 2020-08-31: <https://asciinema.org/a/F97hVfgXDcd9g5IlST1t27ps3>
+
+  You can also download the [cast file] directly & play it with
+  `asciinema'.
+
+
+[cast file]
+<https://andinus.nand.sh/static/leo/2020-08-31_leo-demo.cast>
+
+
+5 History
 ═════════
 
   This was Leo's initial description:
@@ -171,3 +165,5 @@ pre-defined list. It can encrypt/sign files with gpg2(1).
   Later on the same day I removed dispatch table & switched to using
   simple hash of lists to store backup paths mapped to profiles. And
   also changed the word "archive" to "backup" everywhere.
+
+  I added a simple INI based config file before 0.1.0 release.
5 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445