# MangoHUD
### Включаем мониторинг игр MangoHud в Steam Flatpak
```bash
flatpak install org.freedesktop.Platform.VulkanLayer.MangoHud
```
Включить для всех игр разом:
```bash
flatpak override --user --env=MANGOHUD=1 com.valvesoftware.Steam
```
Отключить для всех игр разом:
```bash
flatpak override --user --env=MANGOHUD=0 com.valvesoftware.Steam
```
Включить отдельно для каждой игры в Steam (Vulkan + OpenGL):
```bash
mangohud %command%
```
Включить отдельно для каждой игры в Steam (только Vulkan):
```bash
MANGOHUD=1
```
## Конфигурация MangoHUD
{% hint style="info" %}
Обычно пример конфигурационного файла лежит по данному пути:
`/usr/share/doc/mangohud/MangoHud.conf.example`
{% endhint %}
Либо скопируйте его здесь:
```bash
### MangoHud configuration file
### Uncomment any options you wish to enable. Default options are left uncommented
### Use some_parameter=0 to disable a parameter (only works with on/off parameters)
### Everything below can be used / overridden with the environment variable MANGOHUD_CONFIG instead
################ INFORMATIONAL #################
## prints possible options on stdout
# help
################ PERFORMANCE #################
### Limit the application FPS. Comma-separated list of one or more FPS values (e.g. 0,30,60). 0 means unlimited (unless VSynced)
# fps_limit=0
### early = wait before present, late = wait after present
# fps_limit_method=
### VSync [0-3] 0 = adaptive; 1 = off; 2 = mailbox; 3 = on
# vsync=-1
### OpenGL VSync [0-N] 0 = off; >=1 = wait for N v-blanks, N > 1 acts as a FPS limiter (FPS = display refresh rate / N)
# gl_vsync=-2
### Mip-map LoD bias. Negative values will increase texture sharpness (and aliasing)
## Positive values will increase texture blurriness (-16 to 16)
# picmip=-17
### Anisotropic filtering level. Improves sharpness of textures viewed at an angle (0 to 16)
# af=-1
### Force bicubic filtering
# bicubic
### Force trilinear filtering
# trilinear
### Disable linear texture filtering. Makes textures look blocky
# retro
################### VISUAL ###################
### Legacy layout
# legacy_layout=0
### pre defined presets
# -1 = default
# 0 = no display
# 1 = fps only
# 2 = horizontal view
# 3 = extended
# 4 = high detailed information
# preset=-1
### Enable most of the toggleable parameters (currently excludes `histogram`)
# full
### Show FPS only. ***Not meant to be used with other display params***
# fps_only
### Display custom centered text, useful for a header
# custom_text_center=
### Display the current system time
# time
### Time formatting examples
## %H:%M
## [ %T %F ]
## %X # locally formatted time, because of limited glyph range, missing characters may show as '?' (e.g. Japanese)
# time_format="%T"
### Display MangoHud version
# version
### Display the current GPU information
## Note: gpu_mem_clock and gpu_mem_temp also need "vram" to be enabled
gpu_stats
# gpu_temp
# gpu_junction_temp
# gpu_core_clock
# gpu_mem_temp
# gpu_mem_clock
# gpu_power
# gpu_text=
# gpu_load_change
# gpu_load_value=60,90
# gpu_load_color=39F900,FDFD09,B22222
## GPU fan in rpm on AMD, FAN in percent on NVIDIA
# gpu_fan
## gpu_voltage only works on AMD GPUs
# gpu_voltage
### Display the current CPU information
cpu_stats
# cpu_temp
# cpu_power
# cpu_text=
# cpu_mhz
# cpu_load_change
# cpu_load_value=60,90
# cpu_load_color=39F900,FDFD09,B22222
### Display the current CPU load & frequency for each core
# core_load
# core_load_change
### Display IO read and write for the app (not system)
# io_read
# io_write
### Display system vram / ram / swap space usage
# vram
# ram
# swap
### Display per process memory usage
## Show resident memory and other types, if enabled
# procmem
# procmem_shared
# procmem_virt
### Display battery information
# battery
# battery_icon
# device_battery=gamepad,mouse
# device_battery_icon
# battery_watt
# battery_time
### Display FPS and frametime
fps
# fps_sampling_period=500
# fps_color_change
# fps_value=30,60
# fps_color=B22222,FDFD09,39F900
frametime
# frame_count
### Display GPU throttling status based on Power, current, temp or "other"
## Only shows if throttling is currently happening
throttling_status
## Same as throttling_status but displays throttling on the frametime graph
#throttling_status_graph
### Display miscellaneous information
# engine_version
# engine_short_names
# gpu_name
# vulkan_driver
# wine
# exec_name
### Display loaded MangoHud architecture
# arch
### Display the frametime line graph
frame_timing
# histogram
### Display GameMode / vkBasalt running status
# gamemode
# vkbasalt
### Gamescope related options
## Display the status of FSR (only works in gamescope)
# fsr
## Hides the sharpness info for the `fsr` option (only available in gamescope)
# hide_fsr_sharpness
## Shows the graph of gamescope app frametimes and latency (only on gamescope obviously)
# debug
### graphs displays one or more graphs that you chose
## seperated by ",", available graphs are
## gpu_load,cpu_load,gpu_core_clock,gpu_mem_clock,vram,ram,cpu_temp,gpu_temp
# graphs=
### mangoapp related options
## Enables mangoapp to be displayed above the Steam UI
# mangoapp_steam
### Steam Deck options
## Shows the Steam Deck fan rpm
# fan
### Display current FPS limit
# show_fps_limit
### Display the current resolution
# resolution
### Display custom text
# custom_text=
### Display output of Bash command in next column
# exec=
### Display media player metadata
# media_player
## for example spotify
# media_player_name=
## Format metadata, lines are delimited by ; (wip)
## example: {title};{artist};{album}
## example: Track:;{title};By:;{artist};From:;{album}
# media_player_format=title,artist,album
### Change the hud font size
# font_size=24
# font_scale=1.0
# font_size_text=24
# font_scale_media_player=0.55
# no_small_font
### Change default font (set location to TTF/OTF file)
## Set font for the whole hud
# font_file=
## Set font only for text like media player metadata
# font_file_text=
## Set font glyph ranges. Defaults to Latin-only. Don't forget to set font_file/font_file_text to font that supports these
## Probably don't enable all at once because of memory usage and hardware limits concerns
## If you experience crashes or text is just squares, reduce glyph range or reduce font size
# font_glyph_ranges=korean,chinese,chinese_simplified,japanese,cyrillic,thai,vietnamese,latin_ext_a,latin_ext_b
### Outline text
text_outline
# text_outline_color = 000000
# text_outline_thickness = 1.5
### Change the hud position
# position=top-left
### Change the corner roundness
# round_corners=0
### Remove margins around MangoHud
# hud_no_margin
### Display compact version of MangoHud
# hud_compact
### Display MangoHud in a horizontal position
# horizontal
# horizontal_stretch
### Disable / hide the hud by default
# no_display
### Hud position offset
# offset_x=0
# offset_y=0
### Hud dimensions
# width=0
# height=140
# table_columns=3
# cellpadding_y=-0.085
### Hud transparency / alpha
# background_alpha=0.5
# alpha=1.0
### FCAT overlay
### This enables an FCAT overlay to perform frametime analysis on the final image stream.
### Enable the overlay
# fcat
### Set the width of the FCAT overlay.
### 24 is a performance optimization on AMD GPUs that should not have adverse effects on nVidia GPUs.
### A minimum of 20 pixels is recommended by nVidia.
# fcat_overlay_width=24
### Set the screen edge, this can be useful for special displays that don't update from top edge to bottom. This goes from 0 (left side) to 3 (top edge), counter-clockwise.
# fcat_screen_edge=0
### Color customization
# text_color=FFFFFF
# gpu_color=2E9762
# cpu_color=2E97CB
# vram_color=AD64C1
# ram_color=C26693
# engine_color=EB5B5B
# io_color=A491D3
# frametime_color=00FF00
# background_color=020202
# media_player_color=FFFFFF
# wine_color=EB5B5B
# battery_color=FF9078
### Specify GPU with PCI bus ID for AMDGPU and NVML stats
### Set to 'domain:bus:slot.function'
# pci_dev=0:0a:0.0
### Blacklist
# blacklist=
### Control over socket
### Enable and set socket name, '%p' is replaced with process id
## example: mangohud
## example: mangohud-%p
# control = -1
################ WORKAROUNDS #################
### Options starting with "gl_*" are for OpenGL
### Specify what to use for getting display size. Options are "viewport", "scissorbox" or disabled. Defaults to using glXQueryDrawable
# gl_size_query=viewport
### (Re)bind given framebuffer before MangoHud gets drawn. Helps with Crusader Kings III
# gl_bind_framebuffer=0
### Don't swap origin if using GL_UPPER_LEFT. Helps with Ryujinx
# gl_dont_flip=1
################ INTERACTION #################
### Change toggle keybinds for the hud & logging
# toggle_hud=Shift_R+F12
# toggle_hud_position=Shift_R+F11
# toggle_fps_limit=Shift_L+F1
# toggle_logging=Shift_L+F2
# reload_cfg=Shift_L+F4
# upload_log=Shift_L+F3
#################### LOG #####################
### Automatically start the log after X seconds
# autostart_log=
### Set amount of time in seconds that the logging will run for
# log_duration=
### Change the default log interval, 0 is default
# log_interval=0
### Set location of the output files (required for logging)
# output_folder=/home//mangologs
### Permit uploading logs directly to FlightlessMango.com
## set to 1 to enable
# permit_upload=0
### Define a '+'-separated list of percentiles shown in the benchmark results
### Use "AVG" to get a mean average. Default percentiles are 97+AVG+1+0.1
## example: ['97', 'AVG', '1', '0.1']
# benchmark_percentiles=97,AVG
## Adds more headers and information such as versioning to the log. This format is not supported on flightlessmango.com (yet)
# log_versioning
## Enable automatic uploads of logs to flightlessmango.com
# upload_logs
```
{% hint style="success" %}
Сам конфиг лежит здесь: `~/.config/MangoHud/MangoHud.conf`
{% endhint %}
### Чтобы заработало на Flatpak версии Steam:
**Метод 01:** Поместим наш конфиг в папку `.var`
```bash
~/.var/app/com.valvesoftware.Steam/config/MangoHud/MangoHud.conf
```
{% file src="/files/Bnbnnt0PZTaFcgJEGKh9" %}
Пример моего конфига
{% endfile %}
**Метод 02:** Даём доступ Steam (Flatapk) к нашему хосту:
```bash
flatpak override --user --filesystem=xdg-config/MangoHud:ro com.valvesoftware.Steam
```
### Примеры конфигураций:
`MANGOHUD_CONFIG=cpu_temp,gpu_temp,position=top-right,height=500,font_size=32`
| Переменная | Описание |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `af` | Уровень анизотропной фильтрации. Улучшает резкость текстур, рассматриваемых под углом. `0`- `16` |
| `alpha` | Установите непрозрачность всего текста и графика времени кадра. `0.0`- `1.0` |
| `arch` | Показать, является ли приложение 32- или 64-битным |
| `autostart_log=` | Запускает журнал через X секунд после инициализации mangohud. |
| `background_alpha` | Установите непрозрачность фона `0.0`- `1.0` |
| `battery_color` | Изменение цвета текста батареи |
| `battery_icon` | Отображать значок батареи вместо процентов |
| `battery_watt` | Отображение мощности для варианта с аккумулятором |
| `battery_time` | Отображение оставшегося времени для опции батареи |
| `battery` | Отображение текущего процента заряда батареи и энергопотребления |
| `benchmark_percentiles` | Настройте, какие процентили частоты кадров будут отображаться в сводке журнала. По умолчанию `97,AVG,1,0.1` |
| `bicubic` | Принудительная бикубическая фильтрация |
| `blacklist` | Добавьте программу в черный список. например `blacklist=vkcube,WatchDogs2.exe` |
| `cellpadding_y` | Установите вертикальное заполнение ячеек, по умолчанию `-0.085` |
| `control=` |
Устанавливает сокет unix с определенным именем, к которому можно подключиться с помощью mangohud-control. Т.е. control=mangohudили control=mangohud-%p ( %pбудет заменен идентификатором процесса)
|
| `core_load_change` | Изменить цвета загрузки ядра процессора, использовать те же данные из `cpu_load_value`и `cpu_load_change` |
| `core_load` | Отображение нагрузки и частоты на ядро |
| `core_bars` | Изменить отображение `core_load`от цифр к вертикальным полосам |
| `cpu_load_change` | Изменение цвета загрузки процессора в зависимости от нагрузки |
| `cpu_load_color` | Установите цвета для изменения загрузки графического процессора: низкий, средний и высокий. например `cpu_load_color=0000FF,00FFFF,FF00FF` |
| `cpu_load_value` | Установите значения для средней и высокой нагрузки, например `cpu_load_value=50,90` |
| `cpu_mhz` | Показать текущие частоты процессоров |
|
cpu\_power gpu\_power
| Потребление процессора/графического процессора дисплея в ваттах |
|
| Отображение текущей температуры процессора/графического процессора |
|
cpu\_text gpu\_text
| Переопределить текст процессора и графического процессора |
| `custom_text_center` | Отображение пользовательского текста по центру, полезного для заголовка, например `custom_text_center=FlightLessMango Benchmarks` |
| `custom_text` | Отображение пользовательского текста, например `custom_text=Fsync enabled` |
| `debug` | Показывает график частоты кадров и задержки приложения Gamescope (очевидно, только для Gamescope). |
| `device_battery_icon` | Отображение значка батареи беспроводного устройства. |
| `device_battery` | Отображение процента заряда батареи беспроводного устройства. Поддерживаемые в настоящее время аргументы `gamepad`и `mouse`например `device_battery=gamepad,mouse` |
| `dynamic_frame_timing` | Это изменяет ось Y Frame\_timing, чтобы она соответствовала текущему максимальному и минимальному времени кадра, а не статическим значениям 0–50. |
| `engine_short_names` | Отобразить краткую версию используемого двигателя (например, `OGL`вместо `OpenGL`) |
| `engine_version` | Отобразить OpenGL или версию vulkan и механизма рендеринга на его основе. |
| `exec` | Отобразить вывод команды bash в следующем столбце, например `custom_text=/home` , `exec=df -h /home \| tail -n 1`. Работает только с `legacy_layout=0` |
| `exec_name` | Отображение текущего имени исполнителя |
| `fan` | Показывает скорость вращения вентилятора Steam Deck. |
| `fcat` | Включает анализ захвата кадров |
| `fcat_overlay_width=` | Устанавливает ширину fcat. По умолчанию `24` |
| `fcat_screen_edge=` | Определяет, на каком крае будет отображаться fcat. Значение между `1`и `4` |
| `font_file_text` | Изменить шрифт текста. В противном случае `font_file`используется |
| `font_file` | Изменить шрифт по умолчанию (установить местоположение файла .TTF/.OTF) |
| `font_glyph_ranges` | Укажите дополнительные диапазоны глифов шрифта через запятую: `korean`, `chinese`, `chinese_simplified`, `japanese`, `cyrillic`, `thai`, `vietnamese`, `latin_ext_a`, `latin_ext_b`. Если у вас возникают сбои или текст представляет собой просто квадраты, уменьшите размер шрифта или диапазоны глифов. |
| `font_scale=` | Установите глобальный масштаб шрифта. По умолчанию `1.0` |
| `font_scale_media_player` | Изменить размер текста медиаплеера относительно `font_size` |
| `font_size=` | Настраиваемый размер шрифта. По умолчанию `24` |
| `font_size_text=` | Настраиваемый размер шрифта для другого текста, например метаданных мультимедиа. По умолчанию `24` |
| `fps_color_change` | Измените цвет текста FPS в зависимости от значения FPS. |
| `fps_color=` | Выберите цвета, на которые будет меняться fps, когда `fps_color_change`включен. Соответствует fps\_value. По умолчанию `b22222,fdfd09,39f900` |
| `fps_limit_method` | Ограничитель FPS должен подождать до или после представления кадра. Выбирать `late`(по умолчанию) для минимальной задержки или `early`для максимально плавного отображения кадров |
| `fps_limit` | Ограничьте частоту кадров приложений. Разделенный запятыми список одного или нескольких значений FPS. `0`означает неограниченный |
| `fps_only` | Показывать только FPS. ***Не предназначен для использования с другими параметрами отображения.*** |
| `fps_sampling_period=` | Интервал времени между двумя точками выборки для сбора FPS в миллисекундах. По умолчанию `500` |
| `fps_value=` | Выберите точки останова, где `fps_color_change`меняет цвета между. Например `60,144`, по умолчанию `30,60` |
| `frame_count` | Отображение количества кадров |
| `frametime` | Отображение времени кадра рядом с текстом FPS |
| `fsr` | Отображение статуса FSR (работает только в области игры) |
| `full` | Включите большинство переключаемых параметров (в настоящее время исключает `histogram`) |
| `gamemode` | Показать, включен ли GameMode |
|
| Изменить цвета по умолчанию: `gpu_color=RRGGBB` |
|
gpu\_core\_clock gpu\_mem\_clock
| Отображение частоты ядра/памяти графического процессора |
| `gpu_fan` | Вентилятор графического процессора в об/мин на AMD, FAN в процентах на NVIDIA |
| `gpu_load_change` | Изменение цвета загрузки графического процессора в зависимости от нагрузки |
| `gpu_load_color` | Установите цвета для изменения нагрузки на графический процессор: низкий, средний и высокий. например `gpu_load_color=0000FF,00FFFF,FF00FF` |
| `gpu_load_value` | Установите значения для средней и высокой нагрузки, например `gpu_load_value=50,90` |
| `gpu_name` | Отображать имя графического процессора из pci.ids |
| `gpu_voltage` | Отображение напряжения графического процессора (работает только с графическими процессорами AMD) |
| `hide_fsr_sharpness` | Скрывает информацию о резкости для `fsr`опция (доступна только в gamescope) |
| `histogram` | Изменить график FPS на гистограмму |
| `horizontal` | Выставить Мангохуд в горизонтальном положении |
| `horizontal_stretch` | Растягивает фон по ширине экрана `horizontal`режим |
| `hud_compact` | Показать компактную версию МангоХуда |
| `hud_no_margin` | Удалить поля вокруг MangoHud |
|
io\_read io\_write
| Показать некэшированные операции ввода-вывода, чтение/запись, в МиБ/с. |
| `log_duration` | Установите время, в течение которого будет вестись журнал (в секундах). |
| `log_interval` | Измените интервал журнала по умолчанию в миллисекундах. По умолчанию `0` |
| `log_versioning` | Добавляет в журнал дополнительные заголовки и информацию, такую как управление версиями. Этот формат не поддерживается на сайте Flightlessmango.com (пока). |
| `media_player_format` | Отформатируйте метаданные медиаплеера. Добавить дополнительный текст и т. д. Точка с запятой переходит на новую строку. По умолчанию `{title};{artist};{album}` |
| `media_player_name` | Принудительно указать имя службы DBus медиаплеера без `org.mpris.MediaPlayer2`часть, как `spotify`, `vlc`, `audacious`или `cantata`. Если ничего не установлено, MangoHud пытается переключаться между играющими в данный момент игроками. |
| `media_player` | Показать метаданные медиаплеера |
| `no_display` | Скрыть HUD по умолчанию |
| `no_small_font` | Используйте основной размер шрифта для меньшего текста, например единиц измерения. |
| `offset_x` `offset_y` | Смещения позиции HUD |
| `output_file` | Установите местоположение и имя файла журнала |
| `output_folder` | Установите расположение выходных файлов (требуется для ведения журнала) |
| `pci_dev` | Выберите устройство графического процессора в настройках с несколькими графическими процессорами. |
| `permit_upload` | Разрешить загрузку логов на Flightlessmango.com |
| `picmip` | Смещение LoD мип-карты. Отрицательные значения увеличивают резкость текстуры (и сглаживание). Положительные значения увеличат размытость текстуры. `-16`- `16` |
| `position=` | Расположение HUD: `top-left`(по умолчанию), `top-right`, `middle-left`, `middle-right`, `bottom-left`, `bottom-right`, `top-center`, `bottom-center` |
| `preset=` |
Список одной или нескольких предустановок, разделенных запятыми. По умолчанию -1,0,1,2,3,4. Доступные пресеты: 0(Не Хад) 1(Только FPS) 2(Горизонтально) 3(Расширенный) 4(Подробно) Пользовательские пресеты можно создать с помощью файла пресетов.conf в \~/.config/MangoHud/.
|
|
procmem procmem\_shared, procmem\_virt
| Отображает использование памяти процессом: резидентную, общую и/или виртуальную. `procmem`(резидент) также отключает другие, если отключено |
|
ram vram
| Отображение использования оперативной памяти/видеопамяти системы |
| `read_cfg` | Добавьте в MANGOHUD\_CONFIG в качестве первого параметра, чтобы также загрузить файл конфигурации. В противном случае только `MANGOHUD_CONFIG`используются параметры |
| `reload_cfg=` | Измените привязку клавиш для перезагрузки конфига. По умолчанию = `Shift_L+F4` |
| `resolution` | Отображение текущего разрешения |
| `retro` | Отключите линейную фильтрацию текстур. Делает текстуры блочными |
| `round_corners` | Измените степень округлости углов, например `round_corners=10.0` |
| `show_fps_limit` | Отображение текущего ограничения FPS |
| `swap` | Отображение использования пространства подкачки рядом с использованием системной оперативной памяти. |
| `table_columns` | Установите количество столбцов таблицы для ImGui, по умолчанию — 3. |
| `temp_fahrenheit` | Показывать температуру в градусах Фаренгейта |
| `text_outline` | Нарисуйте контур вокруг текста для лучшей читаемости. Включено по умолчанию. |
| `text_outline_color=` | Установить цвет `text_outline`. По умолчанию = `000000` |
| `text_outline_thickness=` | Установите толщину `text_outline`. По умолчанию = `1.5` |
| `throttling_status` | Показать, регулируется ли графический процессор в зависимости от мощности, тока, температуры или «другого» (показывает только то, происходит ли регулирование в данный момент). В настоящее время отключено по умолчанию для Nvidia, поскольку вызывает задержку на сериях 3000. |
| `throttling_status_graph` | Такой же как `throttling_status`но отображает регулирование на графике времени кадра и только регулирование мощности и температуры |
|
time time\_format=%T
| Отображение местного времени. См. [std::put\_time ](https://en.cppreference.com/w/cpp/io/manip/put_time)для получения помощи по форматированию. ПРИМЕЧАНИЕ. Иногда приложения могут устанавливать `TZ`(часовой пояс) переменная среды в UTC/GMT |
| `toggle_fps_limit` | Циклическое переключение между пределами FPS (необходимо установить как минимум два значения с помощью `fps_limit`). По умолчанию `Shift_L+F1` |
| `toggle_preset` | Циклическое переключение между пресетами. По умолчанию `Shift_R+F10` |
|
toggle\_hud= toggle\_logging=
| Изменяемые горячие клавиши переключения. По умолчанию: `Shift_R+F12`и `Shift_L+F2`, соответственно |
| `toggle_hud_position` | Переключить положение MangoHud. По умолчанию `R_Shift+F11` |
| `trilinear` | Принудительная трилинейная фильтрация |
| `upload_log` | Изменить привязку клавиш для загрузки журнала |
| `upload_logs` | Включает автоматическую загрузку журналов на сайт Flightlessmango.com. |
| `version` | Показать текущую версию MangoHud |
| `vkbasalt` | Показать, включен ли vkBasalt |
|
vsync gl\_vsync
| Установите Vsync для OpenGL или Vulkan |
| `vulkan_driver` | Отобразить используемый драйвер Vulkan (radv/amdgpu-pro/amdvlk) |
|
width= height=
| Настраиваемые размеры HUD (в пикселях) |
| `wine_color` | Изменить цвет текста вина/протона |
| `wine` | Показать текущую используемую версию Wine или Proton |
### Пример конфига:
`MANGOHUD_CONFIG=cpu_temp,gpu_temp,position=top-right,height=500,font_size=32`
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://plafon.gitbook.io/alt-zero/linuxgaming/steam/mangohud.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.