Native Client Visual Studio Add-in

visual_studio/NativeClientVSAddIn/NativeClientVSAddIn/NativeClientVSAddIn.xml

Index: visual_studio/NativeClientVSAddIn/NativeClientVSAddIn/NativeClientVSAddIn.xml
diff --git a/visual_studio/NativeClientVSAddIn/NativeClientVSAddIn/NativeClientVSAddIn.xml b/visual_studio/NativeClientVSAddIn/NativeClientVSAddIn/NativeClientVSAddIn.xml
new file mode 100644
index 0000000000000000000000000000000000000000..899c007b3804d22f8dc89d9936e2892e887185d5
--- /dev/null
+++ b/visual_studio/NativeClientVSAddIn/NativeClientVSAddIn/NativeClientVSAddIn.xml
@@ -0,0 +1,423 @@
+<?xml version="1.0"?>
+<doc>
+    <assembly>
+        <name>NativeClientVSAddIn</name>
+    </assembly>
+    <members>
+        <member name="T:NativeClientVSAddIn.Strings">
+            <summary>
+              A strongly-typed resource class, for looking up localized strings, etc.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.ResourceManager">
+            <summary>
+              Returns the cached ResourceManager instance used by this class.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.Culture">
+            <summary>
+              Overrides the current thread's CurrentUICulture property for all
+              resource lookups using this strongly typed resource class.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.ChromePathEnvironmentVariable">
+            <summary>
+              Looks up a localized string similar to CHROME_PATH.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.NaClDebugFlag">
+            <summary>
+              Looks up a localized string similar to --enable-nacl-debug.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.NaClPlatformName">
+            <summary>
+              Looks up a localized string similar to NaCl.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.NaClProcessName">
+            <summary>
+              Looks up a localized string similar to nacl64.exe.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.NaClProcessTypeFlag">
+            <summary>
+              Looks up a localized string similar to --type=nacl-loader.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.PepperPlatformName">
+            <summary>
+              Looks up a localized string similar to PPAPI.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.PepperProcessName">
+            <summary>
+              Looks up a localized string similar to chrome.exe.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.PepperProcessPluginFlagFormat">
+            <summary>
+              Looks up a localized string similar to --register-pepper-plugins=&quot;{0};application/x-nacl&quot;.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.PepperProcessTypeFlag">
+            <summary>
+              Looks up a localized string similar to --type=renderer.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.SDKPathEnvironmentVariable">
+            <summary>
+              Looks up a localized string similar to NACL_SDK_ROOT.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.WebServerMultiStartProjectWarning">
+            <summary>
+              Looks up a localized string similar to Warning: Multiple start-up projects not supported. Web server will only be run from first project directory.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.WebServerOutputWindowTitle">
+            <summary>
+              Looks up a localized string similar to Native Client Web Server Output.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.WebServerStartFail">
+            <summary>
+              Looks up a localized string similar to Warning: Failed to start web server. Is python.exe on the path? Is httpd.py in the plug-in project folder?.
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.Strings.WebServerStartMessage">
+            <summary>
+              Looks up a localized string similar to Launching web server....
+            </summary>
+        </member>
+        <member name="T:NativeClientVSAddIn.PluginDebuggerHelper">
+            <summary>
+            This class contains functions and utilities which are run when the user
+            "presses F5" or otherwise starts debugging from within Visual Studio.
+            </summary>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.#ctor(EnvDTE80.DTE2)">
+            <summary>
+            Constructs the PluginDebuggerHelper.
+            Object is not useable until InitializeFromProjectSettings() is called.
+            </summary>
+            <param name="dte">Automation object from Visual Studio</param>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.InitializeFromProjectSettings">
+            <summary>
+            Initializes the PluginDebuggerHelper with the current project settings
+            If project settings are unsupported for NaCl/Pepper debugging then
+            the object is not initialized and we return false
+            </summary>
+            <returns>True if the object is successfully initialized, false otherwise</returns>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.StartDebugging">
+            <summary>
+            This function should be called to start the PluginDebuggerHelper functionality
+            </summary>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.StopDebugging">
+            <summary>
+            This function should be called to stop the PluginDebuggerHelper functionality
+            </summary>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.KillGDBProcess">
+            <summary>
+            Cleans up the started GDB process
+            </summary>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.FindAndAttachToPlugin(System.Object,System.EventArgs)">
+            <summary>
+            Called periodically by the Visual Studio UI thread to look for our plug-in process
+            and attach the debugger to it.  The call is triggered by the pluginFinderTimer_ object
+            </summary>
+            <param name="unused">Unused</param>
+            <param name="unused1">Unused</param>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.AttachVSDebugger(System.Object,NativeClientVSAddIn.PluginFoundEventArgs)">
+            <summary>
+            Attaches the visual studio debugger to a given process ID
+            </summary>
+            <param name="src">Object the event came from</param>
+            <param name="args">Contains the process ID to attach to</param>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.AttachNaClGDB(System.Object,NativeClientVSAddIn.PluginFoundEventArgs)">
+            <summary>
+            Will do magic to attach GDB to NaCl process properly, load symbols, and load breakpoints
+            </summary>
+            <param name="src">Object the event came from</param>
+            <param name="args">
+            Contains the process ID to attach to, unused since debug stub already attached
+            </param>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.StartWebServer">
+            <summary>
+            Spins up the web server process to host our plugin
+            </summary>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.WebServerMessageReceive(System.Object,System.Diagnostics.DataReceivedEventArgs)">
+            <summary>
+            Receives output from the web server process to display in the Visual Studio UI
+            </summary>
+            <param name="sender">Unused</param>
+            <param name="e">Contains the data to display</param>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginDebuggerHelper.WebServerWriteLine(System.String)">
+            <summary>
+            Helper function to write data to the Web Server Output Pane
+            </summary>
+            <param name="message">Message to write</param>
+        </member>
+        <member name="P:NativeClientVSAddIn.PluginDebuggerHelper.IsDebuggerRunning">
+            <summary>
+            Indicates true if the debugger is running (even during breakpoints)
+            </summary>
+        </member>
+        <member name="T:NativeClientVSAddIn.PluginDebuggerHelper.DebuggerType">
+            <summary>
+            Specifies the debugger to use when debugging
+            </summary>
+        </member>
+        <member name="T:NativeClientVSAddIn.PluginDebuggerHelper.ProjectPlatformType">
+            <summary>
+            Specifies the type of plug-in being run in this debug session
+            </summary>
+        </member>
+        <member name="T:NativeClientVSAddIn.PluginFoundEventArgs">
+            <summary>
+            The event arguments when a plug-in is found
+            </summary>
+        </member>
+        <member name="M:NativeClientVSAddIn.PluginFoundEventArgs.#ctor(System.UInt32)">
+            <summary>
+            Construct the PluginFoundEventArgs
+            </summary>
+            <param name="pid">Process ID of the found plug-in</param>
+        </member>
+        <member name="P:NativeClientVSAddIn.PluginFoundEventArgs.ProcessID">
+            <summary>
+            Process ID of the found plug-in
+            </summary>
+        </member>
+        <member name="T:NativeClientVSAddIn.IProcessSearcher">
+            <summary>
+            Represents the standardized utility for retrieving the list
+            of running processes on the system
+            </summary>
+        </member>
+        <member name="M:NativeClientVSAddIn.IProcessSearcher.GetResults(System.String)">
+            <summary>
+            Returns results of a process search subject to given constraints
+            </summary>
+            <param name="constraints">Constraints in the form 'field=target'</param>
+            <returns>List of matching processes</returns>
+        </member>
+        <member name="M:NativeClientVSAddIn.IProcessSearcher.GetResultsByName(System.String)">
+            <summary>
+            Searches the system for all processes of a given name
+            </summary>
+            <param name="name">Name to search for</param>
+            <returns>List of matching processes</returns>
+        </member>
+        <member name="M:NativeClientVSAddIn.IProcessSearcher.GetResultsByID(System.UInt32)">
+            <summary>
+            Searches the system for all processes of a given process ID
+            </summary>
+            <param name="procID">ID to search for</param>
+            <returns>List of matching processes</returns>
+        </member>
+        <member name="T:NativeClientVSAddIn.ProcessInfo">
+            <summary>
+            Holds information about a process for a IProcessSearcher
+            </summary>
+        </member>
+        <member name="M:NativeClientVSAddIn.ProcessInfo.#ctor(System.UInt32,System.UInt32,System.String,System.String,System.String)">
+            <summary>
+            Constructs a process entry
+            </summary>
+            <param name="id">Process ID</param>
+            <param name="parentId">Process ID of the parent process</param>
+            <param name="creationDate">
+            String date in format 'yyyyMMddHHmmss.ffffff', or if empty then current time used.
+            </param>
+            <param name="commandLine">Command line arguments to the process</param>
+            <param name="name">Process name</param>
+        </member>
+        <member name="P:NativeClientVSAddIn.ProcessInfo.ID">
+            <summary>
+            Process ID
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.ProcessInfo.ParentID">
+            <summary>
+            Process ID of the parent process
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.ProcessInfo.CreationDate">
+            <summary>
+            DateTime of the process creation
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.ProcessInfo.CommandLine">
+            <summary>
+            Command line arguments to the process
+            </summary>
+        </member>
+        <member name="P:NativeClientVSAddIn.ProcessInfo.Name">
+            <summary>
+            Name of the process
+            </summary>
+        </member>
+        <member name="T:NativeClientVSAddIn.Utility">
+            <summary>
+            Contains helper functions for this add-in
+            </summary>
+        </member>
+        <member name="M:NativeClientVSAddIn.Utility.IsVisualCProject(EnvDTE.Project)">
+            <summary>
+            Tells us if the given project is a Visual C/C++ project
+            </summary>
+            <param name="proj">Project to check</param>
+            <returns>True if project is a Visual C/C++ project</returns>
+        </member>
+        <member name="M:NativeClientVSAddIn.Utility.GetActiveVCConfiguration(EnvDTE.Project)">
+            <summary>
+            Given a generic project, checks that it is a Visual C project, and
+            extracts the active VCConfiguration object
+            </summary>
+            <param name="proj">Generic project object</param>
+            <returns>The active configuration, or null if failure</returns>
+        </member>
+        <member name="M:NativeClientVSAddIn.Utility.IsDescendantOfProcess(NativeClientVSAddIn.IProcessSearcher,System.UInt32,System.UInt32)">
+            <summary>
+            Checks if the first argument is a descendant of the second, where
+            both arguments are process IDs of two processes.
+            </summary>
+            <param name="processSearcher">Process searcher object</param>
+            <param name="descendant">Process ID of the descendant</param>
+            <param name="ancestor">Process ID of ancestor</param>
+            <returns>True if descendant is a descendant of ancestor</returns>
+        </member>
+        <member name="M:NativeClientVSAddIn.Utility.IsDescendantOfProcessHelper(NativeClientVSAddIn.IProcessSearcher,System.UInt32,System.UInt32,System.DateTime)">
+            <summary>
+            Helper function for IsDescendantOfProcessHelper
+            This function prevents an edge case where a process has a parent process ID
+            that refers to a descendant of itself. This can occur when the parent of a process
+            is destroyed and the parent's pid is recycled and reused on a descendant.  The
+            parent process ID value is never updated when the parent is destroyed. The solution
+            is to ensure that parents are created before children.
+            </summary>
+            <param name="processSearcher">Process searcher object</param>
+            <param name="descendant">Process ID of the descendant</param>
+            <param name="anscestor">Process ID of the ancestor</param>
+            <param name="previousCreationTime">Creation time of the previous call's descendant</param>
+            <returns>True if descendant is a descendant of ancestor</returns>
+        </member>
+        <member name="M:NativeClientVSAddIn.Utility.Contains(System.String,System.String,System.StringComparison)">
+            <summary>
+            Extends the String class to allow checking if a string contains another string
+            with case-insensitivity
+            </summary>
+            <param name="source">Base string</param>
+            <param name="toCheck">String to check if contained within base string</param>
+            <param name="comparison">Comparison type</param>
+            <returns>True if toCheck is contained in source</returns>
+        </member>
+        <member name="T:NativeClientVSAddIn.ProcessSearcher">
+            <summary>
+            Queries the system for the list of running processes
+            </summary>
+        </member>
+        <member name="M:NativeClientVSAddIn.ProcessSearcher.GetResults(System.String)">
+            <summary>
+            Returns results of a process search subject to given constraints
+            </summary>
+            <param name="constraints">Constraints in the form 'field=target'</param>
+            <returns>List of matching processes</returns>
+        </member>
+        <member name="M:NativeClientVSAddIn.ProcessSearcher.GetResultsByName(System.String)">
+            <summary>
+            Searches the system for all processes of a given name
+            </summary>
+            <param name="name">Name to search for</param>
+            <returns>List of matching processes</returns>
+        </member>
+        <member name="M:NativeClientVSAddIn.ProcessSearcher.GetResultsByID(System.UInt32)">
+            <summary>
+            Searches the system for all processes of a given process ID
+            </summary>
+            <param name="procID">ID to search for</param>
+            <returns>List of matching processes</returns>
+        </member>
+        <member name="T:NativeClientVSAddIn.Connect">
+            <summary>The object for implementing an Add-in</summary>
+            <seealso class='IDTExtensibility2' />
+        </member>
+        <member name="M:NativeClientVSAddIn.Connect.OnConnection(System.Object,Extensibility.ext_ConnectMode,System.Object,System.Array@)">
+            <summary>
+            Implements the OnConnection method of the IDTExtensibility2 interface.
+            Receives notification that the Add-in is being loaded.
+            </summary>
+            <param term='application'>Root object of the host application.</param>
+            <param term='connectMode'>Describes how the Add-in is being loaded.</param>
+            <param term='addInInst'>Object representing this Add-in.</param>
+            <seealso class='IDTExtensibility2' />
+        </member>
+        <member name="M:NativeClientVSAddIn.Connect.DebuggerOnEnterDesignMode(EnvDTE.dbgEventReason)">
+            <summary>
+            Called when Visual Studio ends a debugging session
+            </summary>
+            <param name="reason">Unused</param>
+        </member>
+        <member name="M:NativeClientVSAddIn.Connect.DebuggerOnEnterRunMode(EnvDTE.dbgEventReason)">
+            <summary>
+            Called when Visual Studio starts a debugging session
+            </summary>
+            <param name="reason"></param>
+        </member>
+        <member name="M:NativeClientVSAddIn.Connect.OnDisconnection(Extensibility.ext_DisconnectMode,System.Array@)">
+            <summary>
+            Implements the OnDisconnection method of the IDTExtensibility2
+            interface. Receives notification that the Add-in is being unloaded.
+            </summary>
+            <param term='disconnectMode'>Describes how the Add-in is being unloaded.</param>
+            <param term='custom'>Array of parameters that are host application specific.</param>
+            <seealso class='IDTExtensibility2' />
+        </member>
+        <member name="M:NativeClientVSAddIn.Connect.OnAddInsUpdate(System.Array@)">
+            <summary>
+            Implements the OnAddInsUpdate method of the IDTExtensibility2 interface.
+            Receives notification when the collection of Add-ins has changed.
+            </summary>
+            <param term='custom'>Array of parameters that are host application specific.</param>
+            <seealso class='IDTExtensibility2' />
+        </member>
+        <member name="M:NativeClientVSAddIn.Connect.OnStartupComplete(System.Array@)">
+            <summary>
+            Implements the OnStartupComplete method of the IDTExtensibility2
+            interface. Receives notification that the host application has completed loading.
+            </summary>
+            <param term='custom'>Array of parameters that are host application specific.</param>
+            <seealso class='IDTExtensibility2' />
+        </member>
+        <member name="M:NativeClientVSAddIn.Connect.OnBeginShutdown(System.Array@)">
+            <summary>
+            Implements the OnBeginShutdown method of the IDTExtensibility2 interface.
+            Receives notification that the host application is being unloaded.
+            </summary>
+            <param term='custom'>Array of parameters that are host application specific.</param>
+            <seealso class='IDTExtensibility2' />
+        </member>
+        <member name="M:NativeClientVSAddIn.Connect.IsNativeClientSolution">
+            <summary>
+            Tells us if this add-in is applicable within this solution
+            </summary>
+            <returns>True if this add-in is applicable to this solution</returns>
+        </member>
+        <member name="F:NativeClientVSAddIn.Connect.DebuggerHelper">
+            <summary>
+            Holds methods related to running the plug-in and debugging
+            </summary>
+        </member>
+    </members>
+</doc>