|
@@ -29,10 +29,10 @@
|
|
|
* they are portable and, in a Linked Data server, can be easily replaced with
|
|
|
* absolute URLs based on the server root.
|
|
|
*
|
|
|
- * The `user_data` handle is a NULL-terminated array of user-defined graphs.
|
|
|
- * Each graph is given a user-defined label that is tacked on to the resource
|
|
|
- * URN and may or may not be consistent across resources, depending on how
|
|
|
- * repository managers organize their knowledge.
|
|
|
+ * The `user_data` handle is a {NULL}-terminated array of user-defined graphs.
|
|
|
+ * Each graph URI is considered relative to the resource URN and may or may not
|
|
|
+ * be consistent across resources, depending on how repository managers
|
|
|
+ * organize their knowledge.
|
|
|
*
|
|
|
* The `admin_data` graph contains exclusively triples managed by the
|
|
|
* repository. They may have special functionality attached and may be created
|
|
@@ -129,10 +129,10 @@ LSR_desc_free (LSR_Desc *rsrc);
|
|
|
* @param[in] rsrc Resource to be created or overwritten.
|
|
|
*/
|
|
|
LSUP_rc
|
|
|
-LSR_desc_store (LSR_Desc *rsrc);
|
|
|
+LSR_desc_store (const LSR_Desc *rsrc);
|
|
|
|
|
|
|
|
|
-/** Perform a delta update on a stored resource.
|
|
|
+/** @brief Perform a delta update on a stored resource.
|
|
|
*
|
|
|
* This function operates directly on a stored resource without the need to
|
|
|
* provide an in-memory DESC-R. It first deletes triples by given patterns,
|
|
@@ -149,4 +149,17 @@ LSR_desc_store (LSR_Desc *rsrc);
|
|
|
LSUP_rc
|
|
|
LSUP_desc_update (LSR_id id, LSUP_Term **remove, LSUP_Triple *add);
|
|
|
|
|
|
+
|
|
|
+/** @brief Delete a DESC-R.
|
|
|
+ *
|
|
|
+ * TODO Soft-deletes to be implemented with versioning.
|
|
|
+ *
|
|
|
+ * @param[in] id Resource ID.
|
|
|
+ *
|
|
|
+ * @return LSUP_OK if the resource was found and deleted; LSUP_NOACTION if no
|
|
|
+ * resource was found for the given ID.
|
|
|
+ */
|
|
|
+LSUP_rc
|
|
|
+LSUP_desc_delete (LSR_id id);
|
|
|
+
|
|
|
#endif /* _LSR_DESC_H */
|