oracular (1) gbp-setup-gitattributes.1.gz

NAME

       gbp-setup-gitattributes - Set up Git attributes for packaging

SYNOPSIS

       gbp setup-gitattributes [--version] [--help] [--verbose] [--color=[auto|on|off]] [--color-scheme=
                               COLOR_SCHEME] [--[no-]dgit-defuse-attrs] [--all]

DESCRIPTION

       gbp setup-gitattributes sets up .git/info/attributes in the current Git repository to sane defaults  most
       suitable  for packaging work. At the moment, this amounts to making sure no transformations happen during
       checkout, commit or export. More attributes may be added in future, by default  all  known  settings  are
       applied.

       Upstream  sources may ship .gitattributes files enabling certain transformations to the committed source,
       usually to make working with files in different encodings more convenient for the upstream  authors.  For
       Debian  packaging,  it  is  necessary  to  override  these  attributes,  since  they cause often unwanted
       conversion of files (e.g.  line endings, encodings and some others). Working with  such  source  tree  is
       confusing,  since  the working tree differs from the Git history (and sometimes from the source tarball),
       and can lead to errors.

       By default, gbp clone tries to detect the usage of .gitattributes in the upstream source and disables the
       Git attributes only when necessary.

OPTIONS

       --version
              Print version of the program, i.e. version of the git-buildpackage suite

       -v, --verbose
              Verbose execution

       -h, --help
              Print help and exit

       --color=[auto|on|off]
              Whether to use colored output.

       --color-scheme=COLOR_SCHEME
              Colors   to   use   in   output   (when   color  is  enabled).  The  format  for  COLOR_SCHEME  is
              '<debug>:<info>:<warning>:<error>'.  Numerical values and color names are accepted,  empty  fields
              imply  the default color. For example, --git-color-scheme='cyan:34::' would show debug messages in
              cyan, info messages in blue and other messages in default (i.e.  warning  and  error  messages  in
              red).

       --[no-]dgit-defuse-attrs
              Disables  all  transforming  attributes  for all files. This is done by defining a macro attribute
              [attr]dgit-defuse-attrs and applying it to * together with export-subst and export-ignore.

              This method is compatible with dgit and git-deborig which use this macro attribute. Older versions
              of  dgit  use an incomplete preset missing some attributes; if such is found, it is replaced by an
              updated definition.

       --all  Apply all known Git attribute settings. This is the default.

SEE ALSO

       gbp-clone(1), gbp-push(1), gbp.conf(5), gitattributes(5), dgit(7)

AUTHOR

       Andrej Shadura <andrew@shadura.me>

                                                   2 July 2024                        gbp-setup-gitattributes(1)