summaryrefslogtreecommitdiffstats
path: root/tdeinit/README.DCOP
diff options
context:
space:
mode:
authorDarrell Anderson <humanreadable@yahoo.com>2013-05-17 12:44:40 -0500
committerDarrell Anderson <humanreadable@yahoo.com>2013-05-17 12:44:40 -0500
commit47a706a785ee2497fd7ebcf8176364a09f23ae07 (patch)
tree114871fa1729954446b676623b93dfb457474e88 /tdeinit/README.DCOP
parent931f86e56b6e7139870ae37e7a86629176af57d4 (diff)
downloadtdelibs-47a706a785ee2497fd7ebcf8176364a09f23ae07.tar.gz
tdelibs-47a706a785ee2497fd7ebcf8176364a09f23ae07.zip
Rename remnant files and references from kinit -> tdeinit.
Diffstat (limited to 'tdeinit/README.DCOP')
-rw-r--r--tdeinit/README.DCOP83
1 files changed, 83 insertions, 0 deletions
diff --git a/tdeinit/README.DCOP b/tdeinit/README.DCOP
new file mode 100644
index 000000000..cd5ba983e
--- /dev/null
+++ b/tdeinit/README.DCOP
@@ -0,0 +1,83 @@
+"TDELauncher" supports the following DCOP functions:
+
+/**
+ * Starts a program.
+ * 'envs' are environment variables that will be added
+ * to this program's environment before starting it
+ * 'startup_id' is for application startup notification,
+ * "" is the default, "0" for none
+ */
+void exec_blind(QCString name, QValueList<QCString> argList,
+ QValueList<QCString> envs, QCString startup_id );
+void exec_blind(QCString name, QValueList<QCString> argList);
+
+/**
+ * Start a service by name.
+ *
+ * 'serviceName' refers to the service name as given by
+ * the Name field in the desktop file describing the service.
+ *
+ * 'url', if not empty, will be passed to the service as
+ * argument.
+ *
+ * 'envs' are environment variables that will be added
+ * to this program's environment before starting it
+ *
+ * 'startup_id' is for application startup notification,
+ * "" is the default, "0" for none
+ */
+serviceResult start_service_by_name(QString serviceName, QStringList url,
+ QValueList<QCString> envs, QCString startup_id );
+serviceResult start_service_by_name(QString serviceName, QStringList url)
+
+/**
+ * Start a service by desktop path.
+ *
+ * 'serviceName' refers to a desktop file describing the service.
+ * This may be an absolute path or a path relative to $TDEDIRS/applnk
+ * and/or $TDEDIRS/services
+ * E.g. it should have the form "Applications/korganizer.desktop" or
+ * "/opt/kde/share/applnk/Applications/korganizer.desktop".
+ *
+ * 'url', if not empty, will be passed to the service as
+ * argument.
+ *
+ * 'envs' are environment variables that will be added
+ * to this program's environment before starting it
+ *
+ * 'startup_id' is for application startup notification,
+ * "" is the default, "0" for none
+ */
+serviceResult start_service_by_desktop_path(QString serviceName, QStringList url,
+ QValueList<QCString> envs, QCString startup_id );
+serviceResult start_service_by_desktop_path(QString serviceName, QStringList url)
+
+
+/**
+ * Start a service by desktop name.
+ *
+ * 'serviceName' refers to a desktop file describing the service.
+ * The service is looked up anywhere in $TDEDIR/applnk and/or
+ * $TDEDIR/services.
+ * E.g. it should have the form "korganizer".
+ *
+ * 'url', if not empty, will be passed to the service as
+ * argument.
+ *
+ * 'envs' are environment variables that will be added
+ * to this program's environment before starting it
+ *
+ * 'startup_id' is for application startup notification,
+ * "" is the default, "0" for none
+ */
+serviceResult start_service_by_desktop_name(QString serviceName, QStringList url,
+ QValueList<QCString> envs, QCString startup_id );
+serviceResult start_service_by_desktop_name(QString serviceName, QStringList url)
+
+struct serviceResult
+{
+ int result; // 0 means success. > 0 means error
+ QCString dcopName; // Contains DCOP name on success
+ QString error; // Contains error description on failure.
+}
+