From 7ef711a2d08a7d9ef9e24844e374b1f8985d7694 Mon Sep 17 00:00:00 2001
From: Konstantin <const@const.me>
Date: Fri, 3 Feb 2023 20:42:53 +0100
Subject: Comments

---
 Tools/CompressShaders/LanguageCodes.cs |   4 +-
 WhisperNet/API/eLanguage.cs            | 200 +++++++++++++++++----------------
 2 files changed, 104 insertions(+), 100 deletions(-)

diff --git a/Tools/CompressShaders/LanguageCodes.cs b/Tools/CompressShaders/LanguageCodes.cs
index 71a9909..0843fc7 100644
--- a/Tools/CompressShaders/LanguageCodes.cs
+++ b/Tools/CompressShaders/LanguageCodes.cs
@@ -71,6 +71,8 @@ namespace CompressShaders
 namespace Whisper
 {
 	/// <summary>Supported languages</summary>
+	/// <remarks>The values of this enum are zero-padded ASCII strings.<br/>
+	/// It seems OpenAI tried to implement ISO 639-1, but they used the version of the standard from 1988.</remarks>
 	public enum eLanguage: uint
 	{" );
 
@@ -79,7 +81,7 @@ namespace Whisper
 				string tc = row.name.titleCase();
 				stm.WriteLine( "		/// <summary>{0}</summary>", tc );
 				tc = Regex.Replace( tc, @"\s+", string.Empty );
-				stm.WriteLine( "		{0} = 0x{1:X},", tc, row.keyValue );
+				stm.WriteLine( "		{0} = 0x{1:X},  // \"{2}\"", tc, row.keyValue, row.keySource );
 			}
 			stm.Write( @"	}
 }" );
diff --git a/WhisperNet/API/eLanguage.cs b/WhisperNet/API/eLanguage.cs
index 1241077..e78b81c 100644
--- a/WhisperNet/API/eLanguage.cs
+++ b/WhisperNet/API/eLanguage.cs
@@ -2,205 +2,207 @@
 namespace Whisper
 {
 	/// <summary>Supported languages</summary>
+	/// <remarks>The values of this enum are zero-padded ASCII strings.<br/>
+	/// It seems OpenAI tried to implement ISO 639-1, but they used the version of the standard from 1988.</remarks>
 	public enum eLanguage: uint
 	{
 		/// <summary>Afrikaans</summary>
-		Afrikaans = 0x6661,
+		Afrikaans = 0x6661,  // "af"
 		/// <summary>Albanian</summary>
-		Albanian = 0x7173,
+		Albanian = 0x7173,  // "sq"
 		/// <summary>Amharic</summary>
-		Amharic = 0x6D61,
+		Amharic = 0x6D61,  // "am"
 		/// <summary>Arabic</summary>
-		Arabic = 0x7261,
+		Arabic = 0x7261,  // "ar"
 		/// <summary>Armenian</summary>
-		Armenian = 0x7968,
+		Armenian = 0x7968,  // "hy"
 		/// <summary>Assamese</summary>
-		Assamese = 0x7361,
+		Assamese = 0x7361,  // "as"
 		/// <summary>Azerbaijani</summary>
-		Azerbaijani = 0x7A61,
+		Azerbaijani = 0x7A61,  // "az"
 		/// <summary>Bashkir</summary>
-		Bashkir = 0x6162,
+		Bashkir = 0x6162,  // "ba"
 		/// <summary>Basque</summary>
-		Basque = 0x7565,
+		Basque = 0x7565,  // "eu"
 		/// <summary>Belarusian</summary>
-		Belarusian = 0x6562,
+		Belarusian = 0x6562,  // "be"
 		/// <summary>Bengali</summary>
-		Bengali = 0x6E62,
+		Bengali = 0x6E62,  // "bn"
 		/// <summary>Bosnian</summary>
-		Bosnian = 0x7362,
+		Bosnian = 0x7362,  // "bs"
 		/// <summary>Breton</summary>
-		Breton = 0x7262,
+		Breton = 0x7262,  // "br"
 		/// <summary>Bulgarian</summary>
-		Bulgarian = 0x6762,
+		Bulgarian = 0x6762,  // "bg"
 		/// <summary>Catalan</summary>
-		Catalan = 0x6163,
+		Catalan = 0x6163,  // "ca"
 		/// <summary>Chinese</summary>
-		Chinese = 0x687A,
+		Chinese = 0x687A,  // "zh"
 		/// <summary>Croatian</summary>
-		Croatian = 0x7268,
+		Croatian = 0x7268,  // "hr"
 		/// <summary>Czech</summary>
-		Czech = 0x7363,
+		Czech = 0x7363,  // "cs"
 		/// <summary>Danish</summary>
-		Danish = 0x6164,
+		Danish = 0x6164,  // "da"
 		/// <summary>Dutch</summary>
-		Dutch = 0x6C6E,
+		Dutch = 0x6C6E,  // "nl"
 		/// <summary>English</summary>
-		English = 0x6E65,
+		English = 0x6E65,  // "en"
 		/// <summary>Estonian</summary>
-		Estonian = 0x7465,
+		Estonian = 0x7465,  // "et"
 		/// <summary>Faroese</summary>
-		Faroese = 0x6F66,
+		Faroese = 0x6F66,  // "fo"
 		/// <summary>Finnish</summary>
-		Finnish = 0x6966,
+		Finnish = 0x6966,  // "fi"
 		/// <summary>French</summary>
-		French = 0x7266,
+		French = 0x7266,  // "fr"
 		/// <summary>Galician</summary>
-		Galician = 0x6C67,
+		Galician = 0x6C67,  // "gl"
 		/// <summary>Georgian</summary>
-		Georgian = 0x616B,
+		Georgian = 0x616B,  // "ka"
 		/// <summary>German</summary>
-		German = 0x6564,
+		German = 0x6564,  // "de"
 		/// <summary>Greek</summary>
-		Greek = 0x6C65,
+		Greek = 0x6C65,  // "el"
 		/// <summary>Gujarati</summary>
-		Gujarati = 0x7567,
+		Gujarati = 0x7567,  // "gu"
 		/// <summary>Haitian Creole</summary>
-		HaitianCreole = 0x7468,
+		HaitianCreole = 0x7468,  // "ht"
 		/// <summary>Hausa</summary>
-		Hausa = 0x6168,
+		Hausa = 0x6168,  // "ha"
 		/// <summary>Hawaiian</summary>
-		Hawaiian = 0x776168,
+		Hawaiian = 0x776168,  // "haw"
 		/// <summary>Hebrew</summary>
-		Hebrew = 0x7769,
+		Hebrew = 0x7769,  // "iw"
 		/// <summary>Hindi</summary>
-		Hindi = 0x6968,
+		Hindi = 0x6968,  // "hi"
 		/// <summary>Hungarian</summary>
-		Hungarian = 0x7568,
+		Hungarian = 0x7568,  // "hu"
 		/// <summary>Icelandic</summary>
-		Icelandic = 0x7369,
+		Icelandic = 0x7369,  // "is"
 		/// <summary>Indonesian</summary>
-		Indonesian = 0x6469,
+		Indonesian = 0x6469,  // "id"
 		/// <summary>Italian</summary>
-		Italian = 0x7469,
+		Italian = 0x7469,  // "it"
 		/// <summary>Japanese</summary>
-		Japanese = 0x616A,
+		Japanese = 0x616A,  // "ja"
 		/// <summary>Javanese</summary>
-		Javanese = 0x776A,
+		Javanese = 0x776A,  // "jw"
 		/// <summary>Kannada</summary>
-		Kannada = 0x6E6B,
+		Kannada = 0x6E6B,  // "kn"
 		/// <summary>Kazakh</summary>
-		Kazakh = 0x6B6B,
+		Kazakh = 0x6B6B,  // "kk"
 		/// <summary>Khmer</summary>
-		Khmer = 0x6D6B,
+		Khmer = 0x6D6B,  // "km"
 		/// <summary>Korean</summary>
-		Korean = 0x6F6B,
+		Korean = 0x6F6B,  // "ko"
 		/// <summary>Lao</summary>
-		Lao = 0x6F6C,
+		Lao = 0x6F6C,  // "lo"
 		/// <summary>Latin</summary>
-		Latin = 0x616C,
+		Latin = 0x616C,  // "la"
 		/// <summary>Latvian</summary>
-		Latvian = 0x766C,
+		Latvian = 0x766C,  // "lv"
 		/// <summary>Lingala</summary>
-		Lingala = 0x6E6C,
+		Lingala = 0x6E6C,  // "ln"
 		/// <summary>Lithuanian</summary>
-		Lithuanian = 0x746C,
+		Lithuanian = 0x746C,  // "lt"
 		/// <summary>Luxembourgish</summary>
-		Luxembourgish = 0x626C,
+		Luxembourgish = 0x626C,  // "lb"
 		/// <summary>Macedonian</summary>
-		Macedonian = 0x6B6D,
+		Macedonian = 0x6B6D,  // "mk"
 		/// <summary>Malagasy</summary>
-		Malagasy = 0x676D,
+		Malagasy = 0x676D,  // "mg"
 		/// <summary>Malay</summary>
-		Malay = 0x736D,
+		Malay = 0x736D,  // "ms"
 		/// <summary>Malayalam</summary>
-		Malayalam = 0x6C6D,
+		Malayalam = 0x6C6D,  // "ml"
 		/// <summary>Maltese</summary>
-		Maltese = 0x746D,
+		Maltese = 0x746D,  // "mt"
 		/// <summary>Maori</summary>
-		Maori = 0x696D,
+		Maori = 0x696D,  // "mi"
 		/// <summary>Marathi</summary>
-		Marathi = 0x726D,
+		Marathi = 0x726D,  // "mr"
 		/// <summary>Mongolian</summary>
-		Mongolian = 0x6E6D,
+		Mongolian = 0x6E6D,  // "mn"
 		/// <summary>Myanmar</summary>
-		Myanmar = 0x796D,
+		Myanmar = 0x796D,  // "my"
 		/// <summary>Nepali</summary>
-		Nepali = 0x656E,
+		Nepali = 0x656E,  // "ne"
 		/// <summary>Norwegian</summary>
-		Norwegian = 0x6F6E,
+		Norwegian = 0x6F6E,  // "no"
 		/// <summary>Nynorsk</summary>
-		Nynorsk = 0x6E6E,
+		Nynorsk = 0x6E6E,  // "nn"
 		/// <summary>Occitan</summary>
-		Occitan = 0x636F,
+		Occitan = 0x636F,  // "oc"
 		/// <summary>Pashto</summary>
-		Pashto = 0x7370,
+		Pashto = 0x7370,  // "ps"
 		/// <summary>Persian</summary>
-		Persian = 0x6166,
+		Persian = 0x6166,  // "fa"
 		/// <summary>Polish</summary>
-		Polish = 0x6C70,
+		Polish = 0x6C70,  // "pl"
 		/// <summary>Portuguese</summary>
-		Portuguese = 0x7470,
+		Portuguese = 0x7470,  // "pt"
 		/// <summary>Punjabi</summary>
-		Punjabi = 0x6170,
+		Punjabi = 0x6170,  // "pa"
 		/// <summary>Romanian</summary>
-		Romanian = 0x6F72,
+		Romanian = 0x6F72,  // "ro"
 		/// <summary>Russian</summary>
-		Russian = 0x7572,
+		Russian = 0x7572,  // "ru"
 		/// <summary>Sanskrit</summary>
-		Sanskrit = 0x6173,
+		Sanskrit = 0x6173,  // "sa"
 		/// <summary>Serbian</summary>
-		Serbian = 0x7273,
+		Serbian = 0x7273,  // "sr"
 		/// <summary>Shona</summary>
-		Shona = 0x6E73,
+		Shona = 0x6E73,  // "sn"
 		/// <summary>Sindhi</summary>
-		Sindhi = 0x6473,
+		Sindhi = 0x6473,  // "sd"
 		/// <summary>Sinhala</summary>
-		Sinhala = 0x6973,
+		Sinhala = 0x6973,  // "si"
 		/// <summary>Slovak</summary>
-		Slovak = 0x6B73,
+		Slovak = 0x6B73,  // "sk"
 		/// <summary>Slovenian</summary>
-		Slovenian = 0x6C73,
+		Slovenian = 0x6C73,  // "sl"
 		/// <summary>Somali</summary>
-		Somali = 0x6F73,
+		Somali = 0x6F73,  // "so"
 		/// <summary>Spanish</summary>
-		Spanish = 0x7365,
+		Spanish = 0x7365,  // "es"
 		/// <summary>Sundanese</summary>
-		Sundanese = 0x7573,
+		Sundanese = 0x7573,  // "su"
 		/// <summary>Swahili</summary>
-		Swahili = 0x7773,
+		Swahili = 0x7773,  // "sw"
 		/// <summary>Swedish</summary>
-		Swedish = 0x7673,
+		Swedish = 0x7673,  // "sv"
 		/// <summary>Tagalog</summary>
-		Tagalog = 0x6C74,
+		Tagalog = 0x6C74,  // "tl"
 		/// <summary>Tajik</summary>
-		Tajik = 0x6774,
+		Tajik = 0x6774,  // "tg"
 		/// <summary>Tamil</summary>
-		Tamil = 0x6174,
+		Tamil = 0x6174,  // "ta"
 		/// <summary>Tatar</summary>
-		Tatar = 0x7474,
+		Tatar = 0x7474,  // "tt"
 		/// <summary>Telugu</summary>
-		Telugu = 0x6574,
+		Telugu = 0x6574,  // "te"
 		/// <summary>Thai</summary>
-		Thai = 0x6874,
+		Thai = 0x6874,  // "th"
 		/// <summary>Tibetan</summary>
-		Tibetan = 0x6F62,
+		Tibetan = 0x6F62,  // "bo"
 		/// <summary>Turkish</summary>
-		Turkish = 0x7274,
+		Turkish = 0x7274,  // "tr"
 		/// <summary>Turkmen</summary>
-		Turkmen = 0x6B74,
+		Turkmen = 0x6B74,  // "tk"
 		/// <summary>Ukrainian</summary>
-		Ukrainian = 0x6B75,
+		Ukrainian = 0x6B75,  // "uk"
 		/// <summary>Urdu</summary>
-		Urdu = 0x7275,
+		Urdu = 0x7275,  // "ur"
 		/// <summary>Uzbek</summary>
-		Uzbek = 0x7A75,
+		Uzbek = 0x7A75,  // "uz"
 		/// <summary>Vietnamese</summary>
-		Vietnamese = 0x6976,
+		Vietnamese = 0x6976,  // "vi"
 		/// <summary>Welsh</summary>
-		Welsh = 0x7963,
+		Welsh = 0x7963,  // "cy"
 		/// <summary>Yiddish</summary>
-		Yiddish = 0x6979,
+		Yiddish = 0x6979,  // "yi"
 		/// <summary>Yoruba</summary>
-		Yoruba = 0x6F79,
+		Yoruba = 0x6F79,  // "yo"
 	}
 }
\ No newline at end of file
-- 
cgit v1.2.3