С какой точной версией (версиями) git branch (git-branch) поддерживает опцию --format?

Question

Я нахожу опцию "--format" довольно удобной.

более подробно, особенно директива "%(refname:short)", внутри которой (где Git ["git)"] версия также мне неизвестна и может рассматриваться как бонус в вопросе) отступление на нотации опции" --pretty=format:... ", но в любом случае ....

Вопрос в том,с каких это пор "git branch" ("git-branch") поддерживает опцию / значение

--format="%(refname:short)

?

Кроме того, я был бы признателен, если бы ответ рядом с конкретной версией Gitтакже предложил бы небольшой тестовый скрипт (shell / bash), который помог бы мне формально проверить правильность ответа.Я просто был бы признателен, это не требуется условиями IIRC этого сайта, так что просто скажу.Дайте мне знать, если вы бы предпочли награду за это и как высоко вы бы предпочли, чтобы она была.

Answer 1

git-branch было расширено, чтобы включить опции формата из git-for-each-ref в v2.13.0, онлайн-документация git сначала ссылается на него в v2.13.2 .

Как найтиответ

Чтобы выследить его, потребовалась небольшая легкая детективная работа, но исходный код git довольно хорошо поддерживается, так что это помогает.

Поскольку я знал, что функциональность обеспечивается git-for-each-ref,Я подумал, что интеграция будет незначительной и ее будет нелегко найти, взглянув на сам исходный код, поэтому я перешел к документации для git-branch, так как она была бы обновлена ​​с новыми параметрами при добавлении функциональности.

С помощью файла для сужения, было довольно легко найти самый старый коммит с --format в diff, используя git-log

git log -S--format -- Documentation/git-branch.txt

, вооруженный хэшем коммита (былотолько один) Я мог бы затем использовать git-for-each-ref, чтобы найти теги, содержащие изменения, и тем самым определить самую раннюю версию, содержащую фиксацию.

git for-each-ref --contains 3d9e4ce3eb

Это дало мнеv2.13.0, затем я проверил веб-сайт и обнаружил, что следующая доступная версия документации была v2.13.2.