delta/git.git/Documentation/CodingGuidelines, branch sb/submodule-embed-gitdir github.com: git/git.git CodingGuidelines: formatting HEAD in documentation 2016-06-28T15:36:45+00:00 Matthieu Moy Matthieu.Moy@imag.fr 2016-06-28T11:40:14+00:00 57103dbf702557abefc7c8c4578145f9383d6e9d The current practice is: git/Documentation$ git grep "'HEAD'" | wc -l 24 git/Documentation$ git grep "\`HEAD\`" | wc -l 66 Let's adopt the majority as a guideline. Signed-off-by: Matthieu Moy <Matthieu.Moy@imag.fr> Signed-off-by: Junio C Hamano <gitster@pobox.com> 
The current practice is:

git/Documentation$ git grep "'HEAD'" | wc -l
24
git/Documentation$ git grep "\`HEAD\`" | wc -l
66

Let's adopt the majority as a guideline.

Signed-off-by: Matthieu Moy <Matthieu.Moy@imag.fr>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
doc: clearer rule about formatting literals 2016-06-08T19:04:37+00:00 Tom Russello tom.russello@grenoble-inp.org 2016-06-07T22:35:05+00:00 41f5b21f84b4d7db8e8c6edb34682c0f840ad8c8 Make the guideline text that we want for our documentation clearer. Signed-off-by: Tom Russello <tom.russello@grenoble-inp.org> Signed-off-by: Erwan Mathoniere <erwan.mathoniere@grenoble-inp.org> Signed-off-by: Samuel Groot <samuel.groot@grenoble-inp.org> Signed-off-by: Matthieu Moy <matthieu.moy@grenoble-inp.fr> Reviewed-by: Matthieu Moy <Matthieu.Moy@imag.fr> Signed-off-by: Junio C Hamano <gitster@pobox.com> 
Make the guideline text that we want for our documentation clearer.

Signed-off-by: Tom Russello <tom.russello@grenoble-inp.org>
Signed-off-by: Erwan Mathoniere <erwan.mathoniere@grenoble-inp.org>
Signed-off-by: Samuel Groot <samuel.groot@grenoble-inp.org>
Signed-off-by: Matthieu Moy <matthieu.moy@grenoble-inp.fr>
Reviewed-by: Matthieu Moy <Matthieu.Moy@imag.fr>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
add DEVELOPER makefile knob to check for acknowledged warnings 2016-02-25T20:49:45+00:00 Lars Schneider larsxschneider@gmail.com 2016-02-25T08:42:22+00:00 658df95a4adb825f0c8a5faea7b545da6d1d5003 We assume Git developers have a reasonably modern compiler and recommend them to enable the DEVELOPER makefile knob to ensure their patches are clear of all compiler warnings the Git core project cares about. Enable the DEVELOPER makefile knob in the Travis-CI build. Suggested-by: Jeff King <peff@peff.net> Signed-off-by: Lars Schneider <larsxschneider@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 
We assume Git developers have a reasonably modern compiler and recommend
them to enable the DEVELOPER makefile knob to ensure their patches are
clear of all compiler warnings the Git core project cares about.

Enable the DEVELOPER makefile knob in the Travis-CI build.

Suggested-by: Jeff King <peff@peff.net>
Signed-off-by: Lars Schneider <larsxschneider@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Merge branch 'jg/cguide-we-cannot-count' 2015-04-14T16:55:29+00:00 Junio C Hamano gitster@pobox.com 2015-04-14T16:55:29+00:00 638cbf5f0f0dba7df1ad487e45638342c9afb6a0 * jg/cguide-we-cannot-count: CodingGuidelines: update 'rough' rule count 
* jg/cguide-we-cannot-count:
  CodingGuidelines: update 'rough' rule count
CodingGuidelines: update 'rough' rule count 2015-04-14T16:50:31+00:00 Julian Gindi juliangindi@gmail.com 2015-04-13T12:54:14+00:00 6c3b2afe6f64d33c176a8d369793392d7659fd6f Changed inaccurate count of "rough rules" from three to the more generic 'a few'. Signed-off-by: Julian Gindi <juliangindi@gmail.com> Reviewed-by: Eric Sunshine <sunshine@sunshineco.com> Reviewed-by: Jonathan Nieder <jrnieder@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 
Changed inaccurate count of "rough rules" from three to the more
generic 'a few'.

Signed-off-by: Julian Gindi <juliangindi@gmail.com>
Reviewed-by: Eric Sunshine <sunshine@sunshineco.com>
Reviewed-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
*config.txt: stick to camelCase naming convention 2015-03-14T05:13:46+00:00 Nguyễn Thái Ngọc Duy pclouds@gmail.com 2015-03-11T20:32:45+00:00 da0005b8853137c91e44867d899910d5c7eb4425 This should improve readability. Compare "thislongname" and "thisLongName". The following keys are left in unchanged. We can decide what to do with them later. - am.keepcr - core.autocrlf .safecrlf .trustctime - diff.dirstat .noprefix - gitcvs.usecrlfattr - gui.blamehistoryctx .trustmtime - pull.twohead - receive.autogc - sendemail.signedoffbycc .smtpsslcertpath .suppresscc Helped-by: Eric Sunshine <sunshine@sunshineco.com> Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com> Signed-off-by: Eric Sunshine <sunshine@sunshineco.com> Signed-off-by: Junio C Hamano <gitster@pobox.com> 
This should improve readability. Compare "thislongname" and
"thisLongName". The following keys are left in unchanged. We can
decide what to do with them later.

 - am.keepcr
 - core.autocrlf .safecrlf .trustctime
 - diff.dirstat .noprefix
 - gitcvs.usecrlfattr
 - gui.blamehistoryctx .trustmtime
 - pull.twohead
 - receive.autogc
 - sendemail.signedoffbycc .smtpsslcertpath .suppresscc

Helped-by: Eric Sunshine <sunshine@sunshineco.com>
Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
Signed-off-by: Eric Sunshine <sunshine@sunshineco.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Merge branch 'jc/conf-var-doc' 2015-02-22T20:28:31+00:00 Junio C Hamano gitster@pobox.com 2015-02-22T20:28:31+00:00 9a9c1f1fdfb4e8bb253bfa27311e8a8ad82c8859 Longstanding configuration variable naming rules has been added to the documentation. * jc/conf-var-doc: CodingGuidelines: describe naming rules for configuration variables config.txt: mark deprecated variables more prominently config.txt: clarify that add.ignore-errors is deprecated 
Longstanding configuration variable naming rules has been added to
the documentation.

* jc/conf-var-doc:
  CodingGuidelines: describe naming rules for configuration variables
  config.txt: mark deprecated variables more prominently
  config.txt: clarify that add.ignore-errors is deprecated
Merge branch 'ah/usage-strings' 2015-02-11T21:44:20+00:00 Junio C Hamano gitster@pobox.com 2015-02-11T21:44:19+00:00 bb831db6774aaa733199360dc7af6f3ce375fc20 * ah/usage-strings: standardize usage info string format 
* ah/usage-strings:
  standardize usage info string format
Merge branch 'jc/coding-guidelines' 2015-02-11T21:37:42+00:00 Junio C Hamano gitster@pobox.com 2015-02-11T21:37:42+00:00 fcae987e946ff25e055b7cc5b5b9801d682a7baf * jc/coding-guidelines: CodingGuidelines: clarify C #include rules 
* jc/coding-guidelines:
  CodingGuidelines: clarify C #include rules
CodingGuidelines: describe naming rules for configuration variables 2015-02-02T19:28:55+00:00 Junio C Hamano gitster@pobox.com 2015-01-27T20:26:03+00:00 35840a3e789dd67528caefc146deb698bd6ac7a5 We may want to say something about command line option names in the new section as well, but for now, let's make sure everybody is clear on how to structure and name their configuration variables. The text for the rules are partly taken from the log message of Jonathan's 6b3020a2 (add: introduce add.ignoreerrors synonym for add.ignore-errors, 2010-12-01). Signed-off-by: Junio C Hamano <gitster@pobox.com> 
We may want to say something about command line option names in the
new section as well, but for now, let's make sure everybody is clear
on how to structure and name their configuration variables.

The text for the rules are partly taken from the log message of
Jonathan's 6b3020a2 (add: introduce add.ignoreerrors synonym for
add.ignore-errors, 2010-12-01).

Signed-off-by: Junio C Hamano <gitster@pobox.com>