Merge pull request #32 from upgrades-migrations/check_for_latest_iso

Always check if upgrading to the allowed RHEL version

man/redhat-upgrade-tool.8

@@ -1,13 +1,13 @@
 '\" t
 .\"     Title: redhat-upgrade-tool
 .\"    Author: [see the "AUTHORS" section]
-.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
-.\"      Date: 11/08/2013
+.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
+.\"      Date: 11/08/2017
 .\"    Manual: redhat-upgrade-tool User Manual
 .\"    Source: redhat-upgrade-tool
 .\"  Language: English
 .\"
-.TH "REDHAT\-UPGRADE\-TOOL" "8" "11/08/2013" "redhat\-upgrade\-tool" "redhat\-upgrade\-tool User Manual"
+.TH "REDHAT\-UPGRADE\-TOO" "8" "11/08/2017" "redhat\-upgrade\-tool" "redhat\-upgrade\-tool User Man"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -28,17 +28,17 @@
 .\" * MAIN CONTENT STARTS HERE *
 .\" -----------------------------------------------------------------
 .SH "NAME"
-redhat\-upgrade\-tool \- Red Hat Upgrade tool
+redhat-upgrade-tool \- Red Hat Upgrade tool
 .SH "SYNOPSIS"
 .sp
 redhat\-upgrade\-tool [\fIOPTIONS\fR] \fBSOURCE\fR
 .SH "DESCRIPTION"
 .sp
-\fBredhat\-upgrade\-tool\fR is the Red Hat Upgrade tool\&.
+\fBredhat\-upgrade\-tool\fR is the Red Hat Upgrade Tool\&.
 .sp
-The \fBredhat\-upgrade\-tool\fR client runs on the system to be upgraded\&. It determines what packages are needed for upgrade and gathers them from the source(s) given\&. It also fetches and sets up the boot images needed to run the upgrade and sets up the system to perform the upgrade at next boot\&.
+The \fBredhat\-upgrade\-tool\fR client runs on the source system\&. It determines what packages are needed for upgrade and gathers them from the given source(s)\&. It also fetches and sets up the boot images needed to run the upgrade and sets up the system to perform the upgrade at next boot\&.
 .sp
-The actual upgrade takes place when the system is rebooted, using the boot images set up by \fBredhat\-upgrade\-tool\fR\&. The upgrade initrd starts the existing system (mostly) as normal, lets it mount all the local filesystems, then starts the upgrade\&.
+The actual upgrade occurs when the system is rebooted, using the boot images set up by \fBredhat\-upgrade\-tool\fR\&. The upgrade initrd starts the source system as normal, lets it mount all the local filesystems, and then starts the upgrade\&.
 .sp
 When the upgrade finishes, it reboots the system into the newly\-upgraded OS\&.
 .SH "OPTIONS"
@@ -71,40 +71,40 @@ Automatically reboot to start the upgrade when ready\&.
 .RE
 .SS "SOURCE"
 .sp
-These options tell \fBredhat\-upgrade\-tool\fR where to look for the packages and boot images needed to run the upgrade\&. At least one of these options is required\&.
+These options provide \fBredhat\-upgrade\-tool\fR with the information where to look for the packages and boot images needed to run the upgrade\&. At least one of these options is required\&.
 .PP
 \fB\-\-device\fR [\fIDEV\fR]
 .RS 4
 Device or mountpoint of mounted install media\&. If
 \fIDEV\fR
 is omitted,
 \fBredhat\-upgrade\-tool\fR
-will scan all currently\-mounted removable devices (USB disks, optical media, etc\&.)
+will scan all currently\-mounted removable devices (for example USB disks and optical media)\&.
 .RE
 .PP
 \fB\-\-iso\fR \fIISO\fR
 .RS 4
 Installation image file\&.
 .RE
 .PP
-\fB\-\-network\fR \fIVERSION\fR
+\fB\-\-network\fR \fIRELEASEVER\fR
 .RS 4
-Online repos matching
-\fIVERSION\fR
-(a number or "rawhide")
+Online repos\&.
+\fIRELEASEVER\fR
+will be used to replace $releasever variable if it occurs in some repo URL\&.
 .RE
 .sp
 Multiple sources may be used, if desired\&.
 .SS "Additional options for \-\-network"
 .PP
 \fB\-\-enablerepo\fR \fIREPOID\fR
 .RS 4
-Enable one or more repos (wildcards allowed)\&.
+Enable one or more repos (wildcards are allowed)\&.
 .RE
 .PP
 \fB\-\-disablerepo\fR \fIREPOID\fR
 .RS 4
-Disable one or more repos (wildcards allowed)\&.
+Disable one or more repos (wildcards are allowed)\&.
 .RE
 .PP
 \fB\-\-addrepo\fR \fIREPOID=[@]URL\fR
@@ -120,7 +120,7 @@ to indicate that the URL is a mirrorlist\&.
 Get upgrader boot images from the repo named
 \fIREPOID\fR\&. The repo must contain a valid
 \fI\&.treeinfo\fR
-file which points to the location of usable
+file, which points to the location of usable
 \fIkernel\fR
 and
 \fIupgrade\fR
@@ -130,7 +130,7 @@ images\&.
 .PP
 \fB\-\-resetbootloader\fR
 .RS 4
-Remove any modifications made to bootloader configuration\&.
+Remove any modifications made to the bootloader configuration\&.
 .RE
 .PP
 \fB\-\-clean\fR
@@ -144,9 +144,9 @@ Clean up everything written by
 .sp
 Upgrade to RHEL 7\&.0 by downloading all needed packages and data from the specified repository\&.
 .sp
-\fBredhat\-upgrade\-tool \-\-device \-\-network 7\&.0\fR
+\fBredhat\-upgrade\-tool \-\-device\fR
 .sp
-Upgrade to RHEL 7\&.0 using install media mounted somewhere on the system, fetching updates from the network if needed\&.
+Upgrade the system by using installation media mounted on the system, fetching updates from the network if needed\&.
 .SH "EXIT STATUS"
 .PP
 0

man/redhat-upgrade-tool.8.asciidoc

@@ -1,5 +1,5 @@
 redhat-upgrade-tool(8)
-========
+======================
 :man source:  redhat-upgrade-tool
 :man manual:  redhat-upgrade-tool User Manual
 
@@ -16,14 +16,14 @@ DESCRIPTION
 -----------
 *redhat-upgrade-tool* is the Red Hat Upgrade Tool.
 
-The *redhat-upgrade-tool* client runs on the system to be upgraded. It determines what
-packages are needed for upgrade and gathers them from the source(s) given.
+The *redhat-upgrade-tool* client runs on the source system. It determines what
+packages are needed for upgrade and gathers them from the given source(s).
 It also fetches and sets up the boot images needed to run the upgrade and
 sets up the system to perform the upgrade at next boot.
 
-The actual upgrade takes place when the system is rebooted, using the boot
-images set up by *redhat-upgrade-tool*. The upgrade initrd starts the existing system
-(mostly) as normal, lets it mount all the local filesystems, then starts the
+The actual upgrade occurs when the system is rebooted, using the boot
+images set up by *redhat-upgrade-tool*. The upgrade initrd starts the source
+system as normal, lets it mount all the local filesystems, and then starts the
 upgrade.
 
 When the upgrade finishes, it reboots the system into the newly-upgraded OS.
@@ -52,19 +52,21 @@ Automatically reboot to start the upgrade when ready.
 SOURCE
 ~~~~~~
 
-These options tell *redhat-upgrade-tool* where to look for the packages and boot images
-needed to run the upgrade. At least one of these options is required.
+These options provide *redhat-upgrade-tool* with the information where to look
+for the packages and boot images needed to run the upgrade. At least one of
+these options is required.
 
 *--device* ['DEV']::
-Device or mountpoint of mounted install media. If 'DEV' is omitted, *redhat-upgrade-tool*
-will scan all currently-mounted removable devices (USB disks, optical media,
-etc.)
+Device or mountpoint of mounted install media. If 'DEV' is omitted,
+*redhat-upgrade-tool* will scan all currently-mounted removable devices
+(for example USB disks and optical media).
 
 *--iso* 'ISO'::
 Installation image file.
 
-*--network* 'VERSION'::
-Online repos matching 'VERSION' (a number or "rawhide")
+*--network* 'RELEASEVER'::
+Online repos. 'RELEASEVER' will be used to replace $releasever variable if it
+occurs in some repo URL.
 
 Multiple sources may be used, if desired.
 
@@ -73,26 +75,26 @@ Additional options for *--network*
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 *--enablerepo* 'REPOID'::
-Enable one or more repos (wildcards allowed).
+Enable one or more repos (wildcards are allowed).
 
 *--disablerepo* 'REPOID'::
-Disable one or more repos (wildcards allowed).
+Disable one or more repos (wildcards are allowed).
 
 *--addrepo* 'REPOID=[@]URL'::
 Add the repo at 'URL'. Prefix URL with '@' to indicate that the URL is a
 mirrorlist.
 
 *--instrepo* 'REPOID'::
 Get upgrader boot images from the repo named 'REPOID'. The repo must contain a
-valid '.treeinfo' file which points to the location of usable 'kernel' and
+valid '.treeinfo' file, which points to the location of usable 'kernel' and
 'upgrade' images.
 
 
 Cleanup commands
 ~~~~~~~~~~~~~~~~
 
 *--resetbootloader*::
-Remove any modifications made to bootloader configuration.
+Remove any modifications made to the bootloader configuration.
 
 *--clean*::
 Clean up everything written by *redhat-upgrade-tool*.
@@ -105,9 +107,9 @@ EXAMPLES
 Upgrade to RHEL 7.0 by downloading all needed packages and data from the
 specified repository.
 
-*redhat-upgrade-tool --device --network 7.0*
+*redhat-upgrade-tool --device*
 
-Upgrade to RHEL 7.0 using install media mounted somewhere on the system,
+Upgrade the system by using installation media mounted on the system,
 fetching updates from the network if needed.
 
 EXIT STATUS