branch: elpa/fedi
commit 4d776332d6425a917cb437fc17831fa834c881d2
Author: marty hiatt <[email protected]>
Commit: marty hiatt <[email protected]>

    comments on using update functions.
---
 fedi.el | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/fedi.el b/fedi.el
index c8a5f4b0a16..aaccb4dc0a5 100644
--- a/fedi.el
+++ b/fedi.el
@@ -631,6 +631,15 @@ even though the request may have succeeded."
 
 ;;; UPDATING ITEMS
 
+;; these functions can be used to update the display after an action
+;; (edit/delete/bookmark/create, etc.).
+
+;; Currently, the model is to first update an item's data in the json text
+;; property, then to update the item based on that data. This separation is
+;; because we always want to update the json property for the entire item, but
+;; we don't always then want to update display of the entire item, but only
+;; part of it (a byline/status line, etc.). See lem-ui.el for examples of 
using these update functions.
+
 (defun fedi--update-item-json (new-json)
   "Replace the json property of item at point with NEW-JSON."
   (let ((inhibit-read-only t)

Reply via email to