Merge pull request #322 from cwanda/doc_updates
1.2 install updates (Do not merge until ready to release)
diff --git a/docs/newt/install/newt_linux.md b/docs/newt/install/newt_linux.md
index c0bb09d..350eb14 100644
--- a/docs/newt/install/newt_linux.md
+++ b/docs/newt/install/newt_linux.md
@@ -1,6 +1,6 @@
## Installing Newt on Linux
-You can install the latest release (1.1.0) of the newt tool from a Debian binary package (amd64). You can also download and build the latest release version of newt from source.
+You can install the latest release (1.2.0) of the newt tool from a Debian binary package (amd64). You can also download and build the latest release version of newt from source.
This page shows you how to:
@@ -12,12 +12,11 @@
3. Download, build, and install the latest release version of newt from source.
-4. Install an earlier version of newt.
-
If you are installing on an amd64 platform, we recommend that you install from the binary package.
-**Note:** We have tested the newt tool binary and apt-get install from the runtimeco APT repository for Ubuntu version 16. Earlier Ubuntu versions (for example: Ubuntu 14) may have incompatibility with the repository. You can manually download and install the Debian binary package.
+See [Installing Previous Releases of Newt](/newt/install/prev_releases.md) to install an earlier version of newt.
+**Note:** We have tested the newt tool binary and apt-get install from the runtimeco APT repository for Ubuntu version 16. Earlier Ubuntu versions (for example: Ubuntu 14) may have incompatibility with the repository. You can manually download and install the Debian binary package.
**Note:** See [Setting Up a Go Environment to Contribute to Newt and Newtmgr Tools](/faq/go_env) if you want to:
@@ -109,8 +108,8 @@
Download and install the package manually.
```no-highlight
-$wget https://raw.githubusercontent.com/runtimeco/debian-mynewt/master/pool/main/n/newt/newt_1.1.0-1_amd64.deb
-$sudo dpkg -i newt_1.1.0-1_amd64.deb
+$wget https://raw.githubusercontent.com/runtimeco/debian-mynewt/master/pool/main/n/newt/newt_1.2.0-1_amd64.deb
+$sudo dpkg -i newt_1.2.0-1_amd64.deb
```
<br>
See [Checking the Installed Version of Newt](#check) to verify that you are using the installed version of newt.
@@ -121,15 +120,15 @@
If you are running Linux on a different architecture, you can build and install the latest release version of newt from source.
<br>
-1. You need Go version 1.7.6 or higher to build Newt version 1.0.0. Currently, the latest Go version that Ubuntu installs is 1.6. Run `go version` to check if you have Go 1.7.6 installed. You can download Go from [https://golang.org/dl/](https://golang.org/dl/).
+1. You need Go version 1.7.6 or higher to build Newt. Currently, the latest Go version that Ubuntu installs is 1.6. Run `go version` to check if you have Go 1.7.6 installed. You can download Go from [https://golang.org/dl/](https://golang.org/dl/).
<br>
2. Download and unpack the newt source:
```no-highlight
-$ wget -P /tmp https://github.com/apache/mynewt-newt/archive/mynewt_1_1_0_tag.tar.gz
-$ tar -xzf /tmp/mynewt_1_1_0_tag.tar.gz
+$ wget -P /tmp https://github.com/apache/mynewt-newt/archive/mynewt_1_2_0_tag.tar.gz
+$ tar -xzf /tmp/mynewt_1_2_0_tag.tar.gz
```
<br>
@@ -137,9 +136,9 @@
```no-highlight
-$ cd mynewt-newt-mynewt_1_1_0_tag
+$ cd mynewt-newt-mynewt_1_2_0_tag
$ ./build.sh
-$ rm /tmp/mynewt_1_1_0_tag.tar.gz
+$ rm /tmp/mynewt_1_2_0_tag.tar.gz
```
<br>
@@ -164,7 +163,7 @@
$which newt
/usr/bin/newt
$newt version
-Apache Newt version: 1.1.0
+Apache Newt version: 1.2.0
```
<br>
@@ -224,20 +223,3 @@
```
<br>
-<br>
-### Installing Earlier Release Versions of Newt
-
-You can download and install an earlier version of newt.
-
-<br>
-1. Run `sudo apt-get remove newt` command the current installation.
-
-<br>
-2. Download and install the package. For example, run the following commands to install the 1.0.0 version of newt:
-
-```no-highlight
-
-$ wget https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.0.0/newt_1.0.0-1_amd64.deb
-$ sudo dpkg -i newt_1.0.0-1_amd64.deb
-
-```
diff --git a/docs/newt/install/newt_mac.md b/docs/newt/install/newt_mac.md
index 47150f5..a1a3592 100644
--- a/docs/newt/install/newt_mac.md
+++ b/docs/newt/install/newt_mac.md
@@ -1,13 +1,14 @@
## Installing Newt on Mac OS
-Newt is supported on Mac OS X 64 bit platforms and has been tested on Mac OS 10.10 and higher.
+Newt is supported on Mac OS X 64 bit platforms and has been tested on Mac OS 10.11 and higher.
This page shows you how to install the following versions of newt:
-* Upgrade to or install the latest release version (1.1.0).
-* Install earlier release versions.
+* Upgrade to or install the latest release version (1.2.0).
* Install the latest from the master branch (unstable).
+See [Installing Previous Releases of Newt](/newt/install/prev_releases) to install an earlier version of newt.
+
**Note:** If you would like to contribute to the newt tool, see [Setting Up Go Environment to Contribute to Newt and Newtmgr Tools](/faq/go_env).
### Installing Homebrew
@@ -32,11 +33,11 @@
### Upgrading to or Installing the Latest Release Version
-Perform the following to upgrade or install the latest release version of newt (1.1.0).
+Perform the following to upgrade or install the latest release version of newt.
#### Upgrading to the Latest Release Version of Newt
-If you previously installed newt 1.0.0 using brew, run the following commands to upgrade to newt 1.1.0:
+If you have installed an earlier version of newt using brew, run the following commands to upgrade to latest version of newt:
```no-highlight
@@ -48,22 +49,22 @@
<br>
#### Installing the Latest Release Version of Newt
-Run the following command to install the latest release version (1.1.0) of newt:
+Run the following command to install the latest release version of newt:
```no-highlight
$ brew update
$ brew install mynewt-newt
==> Installing mynewt-newt from runtimeco/mynewt
-==> Downloading https://github.com/runtimeco/binary-releases/raw/master/mynewt-newt-tools_1.1.0/mynewt-newt-1.1.0.sierra.bottle.tar.gz
-==> Downloading from https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.1.0/mynewt-newt-1.1.0.sierra.bottle.tar.gz
+==> Downloading https://github.com/runtimeco/binary-releases/raw/master/mynewt-newt-tools_1.2.0/mynewt-newt-1.2.0.sierra.bottle.tar.gz
+==> Downloading from https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.2.0/mynewt-newt-1.2.0.sierra.bottle.tar.gz
######################################################################## 100.0%
-==> Pouring mynewt-newt-1.1.0.sierra.bottle.tar.gz
-🍺 /usr/local/Cellar/mynewt-newt/1.1.0: 3 files, 10.5MB
+==> Pouring mynewt-newt-1.2.0.sierra.bottle.tar.gz
+🍺 /usr/local/Cellar/mynewt-newt/1.2.0: 3 files, 10.7MB
```
<br>
-**Notes:** Homebrew bottles for newt 1.1.0 are available for Mac OS Sierra, El Captian, and Yosemite. If you are running an earlier version of Mac OS, the installation will install the latest version of Go and compile newt locally.
+**Notes:** Homebrew bottles for newt are available for Mac OS Sierra, and El Captian. If you are running an earlier version of Mac OS, the installation will install the latest version of Go and compile newt locally.
<br>
### Checking the Installed Version
@@ -75,9 +76,9 @@
$which newt
/usr/local/bin/newt
$ls -l /usr/local/bin/newt
-lrwxr-xr-x 1 user staff 36 Jul 25 19:04 /usr/local/bin/newt -> ../Cellar/mynewt-newt/1.1.0/bin/newt
+lrwxr-xr-x 1 user staff 36 Sep 11 19:04 /usr/local/bin/newt -> ../Cellar/mynewt-newt/1.2.0/bin/newt
$newt version
-Apache Newt version: 1.1.0
+Apache Newt version: 1.2.0
```
**Note:** If you previously built newt from source and the output of `which newt` shows "$GOPATH/bin/newt", you will need to move "$GOPATH/bin" after "/usr/local/bin" for your PATH in ~/.bash_profile, and source ~/.bash_profile.
@@ -142,45 +143,9 @@
```
<br>
-### Installing Earlier Release Versions of Newt
-
-If you want to install newt 1.0, run the following commands:
-
-```no-highlight
-
-$ brew update
-$ brew install mynewt-newt@1.0
-
-```
-
-**Note:** This is a keg-only installation. newt 1.0 is installed in /usr/local/Cellar/mynewt-newt@1.0/1.0.0/bin but not symlinked into /usr/local/bin.
-
-If you need this version of newt first in your PATH, run the following commands:
-
-```no-highlight
-
-$ echo 'export PATH=/usr/local/Cellar/mynewt-newt@1.0/1.0.0/bin:$PATH' >> ~/.bash_profile
-$ source ~/.bash_profile
-
-```
-
-<br>
-You can also manually symlink into /usr/local/bin as follows:
-
-1. Unlink newt if you have the latest version of newt installed:
-
- $ brew unlink mynewt-newt
-
-2. Link mynewt-newt@1.0 into /usr/local/bin:
-
- $ brew link -f mynewt-newt@1.0
-
-
-<br>
-
### Installing Newt from the Master Branch
-We recommend that you use the latest release version (1.1.0) of newt. If you would like to use the master branch with the latest updates, you can install newt from the HEAD of the master branch.
+We recommend that you use the latest release version of newt. If you would like to use the master branch with the latest updates, you can install newt from the HEAD of the master branch.
** Notes: **
@@ -200,25 +165,25 @@
==> Installing mynewt-newt from runtimeco/mynewt
==> Cloning https://github.com/apache/mynewt-newt.git
Cloning into '/Users/wanda/Library/Caches/Homebrew/mynewt-newt--git'...
-remote: Counting objects: 624, done.
-remote: Compressing objects: 100% (502/502), done.
-remote: Total 624 (delta 156), reused 322 (delta 85), pack-reused 0
-Receiving objects: 100% (624/624), 1.11 MiB | 0 bytes/s, done.
-Resolving deltas: 100% (156/156), done.
+remote: Counting objects: 626, done.
+remote: Compressing objects: 100% (504/504), done.
+remote: Total 626 (delta 155), reused 323 (delta 85), pack-reused 0
+Receiving objects: 100% (626/626), 1.11 MiB | 0 bytes/s, done.
+Resolving deltas: 100% (155/155), done.
==> Checking out branch master
==> go install
-🍺 /usr/local/Cellar/mynewt-newt/HEAD-5a6266e: 3 files, 10.5MB, built in 5 seconds
+🍺 /usr/local/Cellar/mynewt-newt/HEAD-59b3a5d: 3 files, 10.7MB, built in 7 seconds
$newt version
-Apache Newt version: 1.1.0-dev
+Apache Newt version 1.1.0-dev
```
<br>
-To switch back to the latest stable release version (1.1.0) of newt, you can run:
+To switch back to the latest stable release version of newt, you can run:
```no-highlight
-$brew switch mynewt-newt 1.1.0
-Cleaning /usr/local/Cellar/mynewt-newt/1.1.0
-Cleaning /usr/local/Cellar/mynewt-newt/HEAD-5a6266e
-1 links created for /usr/local/Cellar/mynewt-newt/1.1.0
+$brew switch mynewt-newt 1.2.0
+Cleaning /usr/local/Cellar/mynewt-newt/1.2.0
+Cleaning /usr/local/Cellar/mynewt-newt/HEAD-59b3a5d
+1 links created for /usr/local/Cellar/mynewt-newt/1.2.0
$newt version
-Apache Newt version: 1.1.0
+Apache Newt version: 1.2.0
```
<br>
diff --git a/docs/newt/install/newt_windows.md b/docs/newt/install/newt_windows.md
index d05c4fe..d06efbd 100644
--- a/docs/newt/install/newt_windows.md
+++ b/docs/newt/install/newt_windows.md
@@ -8,8 +8,10 @@
1. Install MSYS2/MinGW.
2. Install Git.
-3. Install latest release of newt (1.1.0) from binary.
-4. Install latest release of newt (1.1.0) from source.
+3. Install latest release of newt (1.2.0) from binary.
+4. Install latest release of newt from source.
+
+See [Installing Previous Releases of Newt](/newt/install/prev_releases) to install an earlier version of newt. You still need to set up your MinGW development environment.
**Note:** If you would like to contribute to the newt tool, see [Setting Up Go Environment to Contribute to Newt and Newtmgr Tools](/faq/go_env.md).
@@ -56,7 +58,7 @@
### Installing the Latest Release of the Newt Tool from Binary
-You can install the latest release of newt (1.1.0) from binary. It has been tested on Windows 10 64 bit platform.
+You can install the latest release of newt from binary. It has been tested on Windows 10 64 bit platform.
<br>
1. Start a MinGW terminal.
@@ -66,7 +68,7 @@
```no-highlight
-$ wget -P /tmp https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.1.0/newt_1_1_0_windows_amd64.tar.gz
+$ wget -P /tmp https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.2.0/newt_1_2_0_windows_amd64.tar.gz
```
<br>
@@ -74,11 +76,11 @@
* If you previously built newt from the master branch, you can extract the file into your $GOPATH/bin directory. Note: This overwrites the current newt.exe in the directory and assumes that you are using $GOPATH/bin for your Go applications.
- tar -xzf /tmp/newt_1_1_0_windows_amd64.tar.gz -C $GOPATH/bin
+ tar -xzf /tmp/newt_1_2_0_windows_amd64.tar.gz -C $GOPATH/bin
* If you are installing newt for the first time and do not have a Go workspace setup, you can extract into /usr/bin directory:
- tar -xzf /tmp/newt_1_1_0_windows_amd64.tar.gz -C /usr/bin
+ tar -xzf /tmp/newt_1_2_0_windows_amd64.tar.gz -C /usr/bin
<br>
@@ -100,8 +102,8 @@
```no-highlight
-$ wget -P /tmp https://github.com/apache/mynewt-newt/archive/mynewt_1_1_0_tag.tar.gz
-$ tar -xzf /tmp/mynewt_1_1_0_tag.tar.gz
+$ wget -P /tmp https://github.com/apache/mynewt-newt/archive/mynewt_1_2_0_tag.tar.gz
+$ tar -xzf /tmp/mynewt_1_2_0_tag.tar.gz
```
<br>
@@ -109,9 +111,9 @@
```no-highlight
-$ cd mynewt-newt-mynewt_1_1_0_tag
+$ cd mynewt-newt-mynewt_1_2_0_tag
$ ./build.sh
-$ rm /tmp/mynewt_1_1_0_tag.tar.gz
+$ rm /tmp/mynewt_1_2_0_tag.tar.gz
```
<br>
@@ -134,7 +136,7 @@
```no-highlight
$ newt version
-Apache Newt version: 1.1.0
+Apache Newt version: 1.2.0
```
diff --git a/docs/newt/install/prev_releases.md b/docs/newt/install/prev_releases.md
new file mode 100644
index 0000000..27add23
--- /dev/null
+++ b/docs/newt/install/prev_releases.md
@@ -0,0 +1,79 @@
+## Installing Previous Releases of Newt
+
+This page shows you how to install previous releases of newt for Mac OS, Linux, and Windows.
+
+
+### Mac OS
+You can install previous releases of newt using `mynewt-newt@X.Y` Homebrew formulas, where X.Y is a version number.
+
+For example, if you want to install newt 1.0, run the following commands:
+
+```no-highlight
+
+$ brew update
+$ brew install mynewt-newt@1.0
+
+```
+
+**Note:** This is a keg-only installation. newt 1.0 is installed in /usr/local/Cellar/mynewt-newt@1.0/1.0.0/bin but not symlinked into /usr/local/bin.
+
+If you need this version of newt first in your PATH, run the following commands:
+
+```no-highlight
+
+$ echo 'export PATH=/usr/local/Cellar/mynewt-newt@1.0/1.0.0/bin:$PATH' >> ~/.bash_profile
+$ source ~/.bash_profile
+
+```
+
+<br>
+You can also manually symlink into /usr/local/bin as follows:
+
+<br>
+1. Unlink newt if you have the latest version of newt installed:
+
+```no-highlight
+$ brew unlink mynewt-newt
+```
+<br>
+2. Link mynewt-newt@1.0 into /usr/local/bin:
+
+```no-highlight
+$ brew link -f mynewt-newt@1.0
+```
+
+<br>
+### Linux
+<br>
+1. Download the binary:
+
+Version|Download
+-------|--------
+1.0.0 |[newt_1.0.0-1_amd64.deb](https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.0.0/newt_1.0.0-1_amd64.deb)
+1.1.0 |[newt_1.1.0-1_amd64.deb](https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.1.0/newt_1.1.0-1_amd64.deb)
+
+<br>
+2. Run the `sudo apt-get remove newt` command to remove the the current installation.
+
+<br>
+3. Install the package. For example, run `sudo dpkg -i newt_1.0.0-1_amd64.deb` to install newt 1.0.0
+
+<br>
+### Windows
+<br>
+1. Download the binary:
+
+Version|Download
+-------|--------
+1.1.0 |[newt_1_1_0_windows_amd64.tar.gz](https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.1.0/newt_1.1.0-1_amd64.deb)
+
+<br>
+2. Extract the file:
+
+* If you previously built newt from the master branch, you can extract the file into your $GOPATH/bin directory. Note: This overwrites the current newt.exe in the directory and assumes that you are using $GOPATH/bin for your Go applications.
+
+ tar -xzf newt_1_1_0_windows_amd64.tar.gz -C $GOPATH/bin
+
+* If you are installing newt for the first time and do not have a Go workspace setup, you can extract into /usr/bin directory:
+
+ tar -xzf newt_1_1_0_windows_amd64.tar.gz -C /usr/bin
diff --git a/docs/newtmgr/install_linux.md b/docs/newtmgr/install_linux.md
index 4877192..69b86fd 100644
--- a/docs/newtmgr/install_linux.md
+++ b/docs/newtmgr/install_linux.md
@@ -1,6 +1,6 @@
## Installing Newtmgr on Linux
-You can install the latest release (1.1.0) of the newtmgr tool from a Debian binary package (amd64). You can also download and build the latest release version of newtmgr from source.
+You can install the latest release (1.2.0) of the newtmgr tool from a Debian binary package (amd64). You can also download and build the latest release version of newtmgr from source.
This page shows you how to:
@@ -12,7 +12,7 @@
3. Download, build, and install the latest release version of newtmgr from source.
-4. Install an earlier version of newtmgr.
+See [Installing Previous Releases of Newtgmr](/newtmgr/prev_releases) to install an earlier version of newtmgr.
If you are installing on an amd64 platform, we recommend that you install from the binary package.
@@ -111,8 +111,8 @@
Download and install the package manually.
```no-highlight
-$wget https://raw.githubusercontent.com/runtimeco/debian-mynewt/master/pool/main/n/newtmgr/newtmgr_1.1.0-1_amd64.deb
-$sudo dpkg -i newtmgr_1.1.0-1_amd64.deb
+$wget https://raw.githubusercontent.com/runtimeco/debian-mynewt/master/pool/main/n/newtmgr/newtmgr_1.2.0-1_amd64.deb
+$sudo dpkg -i newtmgr_1.2.0-1_amd64.deb
```
See [Checking the Installed Version of Newtmgr](#check) to verify that you are using the installed version of newtmgr.
@@ -154,8 +154,8 @@
```no-highlight
$ cd src/mynewt.apache.org/newtmgr
-$ git checkout mynewt_1_1_0_tag
-Note: checking out 'mynewt_1_1_0_tag'.
+$ git checkout mynewt_1_2_0_tag
+Note: checking out 'mynewt_1_2_0_tag'.
```
@@ -223,21 +223,3 @@
```
<br>
-### Installing Earlier Release Versions of Newtmgr
-
-You can download and install an earlier version of newtmgr.
-
-<br>
-1. Run `sudo apt-get remove newtmgr` command the current installation.
-
-<br>
-2. Download and install the package. For example, run the following commands to install the 1.0.0 version of newtmgr :
-
-```no-highlight
-
-$ wget https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.0.0/newtmgr_1.0.0-1_amd64.deb
-$ sudo dpkg -i newtmgr_1.0.0-1_amd64.deb
-
-```
-
-<br>
diff --git a/docs/newtmgr/install_mac.md b/docs/newtmgr/install_mac.md
index bb39a96..5e6b1b2 100644
--- a/docs/newtmgr/install_mac.md
+++ b/docs/newtmgr/install_mac.md
@@ -1,13 +1,14 @@
## Installing Newtmgr on Mac OS
-Newtmgr is supported on Mac OS X 64 bit platforms and has been tested on Mac OS 10.10 and higher.
+Newtmgr is supported on Mac OS X 64 bit platforms and has been tested on Mac OS 10.11 and higher.
This page shows you how to install the following versions of newtmgr:
-* Upgrade to or install the latest release version (1.1.0).
-* Install earlier release versions.
+* Upgrade to or install the latest release version (1.2.0).
* Install the latest from the master branch (unstable).
+See [Installing Previous Releases of Newtmgr](/newtmgr/prev_releases) to install an earlier version of newtmgr.
+
**Note:** If you would like to contribute to the newtmgr tool, see [Setting Up Go Environment to Contribute to Newt and Newtmgr Tools](/faq/go_env).
### Adding the Mynewt Homebrew Tap
@@ -23,11 +24,11 @@
### Upgrading to or Installing the Latest Release Version
-Perform the following to upgrade or install the latest release version of newtmgr (1.1.0).
+Perform the following to upgrade or install the latest release version of newtmgr.
#### Upgrading to the Latest Release Version of Newtmgr
-If you previously installed newtmgr 1.0.0 using brew, run the following commands to upgrade to newtmgr 1.1.0:
+If you have installed an earlier version of newtmgr using brew, run the following commands to upgrade to the latest version of newtmgr:
```no-highlight
@@ -39,22 +40,22 @@
<br>
#### Installing the Latest Release Version of Newtmgr
-Run the following command to install the latest release version (1.1.0) of newtmgr:
+Run the following command to install the latest release version of newtmgr:
```no-highlight
$ brew update
$ brew install mynewt-newtmgr
==> Installing mynewt-newtmgr from runtimeco/mynewt
-==> Downloading https://github.com/runtimeco/binary-releases/raw/master/mynewt-newt-tools_1.1.0/mynewt-newtmgr-1.1.0.sierra.bottle.tar.gz
-==> Downloading from https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.1.0/mynewt-newtmgr-1.1.0.sierra.bottle.tar.gz
+==> Downloading https://github.com/runtimeco/binary-releases/raw/master/mynewt-newt-tools_1.2.0/mynewt-newtmgr-1.2.0.sierra.bottle.tar.gz
+==> Downloading from https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.2.0/mynewt-newtmgr-1.2.0.sierra.bottle.tar.gz
######################################################################## 100.0%
-==> Pouring mynewt-newtmgr-1.1.0.sierra.bottle.tar.gz
-🍺 /usr/local/Cellar/mynewt-newtmgr/1.1.0: 3 files, 17MB
+==> Pouring mynewt-newtmgr-1.2.0.sierra.bottle.tar.gz
+🍺 /usr/local/Cellar/mynewt-newtmgr/1.2.0: 3 files, 17.3MB
```
<br>
-**Notes:** Homebrew bottles for newtmgr 1.1.0 are available for Mac OS Sierra, El Captian and Yosemite. If you are running an earlier version of Mac OS, the installation will install the latest version of Go and compile newtmgr locally.
+**Notes:** Homebrew bottles for newtmgr 1.2.0 are available for Mac OS Sierra, El Captian. If you are running an earlier version of Mac OS, the installation will install the latest version of Go and compile newtmgr locally.
<br>
### Checking the Installed Version
@@ -64,7 +65,7 @@
$which newtmgr
/usr/local/bin/newtmgr
ls -l /usr/local/bin/newtmgr
-lrwxr-xr-x 1 user staff 42 Jul 25 21:15 /usr/local/bin/newtmgr -> ../Cellar/mynewt-newtmgr/1.1.0/bin/newtmgr
+lrwxr-xr-x 1 user staff 42 Sep 11 21:15 /usr/local/bin/newtmgr -> ../Cellar/mynewt-newtmgr/1.2.0/bin/newtmgr
```
**Note:** If you previously built newtmgr from source and the output of `which newtmgr` shows "$GOPATH/bin/newtmgr", you will need to move "$GOPATH/bin" after "/usr/local/bin" for your PATH in ~/.bash_profile, and source ~/.bash_profile.
@@ -107,43 +108,9 @@
```
<br>
-### Installing Earlier Release Versions of Newtmgr
-
-If you want to install newtmgr 1.0, run the following commands:
-
-```no-highlight
-
-$ brew update
-$ brew install mynewt-newtmgr@1.0
-
-```
-
-**Note:** This is a keg-only installation. newt 1.0 is installed in /usr/local/Cellar/mynewt-newtmgr@1.0/1.0.0/bin but not symlinked into /usr/local/bin.
-
-If you need this version of newt first in your PATH, run the following commands:
-
-```no-highlight
-
-$ echo 'export PATH=/usr/local/Cellar/mynewt-newtmgr@1.0/1.0.0/bin:$PATH' >> ~/.bash_profile
-$ source ~/.bash_profile
-
-```
-
-<br>
-You can also manually symlink into /usr/local/bin as follows:
-
-1. Unlink newtmgr if you have the latest version of newt installed:
-
- $ brew unlink mynewt-newtmgr
-
-2. Link mynewt-newt@1.0 into /usr/local/bin:
-
- $ brew link -f mynewt-newt@1.0
-
-<br>
### Installing Newtmgr from the Master Branch
-We recommend that you use the latest release version (1.1.0) of newtmgr. If you would like to use the master branch with the latest updates, you can install newtmgr from the HEAD of the master branch.
+We recommend that you use the latest release version of newtmgr. If you would like to use the master branch with the latest updates, you can install newtmgr from the HEAD of the master branch.
** Notes: **
@@ -162,24 +129,24 @@
==> Installing mynewt-newtmgr from runtimeco/mynewt
==> Cloning https://github.com/apache/mynewt-newtmgr.git
Cloning into '/Users/wanda/Library/Caches/Homebrew/mynewt-newtmgr--git'...
-remote: Counting objects: 650, done.
-remote: Compressing objects: 100% (511/511), done.
-remote: Total 650 (delta 192), reused 345 (delta 114), pack-reused 0
-Receiving objects: 100% (650/650), 4.67 MiB | 4.58 MiB/s, done.
-Resolving deltas: 100% (192/192), done.
+remote: Counting objects: 2169, done.
+remote: Compressing objects: 100% (1752/1752), done.
+remote: Total 2169 (delta 379), reused 2042 (delta 342), pack-reused 0
+Receiving objects: 100% (2169/2169), 8.13 MiB | 5.47 MiB/s, done.
+Resolving deltas: 100% (379/379), done.
==> Checking out branch master
==> go get github.com/currantlabs/ble
==> go get github.com/raff/goble
==> go get github.com/mgutz/logxi/v1
==> go install
-🍺 /usr/local/Cellar/mynewt-newtmgr/HEAD-7bdd773: 3 files, 17MB, built in 22 seconds
+🍺 /usr/local/Cellar/mynewt-newtmgr/HEAD-2d5217f: 3 files, 17.3MB, built in 1 minute 10 seconds
```
<br>
-To switch back to the latest stable release version (1.1.0) of newtmgr, you can run:
+To switch back to the latest stable release version of newtmgr, you can run:
```no-highlight
-$brew switch mynewt-newtmgr 1.1.0
-Cleaning /usr/local/Cellar/mynewt-newtmgr/1.1.0
-Cleaning /usr/local/Cellar/mynewt-newtmgr/HEAD-7bdd773
-1 links created for /usr/local/Cellar/mynewt-newtmgr/1.1.0
+$brew switch mynewt-newtmgr 1.2.0
+Cleaning /usr/local/Cellar/mynewt-newtmgr/1.2.0
+Cleaning /usr/local/Cellar/mynewt-newtmgr/HEAD-2d5217f
+1 links created for /usr/local/Cellar/mynewt-newtmgr/1.2.0
```
<br>
diff --git a/docs/newtmgr/install_windows.md b/docs/newtmgr/install_windows.md
index 547418e..edcc9ad 100644
--- a/docs/newtmgr/install_windows.md
+++ b/docs/newtmgr/install_windows.md
@@ -1,20 +1,23 @@
## Installing Newtmgr on Windows
+**Note**: Newtmgr 1.2 on Windows will be released in 1.2.1 patch release. If you want to use newtmgr on Windows, please use Apache Mynewt 1.1.0 release.
+
This guide shows you how to install the latest release of newtmgr from binary or from source. The tool is written in Go (golang).
It assumes that you have already installed the [newt tool on Windows](/newt/install/newt_windows/) and have the Windows development environment set up.
This guide shows you how to perform the following:
-1. Install latest release of newtmgr (1.1.0) from binary.
-2. Install latest release of newtmgr (1.1.0) from source.
+1. Install latest release of newtmgr from binary.
+2. Install latest release of newtmgr from source.
+
+See [Installing Previous Releases of Newtmgr](/newtmgr/prev_releases) to install an earlier version of newtgmr.
**Note:** If you would like to contribute to the newtmgr tool, see [Setting Up Go Environment to Contribute to Newt and Newtmgr Tools](/faq/go_env.md).
### Installing the Latest Release of Newtmgr Tool from Binary
-You can install the latest release of newtmgr (1.1.0) from binary. It has be
-en tested on Windows 10 64 bit platform.
+You can install the latest release of newtmgr from binary. It has been tested on Windows 10 64 bit platform.
<br>
1. Start a MinGW terminal.
@@ -24,7 +27,7 @@
```no-highlight
-$ wget -P /tmp https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.1.0/newtmgr_1_1_0_windows_amd64.tar.gz
+$ wget -P /tmp https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.2.0/newtmgr_1_2_0_windows_amd64.tar.gz
```
<br>
@@ -32,11 +35,11 @@
* If you previously built newtmgr from the master branch, you can extract the file into your $GOPATH/bin directory. Note: This overwrites the current newtmgr.exe in the directory and assumes that you are using $GOPATH/bin for your Go applications.
- tar -xzf /tmp/newtmgr_1_1_0_windows_amd64.tar.gz -C $GOPATH/bin
+ tar -xzf /tmp/newtmgr_1_2_0_windows_amd64.tar.gz -C $GOPATH/bin
* If you are installing newtmgr for the first time and do not have Go setup, you can extract into /usr/bin directory:
- tar -xzf /tmp/newtmgr_1_1_0_windows_amd64.tar.gz -C /usr/bin
+ tar -xzf /tmp/newtmgr_1_2_0_windows_amd64.tar.gz -C /usr/bin
<br>
@@ -89,8 +92,8 @@
```no-highlight
$ cd src/mynewt.apache.org/newtmgr
-$ git checkout mynewt_1_1_0_tag
-Note: checking out 'mynewt_1_1_0_tag'.
+$ git checkout mynewt_1_2_0_tag
+Note: checking out 'mynewt_1_2_0_tag'.
```
@@ -102,7 +105,7 @@
$ cd newtmgr
$ go install
$ ls /tmp/go/bin/newtmgr.exe
--rwxr-xr-x 1 user None 15362048 Jul 29 16:57 /tmp/go/bin/newtmgr.exe
+-rwxr-xr-x 1 user None 15457280 Sep 12 00:30 /tmp/go/bin/newtmgr.exe
```
diff --git a/docs/newtmgr/prev_releases.md b/docs/newtmgr/prev_releases.md
new file mode 100644
index 0000000..fc0dd15
--- /dev/null
+++ b/docs/newtmgr/prev_releases.md
@@ -0,0 +1,79 @@
+## Installing Previous Releases of Newtmgr
+
+This page shows you how to install previous releases of newtmgr for Mac OS, Linux, and Windows.
+
+
+### Mac OS
+You can install previous releases of newtmgr using `mynewt-newtmgr@X.Y` Homebrew formulas, where X.Y is a version number.
+
+For example, if you want to install newtmgr 1.0, run the following commands:
+
+```no-highlight
+
+$ brew update
+$ brew install mynewt-newtmgr@1.0
+
+```
+
+**Note:** This is a keg-only installation. newtgmr 1.0 is installed in /usr/local/Cellar/mynewt-newtmgr@1.0/1.0.0/bin but not symlinked into /usr/local/bin.
+
+If you need this version of newtmgr first in your PATH, run the following commands:
+
+```no-highlight
+
+$ echo 'export PATH=/usr/local/Cellar/mynewt-newtmgr@1.0/1.0.0/bin:$PATH' >> ~/.bash_profile
+$ source ~/.bash_profile
+
+```
+
+<br>
+You can also manually symlink into /usr/local/bin as follows:
+
+<br>
+1. Unlink newtmgr if you have the latest version of newtmgr installed:
+
+```no-highlight
+$ brew unlink mynewt-newtmgr
+```
+<br>
+2. Link mynewt-newt@1.0 into /usr/local/bin:
+
+```no-highlight
+$ brew link -f mynewt-newtmgr@1.0
+```
+
+<br>
+### Linux
+<br>
+1. Download the binary:
+
+Version|Download
+-------|--------
+1.0.0 |[newtmgr_1.0.0-1_amd64.deb](https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.0.0/newtmgr_1.0.0-1_amd64.deb)
+1.1.0 |[newtmgr_1.1.0-1_amd64.deb](https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.1.0/newtmgr_1.1.0-1_amd64.deb)
+
+<br>
+2. Run the `sudo apt-get remove newtmgr` command to remove the the current installation.
+
+<br>
+3. Install the package. For example, run `sudo dpkg -i newtmgr_1.0.0-1_amd64.deb` to install newtmgr 1.0.0
+
+<br>
+### Windows
+<br>
+1. Download the binary:
+
+Version|Download
+-------|--------
+1.1.0 |[newtmgr_1_1_0_windows_amd64.tar.gz](https://raw.githubusercontent.com/runtimeco/binary-releases/master/mynewt-newt-tools_1.1.0/newtmgr_1.1.0-1_amd64.deb)
+
+<br>
+2. Extract the file:
+
+* If you previously built newtmgr from the master branch, you can extract the file into your $GOPATH/bin directory. Note: This overwrites the current newtmgr.exe in the directory and assumes that you are using $GOPATH/bin for your Go applications.
+
+ tar -xzf newtmgr_1_1_0_windows_amd64.tar.gz -C $GOPATH/bin
+
+* If you are installing newtmgr for the first time and do not have a Go workspace setup, you can extract into /usr/bin directory:
+
+ tar -xzf newtmgr_1_1_0_windows_amd64.tar.gz -C /usr/bin
diff --git a/docs/os/get_started/docker.md b/docs/os/get_started/docker.md
index 9fec387..ede49b2 100644
--- a/docs/os/get_started/docker.md
+++ b/docs/os/get_started/docker.md
@@ -55,7 +55,7 @@
myproj newt
user@~/dockertest$ cd myproj
user@~/dockertest/myproj$ ../newt version
-Apache Newt version: 1.1.0
+Apache Newt version: 1.2.0
```
<br>
diff --git a/mkdocs.yml b/mkdocs.yml
index 7598197..145a01a 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -579,6 +579,8 @@
- Known Issues: 'known_issues.md'
- Appendix:
+ - 'Installing Previous Releases of Newt': 'newt/install/prev_releases.md'
+ - 'Installing Previous Releases of Newtmgr': 'newtmgr/prev_releases.md'
- 'Setting Up Go to Contribute to Newt and Newtmgr Tools': 'faq/go_env.md'
- 'Using an IDE to Develop Mynewt Applications': 'faq/ide.md'
- 'Edit Docs': 'faq/how_to_edit_docs.md'
