]> git.ipfire.org Git - thirdparty/kmod.git/commitdiff
libkmod: Improve index comment
authorTobias Stoeckmann <tobias@stoeckmann.org>
Wed, 13 Nov 2024 18:41:04 +0000 (19:41 +0100)
committerLucas De Marchi <lucas.de.marchi@gmail.com>
Tue, 19 Nov 2024 06:23:32 +0000 (00:23 -0600)
In version 1 of kmod, definitions of INDEX_MAGIC_OLD and INDEX_MAGIC
were in two adjacent lines, which made the sentence starting with
"Second one" much easier to read.

Since the "second one" is actually INDEX_MAGIC and even kmod version 1
did use it, let's not talk about "newer versioned binary files" anymore
but clearly state that 0xB007FA57 is deprecated.

Also add a missing full stop.

Signed-off-by: Tobias Stoeckmann <tobias@stoeckmann.org>
Signed-off-by: Max Kunzelmann <maxdev@posteo.de>
Link: https://github.com/kmod-project/kmod/pull/241
Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
libkmod/libkmod-index.c

index f1d74aedbd9e9b4914f42be510dc94cae24a0f38..18f22be855a2e376f1f673f04acb695970b838b3 100644 (file)
  * Integers are stored as 32 bit unsigned in "network" order, i.e. MSB first.
  * All files start with a magic number.
  *
- * Magic spells "BOOTFAST". Second one used on newer versioned binary files.
- * #define INDEX_MAGIC_OLD 0xB007FA57
+ * Magic spells "BOOTFAST". Deprecated versions encoded it as 0xB007FA57.
  *
- * We use a version string to keep track of changes to the binary format
+ * We use a version string to keep track of changes to the binary format.
  * This is stored in the form: INDEX_MAJOR (hi) INDEX_MINOR (lo) just in
  * case we ever decide to have minor changes that are not incompatible.
  */