This is an automated email from the ASF dual-hosted git repository. janc pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/mynewt-newt.git
commit 0a8c4457c390218e9982c9bd9c2db5a709422f92 Author: Slawomir Kasenberg <[email protected]> AuthorDate: Tue Jul 22 13:53:55 2025 +0200 docs: install: Update install instructions for Windows --- docs/install/newt_windows.rst | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) diff --git a/docs/install/newt_windows.rst b/docs/install/newt_windows.rst index 30cb2ec9..25852807 100644 --- a/docs/install/newt_windows.rst +++ b/docs/install/newt_windows.rst @@ -13,7 +13,7 @@ This guide shows you how to perform the following: 1. Install MSYS2/MinGW. 2. Install Git. -3. Install latest release (1.8.0) of newt from binary. +3. Install latest release of newt from binary. 4. Install go for building newt from source. 5. Install latest release of newt from source. @@ -93,7 +93,7 @@ You can install the latest release of newt from binary. It has been tested on Wi 1. Start a MinGW terminal. -2. Download the newt binary tar file `apache-mynewt-newt-bin-windows-1.8.0.tgz <https://www.apache.org/dyn/closer.lua/mynewt/apache-mynewt-1.8.0/apache-mynewt-newt-bin-windows-1.8.0.tgz>`__. +2. Download the latest newt binary tar file for Windows from https://mynewt.apache.org/download. 3. Extract the file: @@ -102,13 +102,13 @@ You can install the latest release of newt from binary. It has been tested on Wi .. code-block:: console - $ tar -xzf apache-mynewt-newt-bin-windows-1.8.0.tgz -C $GOPATH/bin --strip-components=1 apache-mynewt-newt-bin-windows-1.8.0/newt.exe + $ tar -xzf apache-mynewt-newt-bin-windows-x.x.x.tgz -C $GOPATH/bin --strip-components=1 apache-mynewt-newt-bin-windows-x.x.x/newt.exe - If you are installing newt for the first time and do not have a Go workspace setup, you can extract into /usr/bin directory: .. code-block:: console - $ tar -xzf apache-mynewt-newt-bin-windows-1.8.0.tgz -C /usr/bin --strip-components=1 apache-mynewt-newt-bin-windows-1.8.0/newt.exe + $ tar -xzf apache-mynewt-newt-bin-windows-x.x.x.tgz -C /usr/bin --strip-components=1 apache-mynewt-newt-bin-windows-x.x.x/newt.exe 4. Verify the installed version of newt. See `Checking the Installed Version`_. @@ -136,20 +136,19 @@ source. 1. Start a MinGw terminal. -2. Download and unpack the newt source: +2. Download and unpack the newt source (get version number from https://mynewt.apache.org/download): .. code-block:: console - $ wget -P /tmp https://github.com/apache/mynewt-newt/archive/mynewt_1_8_0_tag.tar.gz - $ tar -xzf /tmp/mynewt_1_8_0_tag.tar.gz + $ wget -P /tmp https://github.com/apache/mynewt-newt/archive/mynewt_x_x_x_tag.tar.gz + $ tar -xzf /tmp/mynewt_x_x_x_tag.tar.gz 3. Run the build.sh to build the newt tool. .. code-block:: console - $ cd mynewt-newt-mynewt_1_8_0_tag + $ cd mynewt-newt $ MSYS=winsymlinks:nativestrict ./build.sh - $ rm /tmp/mynewt_1_8_0_tag.tar.gz 4. You should see the ``newt/newt.exe`` executable. Move the executable to a bin directory in your PATH: @@ -173,14 +172,16 @@ Checking the Installed Version .. code-block:: console + $ which newt + /usr/bin/newt $ newt version - Apache Newt 1.8.0 / ab96a8a-dirty / 2020-03-18_23:25 + Apache Newt 1.13.0 / c6bf556 / 2024-11-15_06:58 2. Get information about newt: .. code-block:: console - $ newt help + $ newt Newt allows you to create your own embedded application based on the Mynewt operating system. Newt provides both build and package management in a single tool, which allows you to compose an embedded application, and set of @@ -204,6 +205,7 @@ Checking the Installed Version apropos Search manual page names and descriptions build Build one or more targets clean Delete build artifacts for one or more targets + completion Generate the autocompletion script for the specified shell create-image Add image header to target binary debug Open debugger session to target docs Project documentation generation commands @@ -225,13 +227,14 @@ Checking the Installed Version version Display the Newt version number Flags: - --escape Apply Windows escapes to shell commands (default true) + --escape Apply Windows escapes to shell commands -h, --help Help for newt commands - -j, --jobs int Number of concurrent build jobs (default 8) + -j, --jobs int Number of concurrent build jobs (default 4) -l, --loglevel string Log level (default "WARN") -o, --outfile string Filename to tee output to -q, --quiet Be quiet; only display error output + --shallow int Use shallow clone for git repositories up to specified number of commits -s, --silent Be silent; don't output anything -v, --verbose Enable verbose output when executing commands - Use "newt [command] --help" for more information about a command. + Use "newt [command] --help" for more information about a command. \ No newline at end of file
