Added some comments and reversed upb_arena_cleanup() args.

2 files changed, 5 insertions, 0 deletions

diff --git a/upb/pb/decoder.h b/upb/pb/decoder.h
index 5adfba8..86e51df 100644
--- a/upb/pb/decoder.h
+++ b/upb/pb/decoder.h
@@ -171,6 +171,9 @@ class upb::pb::DecoderPtr {
 
 /* upb_pbcodecache ************************************************************/
 
+/* Lazily builds and caches decoder methods that will push data to the given
+ * handlers.  The destination handlercache must outlive this object. */
+
 struct upb_pbcodecache;
 typedef struct upb_pbcodecache upb_pbcodecache;
 
diff --git a/upb/pb/encoder.h b/upb/pb/encoder.h
index 780f60f..1113c3a 100644
--- a/upb/pb/encoder.h
+++ b/upb/pb/encoder.h
@@ -43,6 +43,8 @@ upb_sink upb_pb_encoder_input(upb_pb_encoder *p);
 upb_pb_encoder* upb_pb_encoder_create(upb_arena* a, const upb_handlers* h,
                                       upb_bytessink output);
 
+/* Lazily builds and caches handlers that will push encoded data to a bytessink.
+ * Any msgdef objects used with this object must outlive it. */
 upb_handlercache *upb_pb_encoder_newcache();
 
 #ifdef __cplusplus