Change #267031

Comments

Improve Russian translations in src/i18n/config_ru.xml (#12143)
* Improve Russian translation of configuration options

- Fix IMPLICIT_DIR_DOCS: was describing docs for directories without any docs,
  but it's specifically about using README.md as directory description
- Fix FORTRAN_COMMENT_AFTER: was incorrectly describing it as 'line expected
  after Fortran comment'; it actually controls comment start position in
  fixed-format Fortran (default 72)
- Expand WARN_AS_ERROR: add missing FAIL_ON_WARNINGS_PRINT behavior details
- Fix WARN_LINE_FORMAT: was describing tag replacement, but misses the
  'cut and paste' purpose and default value example
- Improve WARN_FORMAT: add missing $version field and FILE_VERSION_FILTER reference
- Improve WARN_LOGFILE: add '-' means stdout detail and file-open failure behavior
- Expand INPUT_FILTER: add important note about not adding/removing lines
- Improve FILTER_PATTERNS: add format description and EXTENSION_MAPPING reference
- Improve INPUT_ENCODING: add reference to INPUT_FILE_ENCODING
- Fix INPUT_FILE_ENCODING: was oversimplified, now shows per-pattern format
- Improve EXCLUDE: add note that relative paths are relative to doxygen run directory
- Improve EXCLUDE_PATTERNS: add note about wildcards matching absolute path
- Improve EXCLUDE_SYMBOLS: add examples (ANamespace, AClass::*, etc.)
- Improve EXAMPLE_PATH: add \include command reference
- Improve EXAMPLE_RECURSIVE: add \include and \dontinclude references
- Improve IMAGE_PATH: add \image command reference
- Improve FILTER_SOURCE_FILES: add SOURCE_BROWSER reference
- Improve USE_MDFILE_AS_MAINPAGE: fix inaccurate description
- Fix SOURCE_BROWSER: add note about VERBATIM_HEADERS interaction
- Improve INLINE_SOURCES: add multi-line macros and list-initialized variables
- Fix STRIP_CODE_COMMENTS: change 'Doxygen-specific' to 'special doc comment
  blocks'; add note that normal C/C++/Fortran comments remain visible
- Fix REFERENCED_BY_RELATION: change 'calling' to 'referencing' (documented)
- Improve SOURCE_TOOLTIPS: add description of what tooltip shows
- Expand USE_HTAGS: add full usage instructions and prerequisites
- Improve VERBATIM_HEADERS: add SOURCE_BROWSER cross-reference
- Fix CLANG_ASSISTED_PARSING: add libclang CMake option mention
- Fix CLANG_ADD_INC_PATHS: clarify it adds input file directory to include paths
- Fix CLANG_OPTIONS: clarify these are compiler command line options
- Fix CLANG_DATABASE_PATH: add compile_commands.json explanation
- Improve ALPHABETICAL_INDEX: add recommendation for large projects
- Fix IGNORE_PREFIX: clarify effect on index placement with example
- Fix RECURSIVE: clarify it searches subdirectories
- Fix SHOW_GROUPED_MEMB_INC: add 'order in which they appeared' detail

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: doxygen <1300762+doxygen@users.noreply.github.com>

* Fix FORTRAN_COMMENT_AFTER and ALPHABETICAL_INDEX Russian translations

- FORTRAN_COMMENT_AFTER: replace 'adds automatic comments' with 'recognizes
  comments' — the option controls comment recognition position, not insertion
- ALPHABETICAL_INDEX: replace 'modules' (модулей) with 'elements' (элементов)
  for consistency with the actual index content description

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: doxygen <1300762+doxygen@users.noreply.github.com>

* Fix 3 review issues in Russian translation

- WARN_AS_ERROR: fix 'найденные до обнаружения ошибки' → 'все найденные
  предупреждения и ошибки' for FAIL_ON_WARNINGS description
- WARN_LINE_FORMAT: fix wrong default value ($file:$line: → at line $line
  of file $file) matching the actual defval attribute
- INPUT_FILTER: remove logical contradiction about stable output — clarify
  that stable output IS expected/required

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: doxygen <1300762+doxygen@users.noreply.github.com>

* Fix 3 review issues: WARN_AS_ERROR NO case, dollar signs in WARN_FORMAT, Markdown capitalization

Agent-Logs-Url: https://github.com/doxygen/doxygen/sessions/c0d8efae-9d39-4f07-9d52-13a4e5988447

Co-authored-by: doxygen <1300762+doxygen@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: doxygen <1300762+doxygen@users.noreply.github.com>

Changed files

• src/i18n/config_ru.xml