Unified source codes' comments.

Author: ChenPi11

CMakeLists.txt

@@ -1,4 +1,4 @@
-# Copyright (C) 2023 The C++ Plus Project.
+# Copyright (C) 2023-2024 The C++ Plus Project.
 # This file is part of the cppp-reiconv library.
 #
 # The cppp-reiconv library is free software; you can redistribute it

lib/all_encodings.h

@@ -1,5 +1,9 @@
+/**
+ * @file all_encodings.h
+ * @brief Definition of `all_encodings[]`.
+ * @copyright Copyright (C) 2024 The C++ Plus Project.
+ */
 /*
- * Copyright (C) 2024 The C++ Plus Project.
  * This file is part of the cppp-reiconv library.
  *
  * The cppp-reiconv library is free software; you can redistribute it
@@ -20,7 +24,7 @@
 #ifndef _ALL_ENCODINGS_H_
 #define _ALL_ENCODINGS_H_
 
-#include "converters.h"
+#include "converters.h" // IWYU pragma: keep. Include all the converters for `encodings.h.snippet`.
 #include "encoding.h"
 
 #define DEFENCODING(xxx_names, xxx, xxx_index, xxx_ifuncs1, xxx_ifuncs2, xxx_ofuncs1, xxx_ofuncs2)                     \

lib/codepage_to_ei.h

@@ -0,0 +1,24 @@
+/**
+ * @file codepage_to_ei.h
+ * @brief A mapping of codepages to encoding indexes.
+ * @copyright Copyright (C) 2024 The C++ Plus Project.
+ */
+
+#ifndef _CODEPAGE_TO_EI_H_
+#define _CODEPAGE_TO_EI_H_
+
+#include "encoding_indexes.h" // IWYU pragma: keep
+
+#define DEFENCODING(xxx_names, xxx, xxx_index, xxx_ifuncs1, xxx_ifuncs2, xxx_ofuncs1, xxx_ofuncs2)
+#define DEFCODEPAGE(codepage, xxx) [codepage] = ei_##xxx + 1,
+#define DEFINDEX(alias, name)
+
+static const int codepage_to_eindex[] = {
+#include "encodings.h.snippet"
+};
+
+#undef DEFINDEX
+#undef DEFENCODING
+#undef DEFCODEPAGE
+
+#endif /* _CODEPAGE_TO_EI_H_ */