actors: Added docstrings to some message write procedures
authorChristopher Allan Webber <cwebber@dustycloud.org>
Fri, 22 Apr 2016 14:24:44 +0000 (09:24 -0500)
committerChristopher Allan Webber <cwebber@dustycloud.org>
Mon, 25 Apr 2016 14:25:36 +0000 (09:25 -0500)
* 8sync/systems/actors.scm (write-message, serialize-message-pretty)
  (pprint-message): Add docstrings.

8sync/systems/actors.scm

index 40c5c5712e5822df9a03f2b5bd7e81ce24cf7714..2d42897a03740c3be374473d192d9b463e289a71 100644 (file)
@@ -561,9 +561,15 @@ an integer."
    (message-deferred-reply message)))
 
 (define (write-message message port)
+  "Write out a message to a port for easy reading later.
+
+Note that if a sub-value can't be easily written to something
+Guile's `read' procedure knows how to read, this doesn't do anything
+to improve that.  You'll need a better serializer for that.."
   (write (serialize-message message) port))
 
 (define (serialize-message-pretty message)
+  "Serialize a message in a way that's easy for humans to read."
   `(*message*
     (id ,(message-id message))
     (to ,(message-to message))
@@ -575,4 +581,5 @@ an integer."
     (deferred-reply ,(message-deferred-reply message))))
 
 (define (pprint-message message)
+  "Pretty print a message."
   (pretty-print (serialize-message-pretty message)))