diff --git a/CMakeLists.txt b/CMakeLists.txt
index 7d2aab0..be1013e 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -109,7 +109,7 @@ target_link_libraries(qwen-core PUBLIC ggml)
 link_ggml_backends(qwen-core)
 
 # Public shared library for ABI consumers (Python ctypes, Rust bindgen,
-# Go cgo). Opt-in : -DQWENTTS_SHARED=ON at configure time. Exports only
+# Go cgo). Opt-in : -DQWEN_SHARED=ON at configure time. Exports only
 # the QT_API-marked symbols ; every internal pipeline_* / backend_*
 # stays hidden inside the .so. Intentionally a different target name
 # from qwen-core so the static path used by the tools is never affected.
diff --git a/src/qwen.cpp b/src/qwen.cpp
index 90b7431..3a613f6 100644
--- a/src/qwen.cpp
+++ b/src/qwen.cpp
@@ -258,8 +258,8 @@ struct qt_context * qt_init(const struct qt_init_params * params) {
 
         // BPE tokenizer payload lives inside the talker GGUF. Load the
         // base vocab + the qwen3-tts text specials in one shot. The
-        // specials key list mirrors what the standalone CLI used to
-        // do before the facade hoisted the load chain.
+        // specials key list matches the keys written by the conversion
+        // script under the qwen3-tts.text.* namespace.
         if (!load_bpe_from_gguf(&q->tok, params->talker_path)) {
             qt_throw("qt_init: load_bpe_from_gguf failed for '%s'", params->talker_path);
         }