shill: fix profile-api documentation, remove stale comments in dbus_bindings

Profile.DeleteEntry was documented as expecting a D-Bus path,
when, in fact, it takes a string.

While there, remove a stale comment about auto-generating the XML
files, and installing them to a system directory. The first can't
be done, because this XML is how we generate RPC stubs in the first
place; the second is already done in the Makefile.

BUG=None
TEST=emerge-link shill

Change-Id: I3dbd41ece19cbda147bf894f66b5b29a47b7651a
Reviewed-on: https://gerrit.chromium.org/gerrit/59458
Tested-by: mukesh agrawal <quiche@chromium.org>
Reviewed-by: Darin Petkov <petkov@chromium.org>
Commit-Queue: mukesh agrawal <quiche@chromium.org>
diff --git a/dbus_bindings/org.chromium.flimflam.Device.xml b/dbus_bindings/org.chromium.flimflam.Device.xml
index 0f7cc13..8120263 100644
--- a/dbus_bindings/org.chromium.flimflam.Device.xml
+++ b/dbus_bindings/org.chromium.flimflam.Device.xml
@@ -1,12 +1,6 @@
 <!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
 "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
 
-<!-- 
-     Introspection dump generated manually by poking flimflam with dbus-send
-     TODO(vlaviano): should be generated automatically during flimflam build
-     and installed somewhere where cashew and other clients can consume it.
--->
-
 <node>
 	<interface name="org.chromium.flimflam.Device">
 		<method name="GetProperties">
diff --git a/dbus_bindings/org.chromium.flimflam.IPConfig.xml b/dbus_bindings/org.chromium.flimflam.IPConfig.xml
index 04aa563..1036188 100644
--- a/dbus_bindings/org.chromium.flimflam.IPConfig.xml
+++ b/dbus_bindings/org.chromium.flimflam.IPConfig.xml
@@ -1,12 +1,6 @@
 <!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
 "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
 
-<!-- 
-     Introspection dump generated manually by poking flimflam with dbus-send
-     TODO(vlaviano): should be generated automatically during flimflam build
-     and installed somewhere where cashew and other clients can consume it.
--->
-
 <node>
 	<interface name="org.chromium.flimflam.IPConfig">
 		<method name="GetProperties">
diff --git a/dbus_bindings/org.chromium.flimflam.Manager.xml b/dbus_bindings/org.chromium.flimflam.Manager.xml
index 0275b1c..bb25bd2 100644
--- a/dbus_bindings/org.chromium.flimflam.Manager.xml
+++ b/dbus_bindings/org.chromium.flimflam.Manager.xml
@@ -1,12 +1,6 @@
 <!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
 "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
 
-<!-- 
-     Introspection dump generated manually by poking flimflam with dbus-send
-     TODO(vlaviano): should be generated automatically during flimflam build
-     and installed somewhere where cashew and other clients can consume it.
--->
-
 <node>
 	<interface name="org.chromium.flimflam.Manager">
 		<method name="GetProperties">
diff --git a/dbus_bindings/org.chromium.flimflam.Profile.xml b/dbus_bindings/org.chromium.flimflam.Profile.xml
index a0ef15c..ede250e 100644
--- a/dbus_bindings/org.chromium.flimflam.Profile.xml
+++ b/dbus_bindings/org.chromium.flimflam.Profile.xml
@@ -1,12 +1,6 @@
 <!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
 "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
 
-<!-- 
-     Introspection dump generated manually by poking flimflam with dbus-send
-     TODO(vlaviano): should be generated automatically during flimflam build
-     and installed somewhere where cashew and other clients can consume it.
--->
-
 <node>
 	<interface name="org.chromium.flimflam.Profile">
 		<method name="GetProperties">
diff --git a/dbus_bindings/org.chromium.flimflam.Service.xml b/dbus_bindings/org.chromium.flimflam.Service.xml
index 55b55a0..c178c52 100644
--- a/dbus_bindings/org.chromium.flimflam.Service.xml
+++ b/dbus_bindings/org.chromium.flimflam.Service.xml
@@ -1,12 +1,6 @@
 <!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
 "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
 
-<!-- 
-     Introspection dump generated manually by poking flimflam with dbus-send
-     TODO(vlaviano): should be generated automatically during flimflam build
-     and installed somewhere where cashew and other clients can consume it.
--->
-
 <node>
 	<interface name="org.chromium.flimflam.Service">
 		<method name="GetProperties">
diff --git a/doc/profile-api.txt b/doc/profile-api.txt
index 7907684..c2c9d7b 100644
--- a/doc/profile-api.txt
+++ b/doc/profile-api.txt
@@ -101,7 +101,7 @@
 			Possible Errors: [service].Error.NotFound
 					 [service].Error.InvalidArguments
 
-		dict DeleteEntry(object path)
+		dict DeleteEntry(string entry_name)
 
 			Remove the entry from the profile.  Any associated
 			service has its security credentials revoked and