[Rprotobuf-commits] r836 - papers/jss

[noreply at r-forge.r-project.org]

Author: murray
Date: 2014-01-23 04:09:10 +0100 (Thu, 23 Jan 2014)
New Revision: 836

Modified:
   papers/jss/article.Rnw
Log:
Improve the text about serializing messages.  Don't start the section
with "However".



Modified: papers/jss/article.Rnw
===================================================================
--- papers/jss/article.Rnw	2014-01-23 03:01:59 UTC (rev 835)
+++ papers/jss/article.Rnw	2014-01-23 03:09:10 UTC (rev 836)
@@ -585,12 +585,13 @@
 
 \subsection{Serializing messages}
 
-However, the main focus of Protocol Buffer messages is
-efficiency. Therefore, messages are transported as a sequence
-of bytes. The \texttt{serialize} method is implemented for
+One of the primary benefits of Protocol Buffers is the efficient
+binary wire-format representation.  
+The \texttt{serialize} method is implemented for
 Protocol Buffer messages to serialize a message into a sequence of
-bytes that represents the message.
-%(raw vector in \proglang{R} speech) that represents the message.
+bytes (raw vector) that represents the message.
+The raw bytes can then be parsed back into the original message safely
+as long as the message type is known and its descriptor is available.
 
 <<>>=
 serialize(p, NULL)