0000-gitk-cover-letter.txt

   1 From 4137ab3807278b2576d9d682eb7896d17257cc89 Mon Sep 17 00:00:00 2001
   2 From: Ian Jackson <ijackson@chiark.greenend.org.uk>
   3 CC: Junio C Hamano <gitster@pobox.com>,
   4     Paul Mackerras <paulus@samba.org>
   5 Date: Tue, 8 Nov 2016 00:40:41 +0000
   6 Subject: [PATCH 0/6] Provide for config to specify tags not to abbreviate
   7
   8 Hi.
   9
  10 Please find in the following mails patches which provide a way to make
  11 gitk display certain tags in full, even if they would normally be
  12 abbreviated.
  13
  14 There are four patches to gitk, three to prepare the ground, and one
  15 to introduce the new feature.
  16
  17 There is one patch for git, to just document the new config variable.
  18
  19 I hope this is the right way to submit this series.  Thanks for your
  20 attention.
  21
  22
  23 As I say in the patch "gitk: Provide for config to specify tags not to
  24 abbreviate":
  25
  26 The config setting is in git config logs.* rather than gitk's
  27 own configuration, because:
  28
  29  - Tools which manage git trees may want to set this, depending
  30    on their knowledge of the nature of the tags likely to be
  31    present;
  32
  33  - Whether this property ought to be set is mostly a property of the
  34    contents of the tag namespaces in the tree, not a user preference.
  35    (Although of course user preferences are supported.)
  36
  37  - Other git utilities (or out of tree utilities) may want to
  38    reference this setting for their own display purposes.
  39
  40 There will be another, separate, patch to the `git' tree to document
  41 this config option.
  42
  43 Background motivation:
  44
  45 Debian's dgit archive gateway tool generates and uses tags called
  46 archive/debian/VERSION.  If such a tag refers to a Debian source tree,
  47 it is probably very interesting because it refers to a version
  48 actually uploaded to Debian by the Debian package maintainer.
  49
  50 We would therefore like a way to specify that such tags should be
  51 displayed in full.  dgit will be able to set an appropriate config
  52 setting in the trees it deals with.
  53
  54
  55
  56 Ian Jackson (4):
  57   gitk: Internal: drawtags: Abolish "singletag" variable
  58   gitk: Internal: drawtags: Idempotently reset "ntags"
  59   gitk: drawtags: Introduce concept of unabbreviated marks
  60   gitk: Provide for config to specify tags not to abbreviate
  61
  62  gitk | 34 ++++++++++++++++++++++++++++++----
  63  1 file changed, 30 insertions(+), 4 deletions(-)
  64
  65
  66 Ian Jackson (1):
  67   config docs: Provide for config to specify tags not to abbreviate
  68
  69  Documentation/config.txt | 8 ++++++++
  70  1 file changed, 8 insertions(+)
  71
  72
  73 --
  74 2.10.1
  75