summaryrefslogtreecommitdiffstats
path: root/kmrml/README.DEVELOPMENT
diff options
context:
space:
mode:
Diffstat (limited to 'kmrml/README.DEVELOPMENT')
-rw-r--r--kmrml/README.DEVELOPMENT41
1 files changed, 41 insertions, 0 deletions
diff --git a/kmrml/README.DEVELOPMENT b/kmrml/README.DEVELOPMENT
new file mode 100644
index 00000000..6fbe600d
--- /dev/null
+++ b/kmrml/README.DEVELOPMENT
@@ -0,0 +1,41 @@
+This file gives an overview of the structure of the kmrml package.
+
+kmrml consists of the following:
+
+- kio_mrml: an ioslave that is able to contact an mrml daemon (i.e. the GIFT)
+ and transports the data from the daemon to its master (i.e. the
+ MrmlPart) as XML (MRML, Multimedia Retrieval Markup Language)
+
+- MrmlPart: the konqueror-embeddable controller and view
+
+- mrmlsearch: a small tool that is e.g. called from Konqueror's ContextMenu
+ "Search for similar images" to start an image query.
+
+- kcontrol/: a KDE Control Center module for configuring parts of the GIFT,
+ i.e. indexing directories, specifying GIFT hosts, etc.
+
+- server/: a kded module, i.e. a tiny little daemon, that can be told via
+ DCOP to start, restart upon failure and automatically/manually
+ stop services. It is completely independent of GIFT/kmrml.
+ It is used to have one centralized place where the gift server
+ is started (ensuring this happens only once, restarting it upon
+ failure and stopping the gift after all kio_mrml instances
+ have been killed.
+
+lib/: common stuff used by more than one module
+
+
+Useful URLs:
+
+The MRML DTD:
+http://savannah.gnu.org/cgi-bin/viewcvs/*checkout*/gift/gift/dtd/mrml.dtd?rev=HEAD&content-type=text/plain
+
+The GIFT Homepage:
+http://www.gnu.org/software/gift
+
+The fer-de-lance project homepage, under which the GIFT and kmrml are living
+http://www.fer-de-lance.org
+
+
+2002/08/08
+Carsten Pfeiffer <pfeiffer@kde.org>