From: Junio C Hamano <gitster@pobox•com>
To: "Torsten Bögershausen" <tboegi@web•de>
Cc: git@vger•kernel.org
Subject: Re: [PATCH] core.filemode may need manual action
Date: Thu, 16 Oct 2014 13:12:10 -0700 [thread overview]
Message-ID: <xmqq61fju63p.fsf@gitster.dls.corp.google.com> (raw)
In-Reply-To: <54401CAD.4090606@web.de> ("Torsten Bögershausen"'s message of "Thu, 16 Oct 2014 21:29:49 +0200")
Torsten Bögershausen <tboegi@web•de> writes:
> core.filemode is set automatically when a repo is created.
> But when a repo is exported via CIFS or cygwin is mixed with Git for Windows
> core.filemode may better be set manually to false.
> Update and improve the documentation.
>
> Helped-by: Junio C Hamano <gitster@pobox•com>
> Signed-off-by: Torsten Bögershausen <tboegi@web•de>
> ---
>
> Does this reflect the discussion via email ?
> Or is more tweaking needed ?
>
>
> Documentation/config.txt | 19 +++++++++++++++++--
> 1 file changed, 17 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/config.txt b/Documentation/config.txt
> index 4333636..b4fea43 100644
> --- a/Documentation/config.txt
> +++ b/Documentation/config.txt
> @@ -204,8 +204,23 @@ advice.*::
> --
>
> core.fileMode::
> - If false, the executable bit differences between the index and
> - the working tree are ignored; useful on broken filesystems like FAT.
> + Tells Git if the executable bit of files in the working tree
> + is to be honored.
> +
> + Some filesystems lose the executable bit when a file that is
> + marked as executable is checked out, or checks out an
> + non-executable file with executable bit on. "git init" and
> + "git clone" probe the filesystem to see if it records
> + executable bit correctly when they create a new repository
> + and this variable is automatically set as necessary.
> +
> + A repository, however, may be on a filesystem that records
> + the filemode correctly, and this variable is set to 'true'
> + when created, but later may be made accessible from another
> + environment that loses the filemode (e.g. exporting ext4 via
> + CIFS mount, visiting a Cygwin managed repository with
> + MsysGit). In such a case, it may be necessary to set this
> + variable to 'false'.
> See linkgit:git-update-index[1].
> +
> The default is true, except linkgit:git-clone[1] or linkgit:git-init[1]
I suspect that the above will not format very well. Hint: what is
the lone "+" line before "The default is true..." doing there?
Aside from "Is MsysGit the old name for Git for Windows"? raised by
others, I think it may be worthwhile to mention Eclipse, as that is
where the original (by the way, it would have been nice if you left
some pointer to the original discussion when saying "the discussion
via email"---it took me a while to recall what you are talking
about) from Hilco Wijbenga was about ([$gmane/257689]). So, perhaps
s/with MsysGit/with Eclipse or Git for Windows/; or something.
Other than that, I do not see anything wrong in there. Thanks.
As a separate topic, however, we may want to start thinking about
adding a cheat-sheet on platform-specific bits to our documentation.
The alphabetical listing of configuration variables we see here is a
very good way for people to go from variable names to what they do
(e.g. find a variable defined in configuration file of a neighbour
or be instructed to set a variable by project lead and want to learn
why setting the variable to the value is a good idea), but not a
good way to go in the other direction (e.g. have trouble running Git
on a filesystem that mangles filenames and want to find out if there
already is a way to work it around).
The cheat-sheet could be just a list of configuration and
environment variables e.g. "Those on Windows may want to check into
these settings".
[Reference]
$gmane/257689:
http://thread.gmane.org/gmane.comp.version-control.git/257558/focus=257689
prev parent reply other threads:[~2014-10-16 20:13 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-10-16 19:29 [PATCH] core.filemode may need manual action Torsten Bögershausen
2014-10-16 19:40 ` Thomas Braun
2014-10-16 19:47 ` Johannes Schindelin
2014-10-16 20:12 ` Junio C Hamano [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=xmqq61fju63p.fsf@gitster.dls.corp.google.com \
--to=gitster@pobox$(echo .)com \
--cc=git@vger$(echo .)kernel.org \
--cc=tboegi@web$(echo .)de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox