You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mynewt.apache.org by ja...@apache.org on 2025/09/02 13:03:58 UTC
(mynewt-newt) branch master updated (423bd891 -> 0a8c4457)
This is an automated email from the ASF dual-hosted git repository.
janc pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/mynewt-newt.git
from 423bd891 builder: Fix false positive flash map errors
new d5fea5a9 docs: install: Update install instructions for Linux
new 0a8c4457 docs: install: Update install instructions for Windows
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
docs/install/newt_linux.rst | 141 +++++-------------------------------------
docs/install/newt_windows.rst | 31 +++++-----
2 files changed, 34 insertions(+), 138 deletions(-)
(mynewt-newt) 02/02: docs: install: Update install instructions for Windows
Posted by ja...@apache.org.
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 <sl...@op.pl>
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
(mynewt-newt) 01/02: docs: install: Update install instructions for Linux
Posted by ja...@apache.org.
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 d5fea5a92ca827c0c0a43914b77a186a85040269
Author: Slawomir Kasenberg <sl...@op.pl>
AuthorDate: Tue Jul 22 09:25:21 2025 +0200
docs: install: Update install instructions for Linux
---
docs/install/newt_linux.rst | 141 ++++++--------------------------------------
1 file changed, 17 insertions(+), 124 deletions(-)
diff --git a/docs/install/newt_linux.rst b/docs/install/newt_linux.rst
index cfb11de3..13bc169e 100644
--- a/docs/install/newt_linux.rst
+++ b/docs/install/newt_linux.rst
@@ -1,149 +1,40 @@
Installing Newt on Linux
------------------------
-You can install the latest release (1.9.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 of the newt tool from https://mynewt.apache.org/download or download latest sources
+directly from GitHub https://github.com/apache/mynewt-newt and build your binary localy.
-This page shows you how to:
-
-1. Set up your computer to download Debian binary packages from the JuulLabs-OSS APT repository.
-
- **Note:** The key for signing the repository has changed. If you set up your computer before release 1.1.0, you will
- need to download and import the public key again.
-
-2. Install the latest release version of newt from a Debian binary package. You can use apt-get to install the package
- or manually download and install the Debian binary package.
-
-3. Download, build, and install the latest release version of newt from source.
-
-If you are installing on an amd64 platform, we recommend that you install from the binary package.
-
-See :doc:`prev_releases` to install an earlier version of newt.
-
-**Note:** We have tested the newt tool binary and apt-get install from the JuulLabs-OSS APT repository for Ubuntu version
-1704. 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 :doc:`../../misc/go_env` if you want to:
-
-- Use the newt tool with the latest updates from the master branch. The master branch may be unstable and we recommend
- that you use the latest stable release version.
-- Contribute to the newt tool.
-
-Setting Up Your Computer to use apt-get to Install the Package
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The newt Debian packages are stored in a private APT repository on **https://github.com/JuulLabs-OSS/debian-mynewt**.
-To use apt-get, you must set up the following on your computer to retrieve packages from the repository:
-
-**Note**: You only need to perform this setup once on your computer. However, if you previously downloaded and imported
-the public key for the JuulLabs-OSS APT repository, you will need to perform step 2 again as the key has changed.
-
-1. Download the public key for the JuulLabs-OSS APT repository and import the key into the apt keychain.
-2. Add the repository for the binary and source packages to the apt source list.
-
-Download the public key for the JuulLabs-OSS apt repo (**Note:** There is a ``-`` after ``apt-key add``):
-
-.. code-block:: console
-
- $ wget -qO - https://raw.githubusercontent.com/JuulLabs-OSS/debian-mynewt/master/mynewt.gpg.key | sudo apt-key add -
-
-Add the repository for the binary and source packages to the ``mynewt.list`` apt source list file:
-
-.. code-block:: console
-
- $ sudo tee /etc/apt/sources.list.d/mynewt.list <<EOF
- deb https://raw.githubusercontent.com/JuulLabs-OSS/debian-mynewt/master latest main
- EOF
-
-**Note:** Previously the repository lived under ``runtimeco/debian-mynewt``, and although
-updating should remain working, if it stops pulling in the latest releases, please try updating
-``/etc/apt/sources.list.d/mynewt.list`` and substitute ``runtimeco`` by ``JuulLabs-OSS``.
-
-Update the available packages:
-
-.. code-block:: console
-
- $ sudo apt-get update
-
-**Note:** If you are not using Ubuntu version 1704, you may see the following errors. We have provided instructions on
-how to manually download and install the binary package.
-
-.. code-block:: console
-
- W: Failed to fetch https://raw.githubusercontent.com/JuulLabs-OSS/debian-mynewt/master/dists/latest/main/source/Sources HttpError404
-
-Installing the Latest Release of Newt from a Binary Package
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can use either apt-get to install the package, or manually download and install the Debian binary package.
-
-Method 1: Using apt-get to Upgrade or to Install
-==============================================================================================
-
-Run the following commands to upgrade or install the latest version of newt:
-
-.. code-block:: console
-
- $ sudo apt-get update
- $ sudo apt-get install newt
-
-**Note:** If you encounter build errors (such as missing ``sys/mman.h``), please make sure you have a 32-bit glibc:
-
-.. code-block:: console
-
- $ sudo apt-get install gcc-multilib
-
-Method 2: Downloading and Installing the Debian Package Manually
-==============================================================================================
-
-Download and install the package manually.
-
-.. code-block:: console
+ .. code-block:: console
- $ wget https://raw.githubusercontent.com/JuulLabs-OSS/binary-releases/master/mynewt-newt-tools_1.9.0/newt_1.9.0-1_amd64.deb
- $ sudo dpkg -i newt_1.9.0-1_amd64.deb
+ $ git clone https://github.com/apache/mynewt-newt.git
-See `Checking the Installed Version of Newt`_ to verify that you are using the installed version of newt.
-Installing the Latest Release of Newt from a Source Package
+Installing Newt from Sources
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-If you are running Linux on a different architecture, you can build and install the latest release version of newt from
-source.
-
The newt tool is written in Go (https://golang.org/). In order to build Apache Mynewt, you must have Go 1.12 or later
installed on your system. Please visit the Golang website for more information on installing Go (https://golang.org/).
-#. Download and unpack the newt source:
-
- .. code-block:: console
-
- $ wget -P /tmp https://github.com/apache/mynewt-newt/archive/mynewt_1_9_0_tag.tar.gz
- $ tar -xzf /tmp/mynewt_1_9_0_tag.tar.gz
-
#. Run the build.sh to build the newt tool.
.. code-block:: console
- $ cd mynewt-newt-mynewt_1_9_0_tag
+ $ cd mynewt-newt
$ ./build.sh
- $ rm /tmp/mynewt_1_9_0_tag.tar.gz
-#. You should see the ``newt/newt`` executable. Move the executable to a bin directory in your PATH:
+#. Add the path to the newt tool to your PATH.
- - If you previously built newt from the master branch, you can move the binary to your $GOPATH/bin directory.
-
- .. code-block:: console
+ .. code-block:: console
- $ mv newt/newt $GOPATH/bin
+ $ mkdir ~/bin
+ $ mv ./newt/newt ~/bin/.
+ $ export PATH=$PATH:~/bin
- - If you are installing newt for the first time and do not have a Go workspace set up, you can move the binary to
- /usr/bin or a directory in your PATH:
+#. To make newt visible in every new terminal add the export to ~/.bashrc
- .. code-block:: console
+ .. code-block:: console
- $ mv newt/newt /usr/bin
+ $ echo 'export PATH=$PATH:~/bin' >> ~/.bashrc
Checking the Installed Version of Newt
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -155,7 +46,7 @@ Checking the Installed Version of Newt
$ which newt
/usr/bin/newt
$ newt version
- Apache Newt version: 1.9.0
+ Apache Newt 1.13.0 / c6bf556 / 2024-11-15_06:58
2. Get information about newt:
@@ -185,6 +76,7 @@ Checking the Installed Version of Newt
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
@@ -212,6 +104,7 @@ Checking the Installed Version of Newt
-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