dom watcher: Turn the dom watcher into an opaque object.

1 files changed, 13 insertions, 7 deletions

diff --git a/src/dom/watcher.h b/src/dom/watcher.h
index 87f0a1b..2894db6 100644
--- a/src/dom/watcher.h
+++ b/src/dom/watcher.h
@@ -5,7 +5,7 @@
  */
 
 /** \file src/dom/watcher.h
- * Layout object handling
+ * Interface to DOM mutation watching.
  */
 
 #ifndef nslayout_dom_watcher_h_
@@ -13,20 +13,26 @@
 
 #include <libnslayout/nslayout.h>
 
+struct nsl_dom_watcher;
+
 /**
- * Add DOM change watchers to the layout's document.'
+ * Create DOM change watcher for a DOM document.
  *
- * \param[in]  layout		nslayout_layout object to set watchers for.
+ * \param[out]  watcher_out  Returns a dom watcher object for layout.
+ * \param[in]   document     DOM document to create watcher for.
  * \return NSLAYOUT_OK on success, appropriate error otherwise.
  */
-nslayout_error nsl_dom_watcher_add_for_layout(nslayout_layout *layout);
+nslayout_error nsl_dom_watcher_create(
+		struct nsl_dom_watcher **watcher_out,
+		dom_document *document);
 
 /**
- * Remove DOM change watchers from the layout's document.
+ * Destroy a document change DOM change watcher.
  *
- * \param[in]  layout		nslayout_layout object remove watchers from.
+ * \param[in]  watcher  DOM change watcher to destroy.
  * \return NSLAYOUT_OK on success, appropriate error otherwise.
  */
-nslayout_error nsl_dom_watcher_remove_for_layout(nslayout_layout *layout);
+nslayout_error nsl_dom_watcher_destroy(
+		struct nsl_dom_watcher *watcher);
 
 #endif