Renaming and some docs

src/encode.h

@@ -25,14 +25,15 @@ struct internal_state {
     uint32_t *data_pp;      /* RSI blocks of preprocessed input */
     uint32_t *data_raw;     /* RSI blocks of input */
     int blocks_avail;       /* remaining blocks in buffer */
-    uint32_t *block_p;      /* pointer to current block */
+    uint32_t *block;        /* current (preprocessed) input block */
     int block_len;          /* input block length in byte */
-    uint8_t *cds_buf;       /* Buffer for one Coded Data Set */
+    uint8_t *cds;           /* current Coded Data Set output */
+    uint8_t *cds_buf;       /* buffer for one CDS (only used if
+                             * strm->next_out cannot hold full CDS) */
     int cds_len;            /* max cds length in byte */
-    uint8_t *cds_p;         /* pointer to current output */
-    int direct_out;         /* output to strm->next_out (1)
+    int direct_out;         /* cds points to strm->next_out (1)
                              * or cds_buf (0) */
-    int bit_p;              /* bit pointer to the next unused bit in
+    int bits;               /* Free bits (LSB) in output buffer or
                              * accumulator */
     int ref;                /* length of reference sample in current
                              * block i.e. 0 or 1 depending on whether
@@ -42,7 +43,7 @@ struct internal_state {
     int64_t zero_ref_sample;/* reference sample of zero block */
     int zero_blocks;        /* number of contiguous zero blocks */
     int k;                  /* splitting position */
-    int kmax;
+    int kmax;               /* maximum number for k depending on id_len */
     int flush;              /* flush option copied from argument */
 };