projects / thirdparty / git.git / blame
| Commit | Line | Data |
|---|---|---|
| b568a503 JB |
1 | git-check-attr(1) |
| 2 | ================= | |
| 3 | ||
| 4 | NAME | |
| 5 | ---- | |
| 0d641f75 | 6 | git-check-attr - Display gitattributes information |
| b568a503 JB |
7 | |
| 8 | ||
| 9 | SYNOPSIS | |
| 10 | -------- | |
| b1889c36 | 11 | 'git check-attr' attr... [--] pathname... |
| b568a503 JB |
12 | |
| 13 | DESCRIPTION | |
| 14 | ----------- | |
| 15 | For every pathname, this command will list if each attr is 'unspecified', | |
| 16 | 'set', or 'unset' as a gitattribute on that pathname. | |
| 17 | ||
| 18 | OPTIONS | |
| 19 | ------- | |
| 20 | \--:: | |
| 21 | Interpret all preceding arguments as attributes, and all following | |
| 22 | arguments as path names. If not supplied, only the first argument will | |
| 23 | be treated as an attribute. | |
| 24 | ||
| 5782566d JF |
25 | OUTPUT |
| 26 | ------ | |
| 27 | ||
| 28 | The output is of the form: | |
| 29 | <path> COLON SP <attribute> COLON SP <info> LF | |
| 30 | ||
| 31 | Where <path> is the path of a file being queried, <attribute> is an attribute | |
| 32 | being queried and <info> can be either: | |
| 33 | ||
| 34 | 'unspecified';; when the attribute is not defined for the path. | |
| 35 | 'unset';; when the attribute is defined to false. | |
| 36 | 'set';; when the attribute is defined to true. | |
| 37 | <value>;; when a value has been assigned to the attribute. | |
| 38 | ||
| 39 | EXAMPLES | |
| 40 | -------- | |
| 41 | ||
| 42 | In the examples, the following '.gitattributes' file is used: | |
| 43 | --------------- | |
| 44 | *.java diff=java -crlf myAttr | |
| 45 | NoMyAttr.java !myAttr | |
| 46 | README caveat=unspecified | |
| 47 | --------------- | |
| 48 | ||
| 49 | * Listing a single attribute: | |
| 50 | --------------- | |
| 51 | $ git check-attr diff org/example/MyClass.java | |
| 52 | org/example/MyClass.java: diff: java | |
| 53 | --------------- | |
| 54 | ||
| 55 | * Listing multiple attributes for a file: | |
| 56 | --------------- | |
| 57 | $ git check-attr crlf diff myAttr -- org/example/MyClass.java | |
| 58 | org/example/MyClass.java: crlf: unset | |
| 59 | org/example/MyClass.java: diff: java | |
| 60 | org/example/MyClass.java: myAttr: set | |
| 61 | --------------- | |
| 62 | ||
| 63 | * Listing attribute for multiple files: | |
| 64 | --------------- | |
| 65 | $ git check-attr myAttr -- org/example/MyClass.java org/example/NoMyAttr.java | |
| 66 | org/example/MyClass.java: myAttr: set | |
| 67 | org/example/NoMyAttr.java: myAttr: unspecified | |
| 68 | --------------- | |
| 69 | ||
| 70 | * Not all values are equally unambiguous: | |
| 71 | --------------- | |
| 72 | $ git check-attr caveat README | |
| 73 | README: caveat: unspecified | |
| 74 | --------------- | |
| b568a503 | 75 | |
| 0e545f75 JH |
76 | SEE ALSO |
| 77 | -------- | |
| 5162e697 | 78 | linkgit:gitattributes[5]. |
| 0e545f75 JH |
79 | |
| 80 | ||
| b568a503 JB |
81 | Author |
| 82 | ------ | |
| 59eb68aa | 83 | Written by Junio C Hamano <gitster@pobox.com> |
| b568a503 JB |
84 | |
| 85 | Documentation | |
| 86 | -------------- | |
| 87 | Documentation by James Bowes. | |
| 88 | ||
| 89 | GIT | |
| 90 | --- | |
| 9e1f0a85 | 91 | Part of the linkgit:git[1] suite |