Further renaming of DBus variables (object -> app_interface/doc_interface

and doc_context -> target)
Fixes to application interface for document_new (now only works in
console mode, and behaves as expected)

(bzr r12387.1.8)

1 files changed, 5 insertions, 4 deletions

diff --git a/src/extension/dbus/application-interface.xml b/src/extension/dbus/application-interface.xml
index 4185c7e53..1553971cc 100644
--- a/src/extension/dbus/application-interface.xml
+++ b/src/extension/dbus/application-interface.xml
@@ -32,7 +32,7 @@
       </arg>
       <doc:doc>
         <doc:description>
-          <doc:para>Create a new document interface and return its location.</doc:para>
+          <doc:para>Create a new document interface and return its location. Only call this when Inkscape is running in GUI mode.</doc:para>
         </doc:description>
       </doc:doc>
     </method>
@@ -45,21 +45,21 @@
       </arg>
       <doc:doc>
         <doc:description>
-          <doc:para>List all the interfaces that it is possible to connect to.</doc:para>
+          <doc:para>List all the interfaces that it is possible to connect to. TODO: not implemented.</doc:para>
         </doc:description>
       </doc:doc>
     </method>
     <method name="desktop_close_all">
       <doc:doc>
         <doc:description>
-          <doc:para>Close all document interfaces without saving.</doc:para>
+          <doc:para>Close all document interfaces without saving. TODO: not implemented.</doc:para>
         </doc:description>
       </doc:doc>
     </method>
     <method name="exit">
       <doc:doc>
         <doc:description>
-          <doc:para>Exit Inkscape without saving (in GUI mode).  Fairly straightforward.</doc:para>
+          <doc:para>Exit Inkscape without saving.  Fairly straightforward.</doc:para>
         </doc:description>
       </doc:doc>
     </method>
@@ -77,6 +77,7 @@
           <doc:para>Originally, there were going to be two interfaces.  A desktop and a document.  Desktops would be used when the user wanted to see the result of their code and documents would be used when less overhead was desired.  Unfortunately as more and more of the code can to rely on the desktop and it's associated support code (including selections and verbs) the document interface was looking more and more limited.  Ultimately I decided to just go with the desktop interface since I didn't have a compelling reason for keeping the other one and having two similar interfaces could be very confusing.  The desktop interface inherited the document name because I believe it's more familiar to people.</doc:para>
           <doc:para>Perhaps it would be best to have an option as to whether or not to create a window and fail with a good error message when they call a function that requires one.  Or have a second interface for different use cases but have it be completely different, rather than a subset of the first if there are use cases that support it.</doc:para>
           <doc:para>UPDATE: 3rd July 2013, Eric Greveson: After having done some initial work to attempt to decouple Inkscape "verbs" from desktops, it is now possible to run a limited subset of actions in command-line mode (with a selection model and document, but no desktop). I believe that the "single document interface" approach, with some functions that may require a GUI, is the better path, and so document interfaces without a desktop are now possible. Most functions still require the desktop to work, though, with the notable exception of selection methods and Boolean operations.</doc:para>
+          <doc:para>As a result, this function should ONLY be called when using Inkscape in command-line mode. Use "desktop_new" instead if running in GUI mode.</doc:para>
         </doc:description>
       </doc:doc>
     </method>