aboutsummaryrefslogtreecommitdiff
path: root/src/liblzma/api
diff options
context:
space:
mode:
authorLasse Collin <lasse.collin@tukaani.org>2008-12-31 17:15:03 +0200
committerLasse Collin <lasse.collin@tukaani.org>2008-12-31 17:15:03 +0200
commit88d3e6b0b18e24142b6d3b41dc1b84b00c49fef3 (patch)
treed9d4712ac6eb306786ecfa1f31c026bba6ac8dbc /src/liblzma/api
parentRenamed lzma_options_simple to lzma_options_bcj in the API. (diff)
downloadxz-88d3e6b0b18e24142b6d3b41dc1b84b00c49fef3.tar.xz
Cleaned up some comments in the API headers.
Diffstat (limited to 'src/liblzma/api')
-rw-r--r--src/liblzma/api/lzma/check.h23
-rw-r--r--src/liblzma/api/lzma/container.h2
-rw-r--r--src/liblzma/api/lzma/version.h4
3 files changed, 15 insertions, 14 deletions
diff --git a/src/liblzma/api/lzma/check.h b/src/liblzma/api/lzma/check.h
index 9897e7cb..2df103f1 100644
--- a/src/liblzma/api/lzma/check.h
+++ b/src/liblzma/api/lzma/check.h
@@ -63,23 +63,16 @@ typedef enum {
* \brief Maximum valid Check ID
*
* The .xz file format specification specifies 16 Check IDs (0-15). Some
- * of them are only reserved i.e. no actual Check algorithm has been assigned.
- * Still liblzma accepts any of these IDs for future compatibility when
- * decoding files. If a valid but unsupported Check ID is detected, liblzma
- * indicates a warning with LZMA_UNSUPPORTED_CHECK.
- *
- * FIXME bad desc
+ * of them are only reserved, that is, no actual Check algorithm has been
+ * assigned. When decoding, liblzma still accepts unknown Check IDs for
+ * future compatibility. If a valid but unsupported Check ID is detected,
+ * liblzma can indicate a warning; see the flags LZMA_TELL_NO_CHECK,
+ * LZMA_TELL_UNSUPPORTED_CHECK, and LZMA_TELL_ANY_CHECK in container.h.
*/
#define LZMA_CHECK_ID_MAX 15
/**
- * \brief Maximum size of a Check field
- */
-#define LZMA_CHECK_SIZE_MAX 64
-
-
-/**
* \brief Test if the given Check ID is supported
*
* Returns true if the given Check ID is supported by this liblzma build.
@@ -107,6 +100,12 @@ extern uint32_t lzma_check_size(lzma_check check) lzma_attr_const;
/**
+ * \brief Maximum size of a Check field
+ */
+#define LZMA_CHECK_SIZE_MAX 64
+
+
+/**
* \brief Calculate CRC32
*
* Calculates CRC32 using the polynomial from the IEEE 802.3 standard.
diff --git a/src/liblzma/api/lzma/container.h b/src/liblzma/api/lzma/container.h
index ba2c4f8f..f5c0e7ab 100644
--- a/src/liblzma/api/lzma/container.h
+++ b/src/liblzma/api/lzma/container.h
@@ -76,7 +76,7 @@ extern uint64_t lzma_easy_encoder_memusage(uint32_t preset)
/**
- * \brief Calculate rough memory usage FIXME
+ * \brief Calculate rough decoder memory usage of a preset
*
* This function is a wrapper for lzma_raw_decoder_memusage().
*
diff --git a/src/liblzma/api/lzma/version.h b/src/liblzma/api/lzma/version.h
index 2a36120e..b1e74404 100644
--- a/src/liblzma/api/lzma/version.h
+++ b/src/liblzma/api/lzma/version.h
@@ -30,7 +30,9 @@
* - zzz = revision
* - s indicates stability: 0 = alpha, 1 = beta, 2 = stable
*
- * See the README file for details about the version numbering. FIXME
+ * The same xyyyzzz triplet is never reused with different stability levels.
+ * For example, if 5.1.0alpha has been released, there will never be 5.1.0beta
+ * or 5.1.0 stable.
*
* \note The version number of liblzma has nothing to with
* the version number of Igor Pavlov's LZMA SDK.