]> git.cworth.org Git - notmuch/commitdiff
sprinter: clarify separator documentation
authorJani Nikula <jani@nikula.org>
Sun, 16 Dec 2012 22:05:09 +0000 (00:05 +0200)
committerDavid Bremner <bremner@debian.org>
Tue, 18 Dec 2012 21:03:24 +0000 (17:03 -0400)
For text printers, the separator is a syntactic element.

sprinter.h

index 59776a9c7e476522fc6c21b48d34cfb0f8a1ea49..f43a8443f2352b3583e2f976b501907164373724 100644 (file)
@@ -42,10 +42,11 @@ typedef struct sprinter {
      */
     void (*map_key) (struct sprinter *, const char *);
 
-    /* Insert a separator (usually extra whitespace) for improved
-     * readability without affecting the abstract syntax of the
-     * structure being printed.
-     * For JSON, this could simply be a line break.
+    /* Insert a separator (usually extra whitespace). For the text
+     * printers, this is a syntactic separator. For the structured
+     * printers, this is for improved readability without affecting
+     * the abstract syntax of the structure being printed. For JSON,
+     * this could simply be a line break.
      */
     void (*separator) (struct sprinter *);