Summary
The Debug Settings panel (Advanced → Show Debug Settings) shows a help comment
for each setting. Today these comments are always in English, regardless of
the viewer language, because they come from app_settings/settings.xml at runtime.
This makes advanced configuration harder for non-English speakers.
Proposed solution
Load optional per-locale comment overrides from
skins/default/xui/{locale}/settings_comments.xml after the session language is
initialized, and apply them to existing controls in both Global and
PerAccount settings groups via LLControlVariable::setComment().
Fallback (required):
- No file for the locale → keep English comments (current behavior).
- Missing key in the file → keep English for that setting only.
This allows incremental translation without breaking untranslated locales.
Scope of initial implementation
- C++ loader in
LLAppViewer::loadLocalizedSettingsComments() (llappviewer.cpp / .h).
- First complete translation: PT-BR
skins/default/xui/pt/settings_comments.xml (1,507 settings)
- Complete remaining labels in
skins/default/xui/pt/floater_settings_debug.xml
Rationale
- Improves accessibility for Portuguese-speaking residents and maintainers.
- Pattern is extensible to other locales without changing core settings XML.
- English remains the source of truth; translations are overlays only.
How to verify
- Build and run the viewer.
- Set language to Português (Brasil) and restart if needed.
- Enable Preferences → Advanced → Show Advanced Menu.
- Open Advanced → Show Debug Settings.
- Confirm setting help text appears in Portuguese.
- Switch to a locale without
settings_comments.xml → comments stay in English.
Summary
The Debug Settings panel (Advanced → Show Debug Settings) shows a help comment
for each setting. Today these comments are always in English, regardless of
the viewer language, because they come from
app_settings/settings.xmlat runtime.This makes advanced configuration harder for non-English speakers.
Proposed solution
Load optional per-locale comment overrides from
skins/default/xui/{locale}/settings_comments.xmlafter the session language isinitialized, and apply them to existing controls in both Global and
PerAccount settings groups via
LLControlVariable::setComment().Fallback (required):
This allows incremental translation without breaking untranslated locales.
Scope of initial implementation
LLAppViewer::loadLocalizedSettingsComments()(llappviewer.cpp/.h).skins/default/xui/pt/settings_comments.xml(1,507 settings)skins/default/xui/pt/floater_settings_debug.xmlRationale
How to verify
settings_comments.xml→ comments stay in English.