From 3368af177773d26d1c507a2c2372b3bbfcff2fd8 Mon Sep 17 00:00:00 2001 From: Andinus Date: Thu, 27 Aug 2020 13:49:50 +0530 Subject: Update README, add History --- README | 56 ++++++++++++++++++++++++-------------------------------- 1 file changed, 24 insertions(+), 32 deletions(-) diff --git a/README b/README index 82ab261..66a474d 100644 --- a/README +++ b/README @@ -9,16 +9,14 @@ Table of Contents ───────────────── 1 Documentation -.. 1.1 archive -.. 1.2 help -.. 1.3 removed -..... 1.3.1 sync functions +.. 1.1 help +2 History -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. +Leo is my archival program. It creates tar(1) files from a pre-defined +list. -• Website: [https://andinus.nand.sh/leo] +• Web-site: [https://andinus.nand.sh/leo] • Source: [https://git.tilde.institute/andinus/leo] • Source (mirror): [https://github.com/andinus/leo] @@ -26,21 +24,15 @@ useful, these were previously shell scripts that I rewrote in Perl. 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. + `%dispatch' has the pre-defined list. Learn the list directly from + `leo.pl', it's self-explanatory. Or check the sub `HelpMessage', it + explains what each command does. 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 = ( + │ my %dispatch = ( │ "documents" => sub { │ tar_create("/tmp/archive/documents_$ymd.tar", │ "-C", "$ENV{HOME}/documents", "."); @@ -52,27 +44,27 @@ useful, these were previously shell scripts that I rewrote in Perl. 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 +1.1 help ──────── - Running just `leo' will print help. There is help message for - functions too, run `leo ' to print their help message. For - example, `leo archive' will print `archive''s help message. + Running just `leo' will print help. -1.3 removed -─────────── +2 History +═════════ - This contains the list of functions that were removed. + This was Leo's initial description: + 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. -1.3.1 sync functions -╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌ + I had created a sync function initially & was going to expand it. Then + I decided to remove those sync functions because it was too complex, I + replaced then with simple `sh' scripts. - There were sync functions, they synced some of my files to remote - servers. I replaced it with simple `sh' scripts instead. + I added a simple `archive' function later & decided to turn Leo into + that function. So, it's not a meta-program anymore. I was thinking of + creating something that does all the things for me but that'll be too + complex. -- cgit 1.4.1-2-gfad0