git describe
git
쓰는 꼴
git describe [--tags] [--dirty]가까운 태그를 기준으로 지금 커밋에 v1.2.0-5-gabc1234 같은 이름을 붙여 줍니다 — 기본은 주석 태그만 보므로 가벼운 태그에는 --tags가, 태그가 하나도 없으면 --always가 필요합니다.
자주 쓰는 옵션
| 옵션 | 뜻 |
|---|---|
| --tags | use lightweight tags too, not just annotated ones |
| --dirty | append -dirty when the working tree has changes |
| --always | fall back to a bare hash when no tag is found |
| --long | always the full tag-count-hash form |
| --abbrev=<n> | how many hash digits to print |
| --match <pattern> | only consider matching tags |
예시
git describe --tags --dirtyprints something like v1.2.0-5-gabc1234-dirty
git describe --alwaysnever fails, even in a repository with no tags
git describe --match "v*" --longignores tags that are not versions
되돌리는 방법이 여럿이라 헷갈립니다 — 가리키는 곳을 옮기는 것과 새 커밋을 얹는 것은 다릅니다.
읽는 방법
- 대괄호 [ ]는 넣어도 되고 안 넣어도 되는 자리입니다.
- 점 셋 …은 여러 개를 이어 쓸 수 있다는 뜻입니다.
- 옵션은 대소문자를 가립니다 — -r과 -R이 다른 명령도 있습니다.
자주 묻는 것
Q. git describe은 무엇을 하나요?
가까운 태그를 기준으로 지금 커밋에 v1.2.0-5-gabc1234 같은 이름을 붙여 줍니다 — 기본은 주석 태그만 보므로 가벼운 태그에는 --tags가, 태그가 하나도 없으면 --always가 필요합니다.
Q. 어떻게 치나요?
git describe [--tags] [--dirty] — 대괄호는 생략할 수 있는 자리입니다.
Q. 옵션은 몇 개나 자주 쓰나요?
여기 정리한 것은 6개입니다. 전체 목록은 man git에 있습니다. 이 명령은 git 갈래입니다.
같이 보는 명령
man 페이지: man git-describe