[GitHub] aditihilbert closed pull request #339: Useful note about 32-bit libc; propose small cleanups

[GitBox <gi...@apache.org>]

aditihilbert closed pull request #339: Useful note about 32-bit libc; propose small cleanups
URL: https://github.com/apache/mynewt-site/pull/339
 
 
   

This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:

As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):

diff --git a/docs/newt/install/newt_linux.md b/docs/newt/install/newt_linux.md
index 350eb144b..6d9870401 100644
--- a/docs/newt/install/newt_linux.md
+++ b/docs/newt/install/newt_linux.md
@@ -39,8 +39,8 @@ The newt Debian packages are stored in a private APT repository on **https://git
 <br>
 Install the apt-transport-https package:
 ```no-highlight
-$sudo apt-get update
-$sudo apt-get install apt-transport-https
+$ sudo apt-get update
+$ sudo apt-get install apt-transport-https
 ```
 <br>
 
@@ -48,33 +48,22 @@ $sudo apt-get install apt-transport-https
 Download the public key for the runtimeco apt repo (**Note:** There is  a `-` after  `apt-key add`):
 
 ```no-highlight
-wget -qO - https://raw.githubusercontent.com/runtimeco/debian-mynewt/master/mynewt.gpg.key | sudo apt-key add -
+$ wget -qO - https://raw.githubusercontent.com/runtimeco/debian-mynewt/master/mynewt.gpg.key | sudo apt-key add -
 ```
 <br>
 
-Add the repository for the binary and source packages to the `mynewt.list` apt source list file.
+Add the repository for the binary and source packages to the `mynewt.list` apt source list file:
 
 ```no-highlight
-$sudo -s
-[sudo] password for <user>:
-root$ cat > /etc/apt/sources.list.d/mynewt.list <<EOF
+$ sudo tee /etc/apt/sources.list.d/mynewt.list <<EOF
 deb https://raw.githubusercontent.com/runtimeco/debian-mynewt/master latest main
 EOF
-root$exit
 ```
-**Note:** Do not forget to exit the root shell.
 
-<br>
-Verify the content of the source list file:
-
-```no-highlight
-$more /etc/apt/sources.list.d/mynewt.list
-deb https://raw.githubusercontent.com/runtimeco/debian-mynewt/master latest main
-```
 <br>
 Update the available packages: 
 ```no-highlight
-$sudo apt-get update
+$ sudo apt-get update
 ```
 <br>
 **Note:** If you are not using Ubuntu version 16, you may see the following errors.  We have provided instructions on how to manually download and install the binary package.
@@ -96,10 +85,14 @@ You can use either apt-get to install the package, or manually download and inst
 Run the following commands to upgrade or install the latest version of newt:
 
 ```no-highlight
-
 $ 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:
 
+```no-highlight
+$ sudo apt-get install gcc-multilib
 ```
 
 <br>
@@ -108,8 +101,8 @@ $ sudo apt-get install newt
 Download and install the package manually.
 
 ```no-highlight
-$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
+$ 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.
@@ -126,7 +119,6 @@ If you are running Linux on a different architecture, you can build and install
 2. Download and unpack the newt source:
 
 ```no-highlight
-
 $ 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
 ```
@@ -160,16 +152,16 @@ $ rm /tmp/mynewt_1_2_0_tag.tar.gz
 1. Check which newt you are using and that the version is the latest release version.
 
 ```no-highlight
-$which newt
+$ which newt
 /usr/bin/newt
-$newt version
+$ newt version
 Apache Newt version: 1.2.0
 ```
 
 <br>
 2. Get information about newt:
 ```no-highlight
-$newt
+$ 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 


 

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services