Skip to content
  • Matthieu Moy's avatar
    make color.ui default to 'auto' · 4c7f1819
    Matthieu Moy authored and Junio C Hamano's avatar Junio C Hamano committed
    
    
    Most users seem to like having colors enabled, and colors can help
    beginners to understand the output of some commands (e.g. notice
    immediately the boundary between commits in the output of "git log").
    
    Many tutorials tell the users to set color.ui=auto as a very first step,
    which tend to indicate that color.ui=none is not the recommanded value,
    hence should not be the default.
    
    These tutorials would benefit from skipping this step and starting the
    real Git manipulations earlier. Other beginners do not know about
    color.ui=auto, and may not discover it by themselves, hence live with
    black&white outputs while they may have preferred colors.
    
    A few people (e.g. color-blind) prefer having no colors, but they can
    easily set color.ui=never for this (and googling "disable colors in git"
    already tells them how to do so), but this needs not occupy space in
    beginner-oriented documentations.
    
    A transition period with Git emitting a warning when color.ui is unset
    would be possible, but the discomfort of having the warning seems
    superior to the benefit: users may be surprised by the change, but not
    harmed by it.
    
    The default value is changed, and the documentation is reworded to
    mention "color.ui=false" first, since the primary use of color.ui after
    this change is to disable colors, not to enable it.
    
    Signed-off-by: default avatarMatthieu Moy <Matthieu.Moy@imag.fr>
    Signed-off-by: default avatarJunio C Hamano <gitster@pobox.com>
    4c7f1819