summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2009-05-27 20:20:40 +0000
committerDavid Robillard <d@drobilla.net>2009-05-27 20:20:40 +0000
commit2d90647f9f6f36ac424a6b8f2e86e110eb0c5fd2 (patch)
tree4a47c999341a1dda6ec7dfe16f1ca1ab9d446928 /src
parentaad41d097d9d4e3aff25616f86fa3a77653a10d1 (diff)
downloadingen-2d90647f9f6f36ac424a6b8f2e86e110eb0c5fd2.tar.gz
ingen-2d90647f9f6f36ac424a6b8f2e86e110eb0c5fd2.tar.bz2
ingen-2d90647f9f6f36ac424a6b8f2e86e110eb0c5fd2.zip
Documentation.
git-svn-id: http://svn.drobilla.net/lad/trunk/ingen@2014 a436a847-0d15-0410-975c-d299462d15a1
Diffstat (limited to 'src')
-rw-r--r--src/engine/Event.cpp28
-rw-r--r--src/engine/events/DeleteEvent.hpp5
-rw-r--r--src/engine/events/MoveEvent.hpp6
3 files changed, 33 insertions, 6 deletions
diff --git a/src/engine/Event.cpp b/src/engine/Event.cpp
index e48d32a2..f79c975a 100644
--- a/src/engine/Event.cpp
+++ b/src/engine/Event.cpp
@@ -26,6 +26,34 @@
* HTTP and WebDAV standards as closely as possible.</p>
*/
+
+/** \page methods
+ * <h2>POST</h2>
+ * As per HTTP (RFC2616 S9.5).
+ *
+ * Append properties to a graph object.
+ *
+ * An object can have several properties with a single predicate.
+ * POST appends properties without modifying or removing existing properties.
+ */
+
+
+/** \page methods
+ * <h2>PUT</h2>
+ * As per HTTP (RFC2616 S9.6).
+ *
+ * Set properties of a graph object, or create an object.
+ *
+ * An object can have several properties with a single predicate.
+ * \li If the object does not yet exist, the message must contain sufficient
+ * information to create the object (e.g. known rdf:type properties, etc.)
+ * \li If the object does exist, a PUT removes all existing object properties
+ * with predicates that match any property in the message, then adds all
+ * properties from the message.
+ */
+
+
+
namespace Ingen {
diff --git a/src/engine/events/DeleteEvent.hpp b/src/engine/events/DeleteEvent.hpp
index 05c47325..abaf9cdd 100644
--- a/src/engine/events/DeleteEvent.hpp
+++ b/src/engine/events/DeleteEvent.hpp
@@ -38,10 +38,9 @@ class CompiledPatch;
/** \page methods
* <h2>DELETE</h2>
- * From WebDAV (RFC4918 S9.6).
+ * As per WebDAV (RFC4918 S9.6).
*
- * Calling DELETE on an object will remove that object from the engine
- * (i.e. stop executing it) and destroy it.
+ * Remove an object from the engine and destroy it.
*
* \li All properties of the object are lost
* \li All references to the object are lost (e.g. the parent's reference to
diff --git a/src/engine/events/MoveEvent.hpp b/src/engine/events/MoveEvent.hpp
index 7b77439f..06b410fb 100644
--- a/src/engine/events/MoveEvent.hpp
+++ b/src/engine/events/MoveEvent.hpp
@@ -28,10 +28,10 @@ class PatchImpl;
/** \page methods
* <h2>MOVE</h2>
- * From WebDAV (RFC4918 S9.9).
+ * As per WebDAV (RFC4918 S9.9).
*
- * Calling MOVE on an object removes it from its current location
- * and inserts it at a new one in a single operation.
+ * Move an object from its current location and insert it at a new location
+ * in a single operation.
*
* MOVE to a path with a different parent is currently not supported.
*/