From 24b986cd6167d2b1bf5fd666034587bd3d39eee6 Mon Sep 17 00:00:00 2001
From: Kévin Le Gouguec <kevin.legouguec@airbus.com>
Date: Fri, 5 Jul 2019 10:12:03 +0200
Subject: Simplification du format du changelog

---
 CHANGELOG.txt | 51 +++++++++++++++++++++------------------------------
 1 file changed, 21 insertions(+), 30 deletions(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index eb074ad..f793279 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,26 +1,16 @@
-v1.1
-====
-
-ref
----
+This document summarizes the modifications brought by each version. Some modifications are tagged as follows:
 
-### Fixes
+- [spec] when the modification is brought by a new revision of the specification,
+- [break] when the modification changes the implementation's output.
 
-These modifications change the algorithm's output.
+A modification that has no tag corresponds to stylistic and/or structural changes that have no impact on test vectors.
 
-- Change alpha coefficients in tweakey schedule to ensure lane 0 is updated between each round:
-    - lane 0: Id  => M
-    - lane 1: M   => M^2
-    - lane 2: M^2 => M^3
-    - lane 3: M^3 => M^4
-    - lane 4: M_R   (unchanged)
-    - lane 5: M_R^2 (unchanged)
-    - lane 6: M_R^3 (unchanged)
-  (multiplications.h, tweakey.c)
 
-### Cleanups
+v1.1
+====
 
-These modifications are structural and/or stylistic and do not change the algorithm's ouptut.
+ref
+---
 
 - Introduce helper function copy_block_index() to make tweak-building functions more legible.
   (lilliput-ae-utils.h, lilliput-i.c, lilliput-ii.c)
@@ -37,16 +27,21 @@ These modifications are structural and/or stylistic and do not change the algori
 - Use size_t to iterate on arrays in lilliput_tbc_encrypt() and lilliput_tbc_decrypt().
   (cipher.c)
 
+[spec][break]
+- Change alpha coefficients in tweakey schedule to ensure lane 0 is updated between each round:
+    - lane 0: Id  => M
+    - lane 1: M   => M^2
+    - lane 2: M^2 => M^3
+    - lane 3: M^3 => M^4
+    - lane 4: M_R   (unchanged)
+    - lane 5: M_R^2 (unchanged)
+    - lane 6: M_R^3 (unchanged)
+  (multiplications.h, tweakey.c)
+
 add_threshold
 -------------
 
-### Fixes
-
-See reference implementation.
-
-### Cleanups
-
-See reference implementation. Further cleanups:
+See reference implementation. Further changes:
 
 - Add constant macros KEY_LANES_NB and TWEAK_LANES_NB to make tweakey schedule code more legible.
   (tweakey.c)
@@ -59,11 +54,7 @@ See reference implementation.
 add_python
 ----------
 
-### Fixes
-
-See reference implementation.
-
-### Cleanups
+See [spec] and [break] changes in reference implementation. Further changes:
 
 - Re-write tweakey multiplications to better resemble the specification.
   (multiplications.py)
-- 
cgit v1.2.3