From 9473a5bf0c3f3ea85b3ddecb7c370df53cd60322 Mon Sep 17 00:00:00 2001
From: Elias Bachaalany <elias.bachaalany@gmail.com>
Date: Fri, 19 Dec 2025 13:13:54 -0800
Subject: [PATCH] docs: Enhance Qt plugin support section in README

- Add example showing how to link Qt libraries in a plugin
- Clarify that standard Qt installations won't work (requires QT_NAMESPACE=QT)
- Add troubleshooting note for Ninja/NMake generator
---
 README.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 30744aa..0431c93 100644
--- a/README.md
+++ b/README.md
@@ -158,7 +158,17 @@ cmake --build build --config Release    # Build with Qt support
 
 Qt installs to `build/qt-install/` and is auto-detected for future builds. Qt plugins are skipped if Qt is unavailable.
 
-**External Qt:** Set `CMAKE_PREFIX_PATH` to your Qt 6.8.x installation (must have `QT_NAMESPACE=QT`).
+**Using Qt in your plugin:**
+```cmake
+ida_add_plugin(my_qt_plugin
+    SOURCES main.cpp
+    LIBRARIES Qt6::Core Qt6::Gui Qt6::Widgets
+)
+```
+
+**External Qt:** Set `CMAKE_PREFIX_PATH` or `Qt6_DIR` to a Qt 6.8.x installation built with `QT_NAMESPACE=QT`. Standard Qt installations won't work.
+
+> **Note:** The `build_qt` target requires Ninja. If unavailable, edit `cmake/QtSupport.cmake` and change `CMAKE_GENERATOR Ninja` to `CMAKE_GENERATOR "NMake Makefiles"`.
 
 ## IDA 9.x Plugin Metadata