Merge pull request #2146 from ev-mp/current

Document debians for bionic installation

doc/distribution_linux.md

@@ -1,31 +1,34 @@
 # Linux Distribution
 
-**Intel® RealSense™ SDK 2.0** provides installation packages in [`dpkg`](https://en.wikipedia.org/wiki/Dpkg) format for Ubuntu 16 LTS\*.    
-\* The Realsense [DKMS](https://en.wikipedia.org/wiki/Dynamic_Kernel_Module_Support) kernel drivers package (`librealsense2-dkms`) supports Ubuntu LTS kernels 4.4, 4.10 and 4.13.
-
+**Intel® RealSense™ SDK 2.0** provides installation packages in [`dpkg`](https://en.wikipedia.org/wiki/Dpkg) format for Ubuntu 16/18 LTS.    
+\* The Realsense [DKMS](https://en.wikipedia.org/wiki/Dynamic_Kernel_Module_Support) kernel drivers package (`librealsense2-dkms`) supports Ubuntu LTS kernels 4.4, 4.10, 4.13 and 4.15\*.
 
 **Note** Kernel 4.16 introduces some non-compatible modification to uvcvideo and media subsystem. We work to support it in future releases, but at this time the support is scoped up to kernel 4.15 and the affected users are requested to downgrade the kernel version.
 
 
-> To build the project from source, or in case of Ubuntu 18 (Bionic Beaver) with kernel 4.15 please follow steps described [here](./installation.md) to manually install the kernel patches
-
+>To build the project from sources and prepare/patch the OS manually please follow steps described [here](./installation.md).
 
 
 ## Installing the packages:
-- Add Intel server  to the list of repositories :  
-`echo 'deb http://realsense-hw-public.s3.amazonaws.com/Debian/apt-repo xenial main' | sudo tee /etc/apt/sources.list.d/realsense-public.list`  
-It is recommended to backup `/etc/apt/sources.list.d/realsense-public.list` file in case of an upgrade.
-
-- Register the server's public key :  
+- Register Intel's repository server's public key :  
 `sudo apt-key adv --keyserver hkp://keys.gnupg.net:80 --recv-key C8B3A55A6F3EFCDE`  
-- Refresh the list of repositories and packages available :  
-`sudo apt-get update`  
+
+- Add the server to the list of repositories :  
+  Ubuntu 16 LTS:  
+`sudo add-apt-repository "deb http://realsense-hw-public.s3.amazonaws.com/Debian/apt-repo xenial main" -u`  
+  Ubuntu 18 LTS:  
+`sudo add-apt-repository "deb http://realsense-hw-public.s3.amazonaws.com/Debian/apt-repo bionic main" -u`
+
+ When upgrading, remove the old records:  
+  - `sudo rm -f /etc/apt/sources.list.d/realsense-public.list`.  
+  - `sudo apt-get update`.  
 
 - In order to run demos install:  
   `sudo apt-get install librealsense2-dkms`  
   `sudo apt-get install librealsense2-utils`  
-  The above two lines will deploy librealsense2 udev rules, kernel drivers, runtime library and executable demos and tools.
-  Reconnect the Intel RealSense depth camera and run: `realsense-viewer`  
+  The above two lines will deploy librealsense2 udev rules, build and activate kernel modules, runtime library and executable demos and tools.  
+
+ Reconnect the Intel RealSense depth camera and run: `realsense-viewer` to verify the installation.
 
 - Developers shall install additional packages:  
   `sudo apt-get install librealsense2-dev`