Update XZ Utils to 5.0.3 (in deps)

src/liblzma/api/lzma/index.h

 /**
  * \file        lzma/index.h
  * \brief       Handling of .xz Index and related information
  */
 
 /*
  * Author: Lasse Collin
  *
  * This file has been put into the public domain.
  * You can do whatever you want with this file.
@@ skipping 118 matching lines @@
                  * Normally this is where you should seek in the .xz file
                  * to start decompressing this Block.
                  */
                 lzma_vli compressed_file_offset;
 
                 /**
                  * \brief       Uncompressed start offset of this Block
                  *
                  * This offset is relative to the beginning of the lzma_index
                  * (i.e. usually the beginning of the .xz file).
+                 *
+                 * When doing random-access reading, it is possible that
+                 * the target offset is not exactly at Block boundary. One
+                 * will need to compare the target offset against
+                 * uncompressed_file_offset or uncompressed_stream_offset,
+                 * and possibly decode and throw away some amount of data
+                 * before reaching the target offset.
                  */
                 lzma_vli uncompressed_file_offset;
 
                 /**
                  * \brief       Block number in this Stream
                  *
                  * The first Block is 1.
                  */
                 lzma_vli number_in_stream;
 
@@ skipping 10 matching lines @@
                  *
                  * This offset is relative to the beginning of the Stream
                  * containing this Block.
                  */
                 lzma_vli uncompressed_stream_offset;
 
                 /**
                  * \brief       Uncompressed size of this Block
                  *
                  * You should pass this to the Block decoder if you will
-                 * decode this Block.
-                 *
-                 * When doing random-access reading, it is possible that
-                 * the target offset is not exactly at Block boundary. One
-                 * will need to compare the target offset against
-                 * uncompressed_file_offset or uncompressed_stream_offset,
-                 * and possibly decode and throw away some amount of data
-                 * before reaching the target offset.
+                 * decode this Block. It will allow the Block decoder to
+                 * validate the uncompressed size.
                  */
                 lzma_vli uncompressed_size;
 
                 /**
                  * \brief       Unpadded size of this Block
                  *
                  * You should pass this to the Block decoder if you will
-                 * decode this Block.
+                 * decode this Block. It will allow the Block decoder to
+                 * validate the unpadded size.
                  */
                 lzma_vli unpadded_size;
 
                 /**
                  * \brief       Total compressed size
                  *
                  * This includes all headers and padding in this Block.
                  * This is useful if you need to know how many bytes
                  * the Block decoder will actually read.
                  */
@@ skipping 381 matching lines @@
                 const lzma_index *i, lzma_allocator *allocator)
                 lzma_nothrow lzma_attr_warn_unused_result;
 
 
 /**
  * \brief       Initialize .xz Index encoder
  *
  * \param       strm        Pointer to properly prepared lzma_stream
  * \param       i           Pointer to lzma_index which should be encoded.
  *
- * The only valid action value for lzma_code() is LZMA_RUN.
+ * The valid `action' values for lzma_code() are LZMA_RUN and LZMA_FINISH.
+ * It is enough to use only one of them (you can choose freely; use LZMA_RUN
+ * to support liblzma versions older than 5.0.0).
  *
  * \return      - LZMA_OK: Initialization succeeded, continue with lzma_code().
  *              - LZMA_MEM_ERROR
  *              - LZMA_PROG_ERROR
  */
 extern LZMA_API(lzma_ret) lzma_index_encoder(
                 lzma_stream *strm, const lzma_index *i)
                 lzma_nothrow lzma_attr_warn_unused_result;
 
 
 /**
  * \brief       Initialize .xz Index decoder
  *
  * \param       strm        Pointer to properly prepared lzma_stream
  * \param       i           The decoded Index will be made available via
  *                          this pointer. Initially this function will
  *                          set *i to NULL (the old value is ignored). If
  *                          decoding succeeds (lzma_code() returns
  *                          LZMA_STREAM_END), *i will be set to point
  *                          to a new lzma_index, which the application
  *                          has to later free with lzma_index_end().
  * \param       memlimit    How much memory the resulting lzma_index is
  *                          allowed to require.
  *
- * The only valid action value for lzma_code() is LZMA_RUN.
+ * The valid `action' values for lzma_code() are LZMA_RUN and LZMA_FINISH.
+ * It is enough to use only one of them (you can choose freely; use LZMA_RUN
+ * to support liblzma versions older than 5.0.0).
  *
  * \return      - LZMA_OK: Initialization succeeded, continue with lzma_code().
  *              - LZMA_MEM_ERROR
  *              - LZMA_MEMLIMIT_ERROR
  *              - LZMA_PROG_ERROR
  */
 extern LZMA_API(lzma_ret) lzma_index_decoder(
                 lzma_stream *strm, lzma_index **i, uint64_t memlimit)
                 lzma_nothrow lzma_attr_warn_unused_result;
 
@@ skipping 45 matching lines @@
  *              - LZMA_MEM_ERROR
  *              - LZMA_MEMLIMIT_ERROR: Memory usage limit was reached.
  *                The minimum required memlimit value was stored to *memlimit.
  *              - LZMA_DATA_ERROR
  *              - LZMA_PROG_ERROR
  */
 extern LZMA_API(lzma_ret) lzma_index_buffer_decode(lzma_index **i,
                 uint64_t *memlimit, lzma_allocator *allocator,
                 const uint8_t *in, size_t *in_pos, size_t in_size)
                 lzma_nothrow;