# [PATCH] gitattributes: document more clearly where macros are allowed

1 messages from 2014-01-14 to 2014-01-14. Participants: Michael Haggerty.
Thread: https://gitlist.dev/t/35651

## Michael Haggerty, 2014-01-14 02:58

Subject: [PATCH] gitattributes: document more clearly where macros are allowed
Message-ID: <1389668329-15719-1-git-send-email-mhagger@alum.mit.edu>
URL: https://gitlist.dev/e/1389668329-15719-1-git-send-email-mhagger%40alum.mit.edu

```
The old text made it sound like macros are only allowed in the
.gitattributes file at the top-level of the working tree.  Make it
clear that they are also allowed in $GIT_DIR/info/attributes and in
the global and system-wide gitattributes files.

Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu>
---
 Documentation/gitattributes.txt | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/Documentation/gitattributes.txt b/Documentation/gitattributes.txt
index b322a26..643c1ba 100644
--- a/Documentation/gitattributes.txt
+++ b/Documentation/gitattributes.txt
@@ -930,9 +930,12 @@ state.
 DEFINING MACRO ATTRIBUTES
 -------------------------
 
-Custom macro attributes can be defined only in the `.gitattributes`
-file at the toplevel (i.e. not in any subdirectory).  The built-in
-macro attribute "binary" is equivalent to:
+Custom macro attributes can be defined only in top-level gitattributes
+files (`$GIT_DIR/info/attributes`, the `.gitattributes` file at the
+top level of the working tree, or the global or system-wide
+gitattributes files), not in `.gitattributes` files in working tree
+subdirectories.  The built-in macro attribute "binary" is equivalent
+to:
 
 ------------
 [attr]binary -diff -merge -text
-- 
1.8.5.2

```
