Merge pull request MicrosoftDocs#759 from mikeblome/mb-linux-intellisense

new content for remote IntelliSense

Author: ktoliver

docs/linux/cmake-linux-project.md

@@ -1,7 +1,9 @@
 ---
 title: "Configure a Linux CMake project in Visual Studio | Microsoft Docs"
 ms.custom: ""
-ms.date: "10/25/2107"
+ms.date: "04/28/2018"
+ms.reviewer: ""
+ms.suite: ""
 ms.technology: ["cpp-linux"]
 ms.tgt_pltfrm: "Linux"
 ms.topic: "conceptual"
@@ -38,7 +40,8 @@ int main(int argc, char* argv[])
 }
 ```
 
-CMakeLists.txt: 
+CMakeLists.txt:
+
 ```cmd
 project (hello-cmake)
 add_executable(hello-cmake hello.cpp)
@@ -53,6 +56,9 @@ After you specify a Linux target, your source is copied to your Linux machine. T
 
 ![Generate CMake cache on Linux](media/cmake-linux-1.png "Generate the CMake cache on Linux")  
 
+**Visual Studio 2017 version 15.7 and later:**
+To provide IntelliSense support for remote headers, Visual Studio automatically copies them to a directory on your local Windows machine. For more information, see [IntelliSense for remote headers](configure-a-linux-project.md#remote_intellisense).
+
 ## Debug the project  
 To debug your code on the remote system, set a breakpoint, select the CMake target as the startup item in the toolbar menu next to the project setting, and click run (or press F5).
 
@@ -78,6 +84,7 @@ To change the default CMake settings, choose **CMake | Change CMake Settings | C
       "inheritEnvironments": [ "linux-x64" ]
 }
 ```
+
 The `name` value can be whatever you like. The `remoteMachineName` value specifies which remote system to target, in case you have more than one. IntelliSense is enabled for this field to help you select the right system. The field `remoteCMakeListsRoot` specifies where your project sources will be copied to on the remote system. The field `remoteBuildRoot` is where the build output will be generated on your remote system. That output is also copied locally to the location specified by `buildRoot`.
 
 ## Building a supported CMake release from source

docs/linux/configure-a-linux-project.md

@@ -1,7 +1,9 @@
 ---
 title: "Configure a C++ Linux project in Visual Studio | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/15/2017"
+ms.date: "04/28/2018"
+ms.reviewer: ""
+ms.suite: ""
 ms.technology: ["cpp-linux"]
 ms.tgt_pltfrm: "Linux"
 ms.topic: "conceptual"
@@ -33,8 +35,11 @@ To change settings pertaining to the remote Linux computer, configure the remote
 > [!NOTE]
 > To change the default C and C++ compilers, or the Linker and Archiver used to build the project, use the appropriate entries in the **C/C++ > General** section and the **Linker > General** section.  These could be set to use a certain version of GCC, or even the Clang compiler, for example.
 
-## VC++ directories
-By default, Visual Studio does not include any system-level include files from the Linux computer.  For example, items in the **/usr/include** directory are not present in Visual Studio.  For full [IntelliSense](/visualstudio/ide/using-intellisense) support, you will need to copy those files to some location on your development computer and point Visual Studio to this location.  One option is to use scp (Secure Copy) to copy the files.  On Windows 10, you can use [Bash on Windows](https://msdn.microsoft.com/commandline/wsl/about) to run scp.  For previous versions of Windows, you could use something like [PSCP (PuTTY Secure Copy)](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html).
+## Include directories and IntelliSense support
+
+**Visual Studio 2017 version 15.6 and earlier:**
+By default, Visual Studio does not include any system-level include files from the Linux computer.  For example, items in the **/usr/include** directory are not present in Visual Studio.
+For full [IntelliSense](/visualstudio/ide/using-intellisense) support, you will need to copy those files to some location on your development computer and point Visual Studio to this location.  One option is to use scp (Secure Copy) to copy the files.  On Windows 10, you can use [Bash on Windows](https://msdn.microsoft.com/commandline/wsl/about) to run scp.  For previous versions of Windows, you could use something like [PSCP (PuTTY Secure Copy)](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html).
 
 You can copy the files by using a command similar to the following:
 
@@ -46,6 +51,9 @@ Once the files are copied, use the **VC++ Directories** item in Project properti
 
 ![VC++ Directories](media/settings_directories.png)
 
+**Visual Studio 2017 version 15.7 and later:**
+See [Manage Remote Headers for IntelliSense](#remote_intellisense).
+
 ## Copy sources
 When building, the source files on your development PC are copied to the Linux computer and compiled there.  By default, all sources in the Visual Studio project are copied to the locations set in the settings above.  However, additional sources can also be added to the list, or copying sources can be turned off entirely, which is the default for a Makefile project.
 
@@ -62,6 +70,20 @@ Since all compilation is happening on a remote computer, several additional Buil
 
 ![Build Events](media/settings_buildevents.png)
 
+## <a name="remote_intellisense"></a> IntelliSense for remote headers (Visual Studio 2017 version 15.7 and later)
+
+When you add a new connection in **Connection Manager**, Visual Studio automatically detects the include directories for the compiler on the remote system. Visual Studio then zips up and copies those files to a directory on your local Windows machine. After that, whenever you use that connection in a Visual Studio or CMake project, the headers in those directories are used to provide IntelliSense.
+
+This functionality depends on the Linux machine having zip installed. You can install zip by using this apt-get command:
+
+```cmd
+apt install zip
+```
+
+To manage your header cache, navigate to **Tools > Options, Cross Platform > Connection Manager > Remote Headers IntelliSense Manager**. To update the header cache after making changes on your Linux machine, select the remote connection and then select **Update**. Select **Delete** to remove the headers without deleting the connection itself. Select **Explore** to open the local directory in **File Explorer**. Treat this folder as read-only. To download headers for an existing connection that was created prior to version 15.3, select the connect and then select **Download**.
+
+![Remote Header IntelliSense](media/remote-header-intellisense.png)
+
 ## See Also
 [Working with Project Properties](../ide/working-with-project-properties.md)  
 [C++ General Properties (Linux C++)](../linux/prop-pages/general-linux.md)