Commit Diff
Diff:
1b79e0f170e35c0e9e7116ec9de2ca098d3a048b
8306e7fbfaed67c288b11634b98e29bad763db2b
Commit:
8306e7fbfaed67c288b11634b98e29bad763db2b
Tree:
cb9fa6bd8a7956ce542fad18367c31950fb1ff61
Author:
Fred. Galusik <f@galusik.fr>
Committer:
Fred. Galusik <f@galusik.fr>
Date:
Sat May 9 15:32:47 2020 UTC
Message:
update manpage and do v2.0 tarball
blob - 69888d24033cdf75edcd45737f410179e39ace54 (mode 644)
blob + /dev/null
Binary files snaps-1.3.tar.gz and /dev/null differ
blob - 23cd64a720635c1760cfccf84c76f0d639cfcecc
blob + a51ba923f09887092bb22793241ce84dfc24e423
--- snaps.1
+++ snaps.1
@@ -1,10 +1,10 @@
-.TH "SNAPS" 1 "08/25/2017" "Frédéric Galusik"
+.TH "SNAPS" 1 "05/09/2020" "Frédéric Galusik"
.SH NOM
.P
-SNAPS \- An OpenBSD admin utility to upgrade to last \-current base snapshot.
+SNAPS \- An OpenBSD admin utility to deal with \-current base snapshot.
.SH SYNOPSIS
@@ -14,12 +14,10 @@ SNAPS \- An OpenBSD admin utility to upgrade to last \
.SH DESCRIPTION
.P
-\fBsnaps\fR will help you to download the needed \fBbsd.rd\fR, check it and move it to
-the right place before rebooting. A backup of your last bsd.rd is made. All
-steps are verbose. It can be run with only the base system. Nevertheless if you
-install \fIcurl\fR from packages, it will check your \fI$MIRROR\fR build date of
-base and packages. You will be able to decide if you want to do the update right now
-or wait for the synchronicity of the two directories.
+\fBsnaps\fR helps you to see if you need and/or can upgrade your \-current BASE and PACKAGES system to next snapshots. It can show you when your system has been upgraded, which BASE snapshot you are using and compare it to your \fI$MIRROR\fR freshness in order to let you choose to run \fBsysupgrade\fR or not.
+If you need to, it can also ckeck available mirrors and show you their BASE and PACKAGES build dates.
+Moreover, you can also read the online FAQ \fBFollowing \-current and using snapshots\fR and see if you have to make some tweaks.
+Nevertheless, \fIcurl\fR and \fIlinks\fR (or \fIlynx\fR) from packages, are mandatory to run \fBsnaps\fR.
.SH GENERAL OPTIONS
@@ -29,46 +27,45 @@ Print help and exit. It also print the content of the
\fI$MIRROR\fR variable based upon \fI/etc/installurl\fR for a quick look.
.TP
-\fB\-g\fR
-Fetch and check (SHA256 and signify) bsd.rd from \fI$MIRROR\fR (no need
-to be root for that one).
+\fB\-s\fR
+Check your BASE snapshot and your \fI$MIRROR\fR BASE and PACKAGES build dates to let you choose to run \fBsysupgrade \-s\fR or not.
.TP
-\fB\-G\fR
-Fetch, check bsd.rd from \fI$MIRROR\fR then, move it to the right place,
-backup your last bsd.rd, print some reminders and reboot.
+\fB\-c\fR
+Check BASE and PACKAGES build dates from \fI$MIRROR\fR.
.TP
-\fB\-p\fR
-Update your \fI\-current\fR port tree.
+\fB\-a\fR
+Check BASE and PACKAGES build dates from all available online mirrors.
.TP
\fB\-l\fR
-List date and download places of the 3 last \fI\-G\fR from
+List date and download places of the 3 last \fI\-s\fR from
/var/log/snaps.log.
.TP
+\fB\-f\fR
+Read the online FAQ : Following \-current and using snapshots.
+
+.TP
\fB\-u\fR
Upgrade snaps to the last release.
+.TP
+\fB\-p\fR
+Update the ports tree to \-current.
+
.SH COMMAND LINE USAGE
.P
-Here are some usage examples:
+Here is an usage example:
.TP
-\fBMIRROR=http://another/openbsd/mirror/pub/OpenBSD doas snaps \-G\fR
+\fBMIRROR=http://another/openbsd/mirror/pub/OpenBSD doas snaps \-s\fR
Bypass your \fI/etc/installurl\fR file and manually setup the \fI$MIRROR\fR
variable. Note that you have to indicate the root of the \fI$MIRROR\fR followed
-by \fB/pub/OpenBSD\fR (no \fB/\fR at the end).
-This one have to follow the OpenBSD directory layout. Moreover, in order to play
-with \fIMIRROR\fR, \fBdoas\fR have to be setup with the \fIkeepenv\fR option.
+by \fB/pub/OpenBSD\fR (no \fB/\fR at the end). This one have to follow the OpenBSD directory layout. Moreover, in order to play with \fI$MIRROR\fR, \fBdoas\fR have to be setup with the \fIkeepenv\fR option.
-.TP
-\fBRL=62 doas snaps \-G\fR
-Bypass the default signify key which used.
-Usefull when beta is coming because the release number is setup for the next release/stable.
-
.SH WEBSITE
.P
@@ -82,7 +79,7 @@ Frédéric Galusik
.SH SEE ALSO
.P
-\fBsysmerge\fR(8), \fBpkg_add\fR(1)
+\fBsysupgrade\fR(8), \fBsysmerge\fR(8), \fBpkg_add\fR(1)
.\" man code generated by txt2tags 2.6 (http://txt2tags.org)
.\" cmdline: txt2tags snaps.t2t
blob - 897c0ed6373181dd474c5490d973be9c6ad29073
blob + f7c092e8d8c4a99479da6bb68ce007445e354b71
--- snaps.t2t
+++ snaps.t2t
@@ -9,7 +9,7 @@ Frédéric Galusik
= NOM =[nom]
-SNAPS - An OpenBSD admin utility to upgrade to last -current base snapshot.
+SNAPS - An OpenBSD admin utility to deal with -current base snapshot.
= SYNOPSIS =[synopsis]
@@ -19,12 +19,10 @@ SNAPS - An OpenBSD admin utility to upgrade to last -c
= DESCRIPTION =[description]
-**snaps** will help you to download the needed **bsd.rd**, check it and move it to
-the right place before rebooting. A backup of your last bsd.rd is made. All
-steps are verbose. It can be run with only the base system. Nevertheless if you
-install //curl// from packages, it will check your //$MIRROR// build date of
-base and packages. You will be able to decide if you want to do the update right now
-or wait for the synchronicity of the two directories.
+**snaps** helps you to see if you need and/or can upgrade your -current BASE and PACKAGES system to next snapshots. It can show you when your system has been upgraded, which BASE snapshot you are using and compare it to your //$MIRROR// freshness in order to let you choose to run **sysupgrade** or not.
+If you need to, it can also ckeck available mirrors and show you their BASE and PACKAGES build dates.
+Moreover, you can also read the online FAQ **Following -current and using snapshots** and see if you have to make some tweaks.
+Nevertheless, //curl// and //links// (or //lynx//) from packages, are mandatory to run **snaps**.
= GENERAL OPTIONS =[general-options]
@@ -33,41 +31,39 @@ or wait for the synchronicity of the two directories.
Print help and exit. It also print the content of the
//$MIRROR// variable based upon ///etc/installurl// for a quick look.
-: **-g**
-Fetch and check (SHA256 and signify) bsd.rd from //$MIRROR// (no need
-to be root for that one).
+: **-s**
+Check your BASE snapshot and your //$MIRROR// BASE and PACKAGES build dates to let you choose to run **sysupgrade -s** or not.
-: **-G**
-Fetch, check bsd.rd from //$MIRROR// then, move it to the right place,
-backup your last bsd.rd, print some reminders and reboot.
+: **-c**
+Check BASE and PACKAGES build dates from //$MIRROR//.
-: **-p**
-Update your //-current// port tree.
+: **-a**
+Check BASE and PACKAGES build dates from all available online mirrors.
: **-l**
-List date and download places of the 3 last //-G// from
+List date and download places of the 3 last //-s// from
/var/log/snaps.log.
+: **-f**
+Read the online FAQ : Following -current and using snapshots.
+
: **-u**
Upgrade snaps to the last release.
+: **-p**
+Update the ports tree to -current.
+
= COMMAND LINE USAGE =[command-line-usage]
-Here are some usage examples:
+Here is an usage example:
-: **MIRROR=http://another/openbsd/mirror/pub/OpenBSD doas snaps -G**
+: **MIRROR=http://another/openbsd/mirror/pub/OpenBSD doas snaps -s**
Bypass your ///etc/installurl// file and manually setup the //$MIRROR//
variable. Note that you have to indicate the root of the //$MIRROR// followed
-by **/pub/OpenBSD** (no **/** at the end).
-This one have to follow the OpenBSD directory layout. Moreover, in order to play
-with //MIRROR//, **doas** have to be setup with the //keepenv// option.
+by **/pub/OpenBSD** (no **/** at the end). This one have to follow the OpenBSD directory layout. Moreover, in order to play with //$MIRROR//, **doas** have to be setup with the //keepenv// option.
-: **RL=62 doas snaps -G**
-Bypass the default signify key which used.
-Usefull when beta is coming because the release number is setup for the next release/stable.
-
= WEBSITE =[website]
https://framagit.org/fredg/snaps
@@ -80,4 +76,4 @@ Frédéric Galusik
= SEE ALSO =[see-also]
-**sysmerge**(8), **pkg_add**(1)
+**sysupgrade**(8), **sysmerge**(8), **pkg_add**(1)
Frédéric Galusik