Renames view manager Connect methods to Embed

mojo/services/public/interfaces/view_manager/view_manager.mojom

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 import "../geometry/geometry.mojom"
 import "../input_events/input_events.mojom"
 
 module mojo.view_manager {
 
 struct INode {
   uint32 parent_id;
   uint32 node_id;
   uint32 view_id;
   mojo.Rect bounds;
 };
 
 // IViewManagerInit is responsible for launching the client that controls the
 // root node. mojo::view_manager returns an instance of this. All other
 // connections are established by the client this creates.
 interface IViewManagerInit {
-  // Connects to |url| creating a connection that has the roots |nodes|.
-  Connect(string url) => (bool success);
+  EmbedRoot(string url) => (bool success);
 };
 
 // Functions that mutate the hierarchy take a change id. This is an ever
 // increasing integer used to identify the change. Every hierarchy change
 // increases this value. The server only accepts changes where the supplied
 // |server_change_id| matches the expected next value. This ensures changes are
 // made in a well defined order.
 //
 // Nodes and Views are identified by a uint32. The upper 16 bits are the
 // connection id, and the lower 16 the id assigned by the client.
@@ skipping 57 matching lines @@
   DeleteView(uint32 view_id) => (bool success);
 
   // Sets the view a node is showing.
   SetView(uint32 node_id, uint32 view_id) => (bool success);
 
   // Shows the specified image (png encoded) in the specified view.
   SetViewContents(uint32 view_id,
                   handle<shared_buffer> buffer,
                   uint32 buffer_size) => (bool success);
 
-  // Connects to |url| creating a connection that has the roots |nodes|. Fails
+  // Embeds the app at |url| in the specified nodes. More specifically this
+  // creates a new connection to the specified url, expecting to get an
+  // IViewManagerClient and configures it with the root nodes |nodes|. Fails
   // if |nodes| is empty or contains nodes that were not created by this
   // connection.
-  // If a particular client invokes Connect() multiple times with the same url,
+  // If a particular client invokes Embed() multiple times with the same url,
   // the connection is reused. When this happens the IViewManagerClient is
   // notified of the additional roots by way of OnRootsAdded().
-  Connect(string url, uint32[] nodes) => (bool success);
+  Embed(string url, uint32[] nodes) => (bool success);
 };
 
 // Changes to nodes/views are not sent to the connection that originated the
 // change. For example, if connection 1 attaches a view to a node (SetView())
 // connection 1 does not receive OnNodeViewReplaced().
 [Client=IViewManager]
 interface IViewManagerClient {
   // Invoked once the connection has been established. |connection_id| is the id
   // that uniquely identifies this connection. |next_server_change_id| is the
   // id of the next change the server is expecting. |nodes| are the nodes
@@ skipping 37 matching lines @@
   OnNodeViewReplaced(uint32 node, uint32 new_view_id, uint32 old_view_id);
 
   // Invoked when a view is deleted.
   OnViewDeleted(uint32 view);
 
   // Invoked when an event is targeted at the specified view.
   OnViewInputEvent(uint32 view, mojo.Event event) => ();
 };
 
 }