1git-check-attr(1) 2================= 3 4NAME 5---- 6git-check-attr - Display gitattributes information 7 8 9SYNOPSIS 10-------- 11[verse] 12'git check-attr' [-a | --all | attr...] [--] pathname... 13'git check-attr' --stdin [-z] [-a | --all | attr...] < <list-of-paths> 14 15DESCRIPTION 16----------- 17For every pathname, this command will list if each attribute is 'unspecified', 18'set', or 'unset' as a gitattribute on that pathname. 19 20OPTIONS 21------- 22-a, --all:: 23 List all attributes that are associated with the specified 24 paths. If this option is used, then 'unspecified' attributes 25 will not be included in the output. 26 27--cached:: 28 Consider `.gitattributes` in the index only, ignoring the working tree. 29 30--stdin:: 31 Read file names from stdin instead of from the command-line. 32 33-z:: 34 Only meaningful with `--stdin`; paths are separated with a 35 NUL character instead of a linefeed character. 36 37\--:: 38 Interpret all preceding arguments as attributes and all following 39 arguments as path names. 40 41If none of `--stdin`, `--all`, or `--` is used, the first argument 42will be treated as an attribute and the rest of the arguments as 43pathnames. 44 45OUTPUT 46------ 47 48The output is of the form: 49<path> COLON SP <attribute> COLON SP <info> LF 50 51<path> is the path of a file being queried, <attribute> is an attribute 52being queried and <info> can be either: 53 54'unspecified';; when the attribute is not defined for the path. 55'unset';; when the attribute is defined as false. 56'set';; when the attribute is defined as true. 57<value>;; when a value has been assigned to the attribute. 58 59EXAMPLES 60-------- 61 62In the examples, the following '.gitattributes' file is used: 63--------------- 64*.java diff=java -crlf myAttr 65NoMyAttr.java !myAttr 66README caveat=unspecified 67--------------- 68 69* Listing a single attribute: 70--------------- 71$ git check-attr diff org/example/MyClass.java 72org/example/MyClass.java: diff: java 73--------------- 74 75* Listing multiple attributes for a file: 76--------------- 77$ git check-attr crlf diff myAttr -- org/example/MyClass.java 78org/example/MyClass.java: crlf: unset 79org/example/MyClass.java: diff: java 80org/example/MyClass.java: myAttr: set 81--------------- 82 83* Listing all attributes for a file: 84--------------- 85$ git check-attr --all -- org/example/MyClass.java 86org/example/MyClass.java: diff: java 87org/example/MyClass.java: myAttr: set 88--------------- 89 90* Listing an attribute for multiple files: 91--------------- 92$ git check-attr myAttr -- org/example/MyClass.java org/example/NoMyAttr.java 93org/example/MyClass.java: myAttr: set 94org/example/NoMyAttr.java: myAttr: unspecified 95--------------- 96 97* Not all values are equally unambiguous: 98--------------- 99$ git check-attr caveat README 100README: caveat: unspecified 101--------------- 102 103SEE ALSO 104-------- 105linkgit:gitattributes[5]. 106 107GIT 108--- 109Part of the linkgit:git[1] suite