Counting post-gap as part of track with burn_track_get_sectors()

libburn/libburn.h

@@ -2619,7 +2619,15 @@ struct burn_source *burn_fd_source_new(int datafd, int subfd, off_t size);
     @param start The byte address where to start reading bytes for the
                  consumer. inp bytes may get skipped to reach this address.
     @param size  The number of bytes to be delivered to the consumer.
-    @param flag  Bitfield for control purposes (unused yet, submit 0).
+                 If size is <= 0 then it may be set later by a call of method
+                 set_size(). If it is >= 0, then it can only be changed if
+                 flag bit0 was set with burn_offst_source_new().
+    @param flag  Bitfield for control purposes
+                 bit0 = Prevent set_size() from overriding interval sizes > 0.
+                        If such a size is already set, then the new one will
+                        only affect the reply of get_size().
+                        See also above struct burn_source.
+                        @since 1.2.0
     @return      Pointer to a burn_source object, later to be freed by
                  burn_source_free(). NULL indicates failure.
     @since 0.8.8
@@ -2779,8 +2787,9 @@ int burn_fifo_fill(struct burn_source *fifo, int fill, int flag);
 int burn_track_set_size(struct burn_track *t, off_t size);
 
 
-/** Tells how long a track will be on disc
-    >>> NOTE: Not reliable with tracks of undefined length
+/** Tells how many sectors a track will have on disc, resp. already has on
+    disc. This includes offset, payload, tail, and post-gap, but not pre-gap.
+    The result is NOT RELIABLE with tracks of undefined length
 */
 int burn_track_get_sectors(struct burn_track *);
 
@@ -3613,12 +3622,17 @@ typedef int (*burn_abort_handler_t)(void *handle, int signum, int flag);
 
     @param handle Opaque handle eventually pointing to an application
                   provided memory object
-    @param handler A function to be called on signals. It will get handle as
-                  argument. flag will be 0.
+    @param handler A function to be called on signals, if the handling bits
+                  in parameter mode are set 0.
+                  It will get parameter handle as argument. flag will be 0.
                   It should finally call burn_abort(). See there.
-    @param mode : bit0 - bit3:
-                    Receiving signals:
-                    0 Call handler(handle, signum, 0) on nearly all signals
+                  If the handler function returns 2 or -2, then the wrapping
+                  signal handler of libburn will return and let the program
+                  continue its operations. Any other return value causes
+                  exit(1).
+    @param mode : bit0 - bit3: Handling of received signals:
+                    0 Install libburn wrapping signal handler, which will call
+                      handler(handle, signum, 0) on nearly all signals
                     1 Enable system default reaction on all signals
                     2 Try to ignore nearly all signals
                    10 like mode 2 but handle SIGABRT like with mode 0