Document protocol

Fix invalid use of patch:request (use patch:sequenceNumber instead).

git-svn-id: http://svn.drobilla.net/lad/trunk/ingen@5781 a436a847-0d15-0410-975c-d299462d15a1

5 files changed, 4 insertions, 58 deletions

diff --git a/src/server/NodeImpl.hpp b/src/server/NodeImpl.hpp
index 457834f2..3a04e03b 100644
--- a/src/server/NodeImpl.hpp
+++ b/src/server/NodeImpl.hpp
@@ -83,8 +83,7 @@ public:
 
 	/** Apply a new (external) polyphony value.
 	 *
-	 * Audio thread.
-	 *
+	 * \param context Process context (process thread only).
 	 * \param poly Must be <= the most recent value passed to prepare_poly.
 	 * \param maid Any objects no longer needed will be pushed to this
 	 */
diff --git a/src/server/events/Copy.hpp b/src/server/events/Copy.hpp
index dfcbd3b2..2677ba53 100644
--- a/src/server/events/Copy.hpp
+++ b/src/server/events/Copy.hpp
@@ -33,15 +33,7 @@ class GraphImpl;
 
 namespace Events {
 
-/** \page methods
- * <h2>COPY</h2>
- * As per WebDAV (RFC4918 S9.8).
- *
- * Copy an object from its current location and insert it at a new location
- * in a single operation.
- */
-
-/** COPY a graph object to a new path (see \ref methods).
+/** Copy a graph object to a new path.
  * \ingroup engine
  */
 class Copy : public Event
diff --git a/src/server/events/Delete.hpp b/src/server/events/Delete.hpp
index 30a53b12..4403d4da 100644
--- a/src/server/events/Delete.hpp
+++ b/src/server/events/Delete.hpp
@@ -40,18 +40,7 @@ namespace Events {
 
 class DisconnectAll;
 
-/** \page methods
- * <h2>DELETE</h2>
- * As per WebDAV (RFC4918 S9.6).
- *
- * 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
- *     this child is lost, any connections to the object are removed, etc.)
- */
-
-/** DELETE a graph object (see \ref methods).
+/** Delete a graph object.
  * \ingroup engine
  */
 class Delete : public Event
diff --git a/src/server/events/Delta.hpp b/src/server/events/Delta.hpp
index 7c303fc2..f9ca0eec 100644
--- a/src/server/events/Delta.hpp
+++ b/src/server/events/Delta.hpp
@@ -42,30 +42,6 @@ class ProcessContext;
 
 namespace Events {
 
-/** \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.
- */
-
 class SetPortValue;
 
 /** Set properties of a graph object.
diff --git a/src/server/events/Move.hpp b/src/server/events/Move.hpp
index 3d1da94e..ae811138 100644
--- a/src/server/events/Move.hpp
+++ b/src/server/events/Move.hpp
@@ -30,17 +30,7 @@ class PortImpl;
 
 namespace Events {
 
-/** \page methods
- * <h2>MOVE</h2>
- * As per WebDAV (RFC4918 S9.9).
- *
- * 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.
- */
-
-/** MOVE a graph object to a new path (see \ref methods).
+/** Move a graph object to a new path.
  * \ingroup engine
  */
 class Move : public Event