docs(code): add concise TR/EN inline comments

Author: Sopwit

src/backend/monitor/rammonitor.cpp

@@ -28,6 +28,8 @@ int RamMonitor::usagePercent() const { return m_usagePercent; }
 int RamMonitor::updateInterval() const { return m_timer.interval(); }
 
 void RamMonitor::refresh() {
+  // TR: Linux RAM metrikleri /proc/meminfo uzerinden okunur.
+  // EN: Linux memory metrics are read from /proc/meminfo.
   QFile meminfo("/proc/meminfo");
   if (!meminfo.open(QIODevice::ReadOnly | QIODevice::Text)) {
     setAvailable(false);
@@ -43,6 +45,8 @@ void RamMonitor::refresh() {
   qint64 sReclaimableKiB = -1;
   qint64 shmemKiB = -1;
 
+  // TR: "Anahtar: deger" satirlarini guvenli sekilde ayriştir.
+  // EN: Safely parse "Key: value" lines.
   static const QRegularExpression lineRe(
       QStringLiteral(R"(^([A-Za-z_]+):\s+(\d+))"));
 
@@ -79,14 +83,17 @@ void RamMonitor::refresh() {
     }
   }
 
-  // Some kernels/environments may not expose MemAvailable.
+  // TR: Bazi kernel/ortamlarda MemAvailable olmayabilir; yaklasik deger hesapla.
+  // EN: Some kernels/environments do not expose MemAvailable; compute a fallback.
   if (memAvailableKiB < 0 && memFreeKiB >= 0 && buffersKiB >= 0 &&
       cachedKiB >= 0) {
     const qint64 reclaimable = sReclaimableKiB > 0 ? sReclaimableKiB : 0;
     const qint64 shmem = shmemKiB > 0 ? shmemKiB : 0;
     memAvailableKiB = memFreeKiB + buffersKiB + cachedKiB + reclaimable - shmem;
   }
 
+  // TR: Tutarsiz veri geldiyse metrikleri sifirla ve "unavailable" olarak isle.
+  // EN: If metrics are inconsistent, clear values and mark monitor unavailable.
   if (memTotalKiB <= 0 || memAvailableKiB < 0 ||
       memAvailableKiB > memTotalKiB) {
     setAvailable(false);

src/backend/nvidia/detector.cpp

@@ -12,6 +12,8 @@ NvidiaDetector::NvidiaDetector(QObject *parent) : QObject(parent) {}
 NvidiaDetector::GpuInfo NvidiaDetector::detect() const {
   GpuInfo info;
 
+  // TR: Tespit adimlari olabildigince bagimsiz tutulur; biri fail etse digeri devam eder.
+  // EN: Detection steps are independent so one failure does not block others.
   info.name = detectGpuName();
   info.found = !info.name.isEmpty();
   info.driverVersion = detectDriverVersion();
@@ -42,6 +44,8 @@ QString NvidiaDetector::activeDriver() const {
 }
 
 QString NvidiaDetector::verificationReport() const {
+  // TR: UI icin tek yerde ozet tanilama metni uret.
+  // EN: Produce a single consolidated diagnostic text for the UI.
   const QString gpuText = m_info.found ? m_info.name : QStringLiteral("Yok");
   const QString versionText = m_info.driverVersion.isEmpty()
                                   ? QStringLiteral("Yok")
@@ -105,6 +109,8 @@ QString NvidiaDetector::detectDriverVersion() const {
   if (result.success())
     return result.stdout.trimmed();
 
+  // TR: nvidia-smi yoksa modinfo ile surum fallback'i dene.
+  // EN: If nvidia-smi is unavailable, fall back to modinfo.
   const auto modinfo =
       runner.run(QStringLiteral("modinfo"), {QStringLiteral("nvidia")});
 
@@ -135,6 +141,8 @@ bool NvidiaDetector::isModuleLoaded(const QString &moduleName) const {
 }
 
 bool NvidiaDetector::detectSecureBoot(bool *known) const {
+  // TR: mokutil yoksa "kapali" degil "bilinmiyor" olarak siniflandir.
+  // EN: If mokutil is unavailable, classify as "unknown" rather than "disabled".
   CommandRunner runner;
   const auto result =
       runner.run(QStringLiteral("mokutil"), {QStringLiteral("--sb-state")});

src/backend/nvidia/updater.cpp

@@ -8,6 +8,8 @@
 NvidiaUpdater::NvidiaUpdater(QObject *parent) : QObject(parent) {}
 
 void NvidiaUpdater::checkForUpdate() {
+  // TR: Her kontrol denemesinde UI'ye gorunur bir baslangic mesaji gonder.
+  // EN: Always emit a visible start message for each check request.
   emit progressMessage(
       QStringLiteral("Guncelleme kontrolu baslatildi..."));
 
@@ -31,7 +33,8 @@ void NvidiaUpdater::checkForUpdate() {
     return;
   }
 
-  // DNF'den güncelleme bilgisi al
+  // TR: DNF cikis kodlari: 100=guncelleme var, 0=yok, digeri=hata.
+  // EN: DNF exit codes: 100=updates available, 0=none, others=error.
   CommandRunner runner;
 
   const auto result =
@@ -93,6 +96,8 @@ void NvidiaUpdater::applyUpdate() {
   connect(&runner, &CommandRunner::outputLine, this,
           &NvidiaUpdater::progressMessage);
 
+  // TR: Uzun surebilecek adimlar oncesinde kullaniciya ilerleme bilgisi ver.
+  // EN: Emit progress updates before long-running operations.
   emit progressMessage(QStringLiteral("NVIDIA sürücüsü güncelleniyor..."));
 
   const auto result = runner.runAsRoot(

src/main.cpp

@@ -11,10 +11,12 @@
 #include "backend/nvidia/updater.h"
 
 int main(int argc, char *argv[]) {
-  // QApplication: Widgets backend (pencere, sistem tray vb.) için gerekli
+  // TR: QApplication, Qt Widgets tabanli uygulama omurgasini baslatir.
+  // EN: QApplication bootstraps the Qt Widgets application runtime.
   QApplication app(argc, argv);
 
-  // Uygulama meta bilgileri — Q_PROPERTY ve sistem entegrasyonunda kullanılır
+  // TR: Bu meta bilgiler masaustu entegrasyonu ve UI kimligi icin kullanilir.
+  // EN: These metadata values are used for desktop integration and app identity.
   app.setApplicationName("ro-control");
   app.setApplicationDisplayName("ro-Control");
   app.setApplicationVersion("0.1.0");
@@ -29,7 +31,8 @@ int main(int argc, char *argv[]) {
   GpuMonitor gpuMonitor;
   RamMonitor ramMonitor;
 
-  // QML motorunu başlat
+  // TR: QML motoru, arayuz ve bagli context nesnelerini yukler.
+  // EN: The QML engine loads the UI and injected context objects.
   QQmlApplicationEngine engine;
 
   engine.rootContext()->setContextProperty("nvidiaDetector", &detector);
@@ -39,12 +42,14 @@ int main(int argc, char *argv[]) {
   engine.rootContext()->setContextProperty("gpuMonitor", &gpuMonitor);
   engine.rootContext()->setContextProperty("ramMonitor", &ramMonitor);
 
-  // QML yüklenemezse uygulamayı kapat
+  // TR: Ana bileşen olusmazsa uygulamayi kontrollu sekilde sonlandir.
+  // EN: Exit gracefully if the root QML component cannot be created.
   QObject::connect(
       &engine, &QQmlApplicationEngine::objectCreationFailed, &app,
       []() { QCoreApplication::exit(-1); }, Qt::QueuedConnection);
 
-  // QML modülünden yüklemek, qrc prefix/policy farklarından etkilenmez.
+  // TR: Modulden yukleme, qrc yol/prefix farklarina karsi daha dayaniklidir.
+  // EN: Module-based loading is resilient to qrc path/prefix differences.
   engine.loadFromModule("rocontrol", "Main");
 
   return app.exec();

src/qml/pages/DriverPage.qml

@@ -107,6 +107,8 @@ Item {
         RowLayout {
             spacing: 8
 
+            // TR: Manuel kontrol butonu, sonucu log alanina yazar.
+            // EN: Manual check button writes status into the on-screen log.
             Button {
                 text: "Guncelleme Kontrol Et"
                 onClicked: {
@@ -131,6 +133,8 @@ Item {
         RowLayout {
             spacing: 8
 
+            // TR: Yeniden Tara; detector + lisans durumu + update kontrolunu tazeler.
+            // EN: Rescan refreshes detector state, agreement state, and update check.
             Button {
                 text: "Yeniden Tara"
                 onClicked: {
@@ -181,6 +185,8 @@ Item {
 
     Connections {
         target: nvidiaUpdater
+        // TR: Updater backend mesajlarini canli log olarak UI'ye aktar.
+        // EN: Stream updater backend messages into the live UI log.
         function onProgressMessage(message) {
             logArea.append(message);
         }