gitattributes: Issue a warning on un-defused .gitattributes

[dgit.git] / dgit.7

diff --git a/dgit.7 b/dgit.7
index 284fcf65d6ca522ad574fe8f0a041931f8545e55..09bb8f4424f9d235e8ca115b61c593980bfd93ae 100644 (file)
--- a/dgit.7
+++ b/dgit.7
@@ -211,12 +211,32 @@ These transformations are context-sensitive
 and not, in general, reversible,
 so dgit operates on the principle that
 the dgit git history contains the actual contents of the package.
+(When dgit is manipulating a .dsc,
+it does so in a private area,
+where the transforming gitattributes are defused (disabled),
+to achieve this.)
 
 If transforming gitattributes used,
 they can cause trouble,
 because the working tree files can differ from
 the git revision history
 (and therefore from the source packages).
+
+So dgit clone
+and dgit setup-new-tree
+disable transforming gitattributes
+by default,
+by creating a .git/info/attributes.
+When fetching or importing sources
+dgit warns if it finds .gitattributes file
+and the transforming gitattributes have not been defused
+(e.g. in the case of a tree not made with dgit clone).
+
+See
+.B dgit setup-new-tree
+and
+.B dgit setup-gitattributes
+in dgit(1).
 .SH PACKAGE SOURCE FORMATS
 If you are not the maintainer, you do not need to worry about the
 source format of the package.  You can just make changes as you like