X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=blobdiff_plain;f=dgit.7;h=70165a1b69d0d9f745ae6e2f2a92135f985a8870;hp=c3e581853701e1b820d53cdb8be3f52b511cd04b;hb=8b34c8e50e236ea9340693c9a425cc2cb2f957ad;hpb=8ac258a499a5d034684d47c6144be82b87535c24 diff --git a/dgit.7 b/dgit.7 index c3e58185..70165a1b 100644 --- a/dgit.7 +++ b/dgit.7 @@ -205,6 +205,9 @@ is configured this way. git has features which can automatically transform files as they are being copied between the working tree and the git history. +The attributes can be specified in the source tree itself, +in +.BR .gitattributes . See \fBgitattributes\fP(5). These transformations are context-sensitive @@ -213,14 +216,28 @@ 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), +where the transforming gitattributes are defused, to achieve this.) -If transforming gitattributes used, +If transforming gitattributes are used, they can cause trouble, because the working tree files can differ from the git revision history (and therefore from the source packages). +dgit warns if it finds a .gitattributes file +(in a package being fetched or imported), +unless the transforming gitattributes have been defused. + +dgit clone +and dgit setup-new-tree +disable transforming gitattributes +by default, +by creating a suitable .git/info/attributes. +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