]>
Commit | Line | Data |
---|---|---|
b568a503 JB |
1 | git-check-attr(1) |
2 | ================= | |
3 | ||
4 | NAME | |
5 | ---- | |
6 | git-check-attr - Display gitattributes information. | |
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 |