Флаги вслух: dash r, double-dash force
Тема дорожной карты · Английский для IT
🔊 Словарь терминов с произношением →
Диктовка команды — типичная ситуация на созвоне, в голосовом канале поддержки или при парном программировании без общего экрана, и у неё есть свои конвенции. Короткие флаги с одним дефисом читаются как dash плюс буква: -r — dash r, -v — dash v, -la — dash l a. Длинные с двумя дефисами — dash dash или double-dash плюс слово: --force — dash dash force или double-dash force, --dry-run — double-dash dry dash run (второй дефис внутри слова — dash или hyphen). Аргумент флага присоединяется словом equals или паузой: --output=file.txt — double-dash output equals file dot txt, -o file.txt — dash o, file dot txt. Часто вместо буквы называют смысл, если он общепринят: -r — recursive, -f — force, -v — verbose, -h — help или human-readable в зависимости от команды, -n — dry run или line numbers, -i — interactive или case-insensitive, -a — all, -l — long, -p — port или parents. Конвенции GNU: короткие флаги можно объединять (-rf — dash r f), длинные нельзя; -- отдельно — double-dash, конец опций, после него всё считается аргументами; - отдельно — dash, обозначает stdin или stdout. Отдельно стоят Windows-стиль /s — slash s и Java-стиль -Xmx2g — dash X m x two g.
Как произносится
Flag /flæɡ/, option /ˈɒpʃən/, switch /swɪtʃ/, argument /ˈɑːrɡjʊmənt/, dash /dæʃ/, hyphen /ˈhaɪfən/, double-dash /ˌdʌbl ˈdæʃ/, verbose /vɜːrˈboʊs/ («вёрбОус», ударение на второй слог), recursive /rɪˈkɜːrsɪv/ («рикЁрсив»), force /fɔːrs/, dry run /draɪ rʌn/, interactive /ˌɪntərˈæktɪv/, human-readable /ˌhjuːmən ˈriːdəbl/, quiet /ˈkwaɪət/, silent /ˈsaɪlənt/, equals /ˈiːkwəlz/, shorthand /ˈʃɔːrthænd/ (краткая форма), long form /lɒŋ fɔːrm/, positional /pəˈzɪʃənəl/ (позиционный аргумент).
Как употребляется
Диктовка команд:
rm -rf ./build— r m dash r f, dot slash build.ls -la— l s dash l a.git push --force-with-lease— git push double-dash force dash with dash lease.docker run -d -p 8080:80 --name web nginx— docker run dash d, dash p eighty eighty colon eighty, double-dash name web, nginx.kubectl get pods -n prod -o wide— kubectl get pods dash n prod, dash o wide.curl -sSL https://example.com | sh— curl dash s capital S capital L, the URL, pipe sh.tar -xzvf archive.tar.gz— tar dash x z v f, archive dot tar dot g z, или по смыслу: tar, extract, gzipped, verbose, file.grep -rni "todo" src/— grep dash r n i, quote todo quote, src slash.
Фразы: Add the verbose flag. — Добавь флаг verbose. Run it with dash dash dry-run first. — Сначала прогони с dry-run. Pass the config with dash c. — Передай конфиг через -c. That flag takes an argument. — У этого флага есть аргумент. The short form is dash o. — Краткая форма — -o. Double-dash on its own ends the options. — Одиночный -- завершает опции.
Ловушки
Первая ловушка — minus вместо dash: -r это dash r, minus понимают, но так не говорят. Вторая — не различать регистр: -s и -S у curl означают разное, диктуйте lowercase s и capital S. Третья — читать объединённые флаги как слово: -rf это не «рф», а dash r f. Четвёртая — hyphen внутри длинного флага без указания: double-dash dry run без слова dash между dry и run могут записать как --dry run; говорите dry dash run или dry hyphen run. Пятая — equals против пробела: --output=file и --output file обычно эквивалентны, но -o=file часто нет; диктуйте, как написано. Шестая — русское «ключ» для флага: по-английски key это ключ шифрования или ключ словаря, а флаг — flag или option.