From eee7f47d8b3c685d0f8ba0ad79fad5afd8d719f6 Mon Sep 17 00:00:00 2001
From: Florian Pritz <bluewind@xinu.at>
Date: Sun, 4 Jun 2017 16:52:27 +0200
Subject: Build README from script instead of main package

Signed-off-by: Florian Pritz <bluewind@xinu.at>
---
 META.json              |  4 +--
 README.md              | 89 +++++++++++++++++++++++++++++++++++++-------------
 lib/App/BorgRestore.pm |  2 +-
 minil.toml             |  1 +
 script/borg-restore.pl |  3 ++
 5 files changed, 73 insertions(+), 26 deletions(-)

diff --git a/META.json b/META.json
index a86006d..2dcfdb3 100644
--- a/META.json
+++ b/META.json
@@ -4,7 +4,7 @@
       "-2017  Florian Pritz <bluewind@xinu.at>"
    ],
    "dynamic_config" : 0,
-   "generated_by" : "Minilla/v3.0.10, CPAN::Meta::Converter version 2.150005",
+   "generated_by" : "Minilla/v3.0.10, CPAN::Meta::Converter version 2.150010",
    "license" : [
       "gpl_3"
    ],
@@ -63,5 +63,5 @@
    },
    "release_status" : "unstable",
    "version" : "2.0.0",
-   "x_serialization_backend" : "JSON::PP version 2.27300_01"
+   "x_serialization_backend" : "JSON::PP version 2.27400_02"
 }
diff --git a/README.md b/README.md
index adac73b..c3a43c3 100644
--- a/README.md
+++ b/README.md
@@ -1,36 +1,83 @@
 # NAME
 
-App::BorgRestore - Restore paths from borg backups
+borg-restore.pl - Restore paths from borg backups
 
 # SYNOPSIS
 
-    use App::BorgRestore;
+borg-restore.pl \[options\] &lt;path>
 
-    my $app = App::BorgRestore->new();
+    Options:
+     --help, -h                 short help message
+     --debug                    show debug messages
+     --update-cache, -u         update cache files
+     --destination, -d <path>   Restore backup to directory <path>
+     --time, -t <timespec>      Automatically find newest backup that is at least
+                                <time spec> old
+     --adhoc                    Do not use the cache, instead provide an
+                                unfiltered list of archive to choose from
 
-    # Update the cache (call after creating/removing backups)
-    $app->update_cache();
-
-    # Restore a path from a backup that is at least 5 days old. Optionally
-    # restore it to a different directory than the original.
-    $app->restore_simple($path, "5days", $optional_destination_directory);
+    Time spec:
+     Select the newest backup that is at least <time spec> old.
+     Format: <number><unit>
+     Units: s (seconds), min (minutes), h (hours), d (days), m (months = 31 days), y (year)
 
 # DESCRIPTION
 
-App::BorgRestore is a restoration helper for borg.
+borg-restore.pl helps to restore files from borg backups.
+
+It takes one path, looks for its backups, shows a list of distinct versions and
+allows to select one to be restored. Versions are based on the modification
+time of the file.
+
+It is also possible to specify a time for automatic selection of the backup
+that has to be restored. If a time is specified, the script will automatically
+select the newest backup that is at least as old as the time value that is
+passed and restore it without further user interaction.
+
+**borg-restore.pl --update-cache** has to be executed regularly, ideally after
+creating or removing backups.
+
+[App::BorgRestore](https://metacpan.org/pod/App::BorgRestore) provides the base features used to implement this script.
+It can be used to build your own restoration script.
+
+# OPTIONS
+
+- **--help**, **-h**
+
+    Show help message.
+
+- **--debug**
 
-It maintains a cache of borg backup contents (path and latest modification
-time) and allows to quickly look up backups that contain a path. It further
-supports restoring a path from an archive. The archive to be used can also be
-automatically determined based on the age of the path.
+    Enable debug messages.
 
-The cache has to be updated regularly, ideally after creating or removing
-backups.
+- **--update-cache**, **-u**
 
-**borg-restore.pl** is a wrapper around this class that allows for simple CLI
-usage.
+    Update the lookup database. You should run this after creating or removing a backup.
 
-This package uses [Log::Any](https://metacpan.org/pod/Log::Any) for logging.
+- **--destination=**_path_, **-d **_path_
+
+    Restore the backup to 'path' instead of its original location. The destination
+    either has to be a directory or missing in which case it will be created. The
+    backup will then be restored into the directory with its original file or
+    directory name.
+
+- **--time=**_timespec_, **-t **_timespec_
+
+    Automatically find the newest backup that is at least as old as _timespec_
+    specifies. _timespec_ is a string of the form "<_number_><_unit_>" with _unit_ being one of the following:
+    s (seconds), min (minutes), h (hours), d (days), m (months = 31 days), y (year). Example: 5.5d
+
+- **--adhoc**
+
+    Disable usage of the database. In this mode, the list of archives is fetched
+    directly from borg at run time.  Use this when the cache has not been created
+    yet and you want to restore a file without having to manually call borg
+    extract. Using this option will show all archives that borg knows about, even
+    if they do not contain the file that shall be restored.
+
+# CONFIGURATION
+
+For configuration options please see [App::BorgRestore::Settings](https://metacpan.org/pod/App::BorgRestore::Settings).
 
 # LICENSE
 
@@ -50,7 +97,3 @@ You should have received a copy of the GNU General Public License
 along with this program.  If not, see &lt;http://www.gnu.org/licenses/>.
 
 See LICENSE for the full license text.
-
-# AUTHOR
-
-Florian Pritz <bluewind@xinu.at>
diff --git a/lib/App/BorgRestore.pm b/lib/App/BorgRestore.pm
index 87c1311..3ebabb9 100644
--- a/lib/App/BorgRestore.pm
+++ b/lib/App/BorgRestore.pm
@@ -55,7 +55,7 @@ automatically determined based on the age of the path.
 The cache has to be updated regularly, ideally after creating or removing
 backups.
 
-B<borg-restore.pl> is a wrapper around this class that allows for simple CLI
+L<borg-restore.pl> is a wrapper around this class that allows for simple CLI
 usage.
 
 This package uses L<Log::Any> for logging.
diff --git a/minil.toml b/minil.toml
index 0b0b6c1..10578ec 100644
--- a/minil.toml
+++ b/minil.toml
@@ -1,4 +1,5 @@
 name = "App-BorgRestore"
+readme_from="script/borg-restore.pl"
 # badges = ["travis"]
 module_maker="ModuleBuildTiny"
 license="gpl_3"
diff --git a/script/borg-restore.pl b/script/borg-restore.pl
index 7bdcac6..0fe5a2a 100755
--- a/script/borg-restore.pl
+++ b/script/borg-restore.pl
@@ -41,6 +41,9 @@ passed and restore it without further user interaction.
 B<borg-restore.pl --update-cache> has to be executed regularly, ideally after
 creating or removing backups.
 
+L<App::BorgRestore> provides the base features used to implement this script.
+It can be used to build your own restoration script.
+
 =cut
 
 =head1 OPTIONS
-- 
cgit v1.2.3-24-g4f1b