===================================================================
RCS file: /cvs/openbsd/update_openbsd/README.TXT,v
retrieving revision 1.8
retrieving revision 1.11
diff -u -r1.8 -r1.11
--- openbsd/update_openbsd/README.TXT	2008/08/12 23:18:18	1.8
+++ openbsd/update_openbsd/README.TXT	2015/10/12 00:35:14	1.11
@@ -1,18 +1,28 @@
 This is a shell script to make upgrading OpenBSD easier.  It supports
 upgrading to a new version as well as just upgrading to a newer version of the
-same release.
+same release.  I use it to easily update between snapshots.
 
-Generally, just run update_openbsd.  However, you probably want to create a
-config file to set the mirror you would like to use (ftp or http) as well.
-See update_openbsdrc.example
+Generally, you just need to run update_openbsd.  However, you probably want to
+create a config file to set the mirror you would like to use (ftp or http) as
+well.  See update_openbsdrc.example
 
-If you are moving between versions it will install the new kernel and ask you
-to reboot.  After you reboot, you will need to run it again.
+If you do not set a MIRROR in update_openbsdrc or exported in your environment,
+you will need to have the sets available in another way.  By default it looks
+for them in a "version" directory, for example if you are running OpenBSD 5.4,
+it will look for a 5.5, then a 5.4 directory relative to the current directory.
+You can also set RELEASEDIR to point to the path that contains the sets, again
+either in update_openbsdrc or exported into the current environment.
 
-If you are installing a release of the same version, it will install the
-latest kernel, extract available sets, and then run sysmerge or attempt to run
-mergemaster and finally update installed packages.
+The script will initially download the new sets if you don't have them,
+then extract them and install new kernels.
 
+If you are moving between kernels after installing sets and the new kernel and
+it will ask you to reboot.  After you reboot, you will need to run
+update_openbsd again.
+
+If running with the same boot kernel as the update, often on the second run, it
+will run sysmerge and finally update installed packages.
+
 Also included is a copy of release.sh
 	This is the OpenBSD - Release Building Shell Script
 	from FenderQ.com - Internet Security Solutions
@@ -21,6 +31,6 @@
 	Slightly modified to make it do what I want.
 
 	I run release.sh like this:
-	$ sudo release.sh update full-release
+	$ doas release.sh update full-release
 
-$RedRiver: README.TXT,v 1.7 2006/11/29 16:50:03 andrew Exp $
+$AFresh1: README.TXT,v 1.10 2014/02/01 18:39:06 andrew Exp $