From f71a11f693b6990e652d16a2901282f1650aa5f6 Mon Sep 17 00:00:00 2001
From: Jean-Marc Lasgouttes <lasgouttes@lyx.org>
Date: Wed, 13 Jul 2022 13:10:57 +0200
Subject: [PATCH] Fixup 95da2707: document getAlias.

---
 src/frontends/qt/GuiApplication.cpp | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/src/frontends/qt/GuiApplication.cpp b/src/frontends/qt/GuiApplication.cpp
index 3e707ac878..127a847944 100644
--- a/src/frontends/qt/GuiApplication.cpp
+++ b/src/frontends/qt/GuiApplication.cpp
@@ -527,6 +527,16 @@ QString themeIconName(QString const & action)
 
 namespace {
 
+/* Get aliases for icon name. This allows to avoid duplication of
+ * icons when new versions of functions are introduced for the
+ * toolbar. A good example is the introduction of layout-toggle in
+ * #9864.
+ * The file is parsed by Lexer. Each line is of the form
+ *     <original substring> <replacement substring>
+ *
+ * The return value is another icon file name that can be queried.
+ */
+// FIXME: consider using regular expressions.
 QString getAlias(QString name) {
 	static bool has_aliases = false;
 	static vector <pair<QString,QString>> aliases;