Added even more comments and removed useless util functions

App.cpp

@@ -8,13 +8,13 @@ wxIMPLEMENT_APP(MyApp);
 bool MyApp::OnInit() {
     wxImage::AddHandler(new wxPNGHandler());
 
-    MainFrame* frame = new MainFrame(); // Создаём,
+    MainFrame* frame = new MainFrame(); // Создаём окно игры
 
-    if (argc >= 2 && wxFileExists(argv[1]))
+    if (argc >= 2 && wxFileExists(argv[1])) // Если пользователь ввёл какие-то аргументы
-        frame->layoutPath = argv[1];
+        frame->layoutPath = argv[1]; // считаем, что первый аргумент - путь до файла карты
 
-    frame->Show(true); // показываем
+    frame->Show(true); // показываем окно
-    SetTopWindow(frame); // и устанавливаем главным окном, а так же выносим вперёд основное окно игры
+    SetTopWindow(frame); // и устанавливаем главным, а так же выносим вперёд
 
     return true;
 }

utils.cpp

@@ -2,11 +2,7 @@
 
 wxString LTimeToStr(int time) {
     return wxString::Format(_("%d:%02d:%02d"), time / 3600, (time / 60) % 60,
-                            time % 60);
+                            time % 60); // переводим количество секунд с начала игры в читабельное время (ч:мм:сс) 
-}
-
-int upDiv(int a, int b) {
-    return a / b + ((a % b) ? 1 : 0);
 }
 
 wxString itowxS(int a) {
@@ -14,15 +10,10 @@ wxString itowxS(int a) {
 }
 
 wxString PRemaining(uint8_t remaining) {
-    return wxString::Format("%i%%", remaining * 100 / 144);
+    return wxString::Format("%i%%", remaining * 100 / 144); // делим количество оставшихся камней на их количество и домножаем на 100, чтобы получить проценты
 }
 
 bool isPositive(const wxSize& size) {
     return size.x > 0 && size.y > 0;
 }
 
-void cyclic_shift(std::set<ThreePoint>::iterator& it, const std::set<ThreePoint>& cont) {
-    it++;
-    if (it == cont.end())
-        it = cont.begin();
-}

wxw.h

@@ -7,6 +7,7 @@
 #include <wx/wx.h>
 #endif
 
+// переопределяем макрос для преобразования C-строки в UTF-8 wxString
 #ifdef _
 #undef _
 #endif