"First-Time Git Setup" docs about .gitconfig are incorrect as of Git For Windows v2.24

オープン 初心者向け
#1,717 コメント 4 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
68/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
停滞
技術スタック
git
領域
documentation

調査の方向性

Getting Started—First-Time Git Setup ページを開き、Windows の .gitconfig のパスを説明している段落を見つけます。次に、Pro Git のソースで対応するテキストを探します。Git for Windows の現在のシステム設定の場所を反映するように更新するか、古いバージョンのパスであることを明確に示し、生成されたページに古い案内が残っていないことを確認します。

索引モデルが issue の本文から書いたものです。

説明

bug
There's no existing/similar bug report.
  • I have searched the existing issues
This report is about a single actionable bug.
  • I'm reporting a single actionable bug
This report is about the ProGit book, version 2, English language.
  • This bug is not about a translation or old version
Bug covers book website/pdf
  • I confirm the bug is about the book as found on the website/pdf
Problem is present in the Pro Git book on the website?
  • This bug also affects the Pro Git book as published on the website.
Which version of the book is affected?

Source files

Describe the bug:

On this page, there is the following paragraph (emphasis mine):

On Windows systems, Git looks for the .gitconfig file in the $HOME directory (C:\Users\$USER for most people). It also still looks for [path]/etc/gitconfig, although it’s relative to the MSys root, which is wherever you decide to install Git on your Windows system when you run the installer. If you are using version 2.x or later of Git for Windows, there is also a system-level config file at C:\Documents and Settings\All Users\Application Data\Git\config on Windows XP, and in C:\ProgramData\Git\config on Windows Vista and newer. This config file can only be changed by git config -f <file> as an admin.

As of git-for-windows/git#2358, this is incorrect. As described in the release notes:

Note! As a consequence of making git config --system work as expected, the location of the system config is now C:\Program Files\Git\etc\gitconfig (no longer split between C:\Program Files\Git\mingw64\etc\gitconfig and C:\ProgramData\Git\config), and likewise the location of the system gitattributes is now C:\Program Files\Git\etc\gitattributes (no longer C:\Program Files\Git\mingw64\etc\gitattributes). Any manual modifications to C:\ProgramData\Git\config need to be ported manually.

Steps to reproduce:
  1. Go to https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup
  2. Read text :)
Expected behavior:

I think we could change this to say something like:

On Windows systems, Git looks for the global .gitconfig file in the %USERPROFILE% directory (C:\Users\%USERNAME% for most people). It also looks for the system config file at [path]/etc/gitconfig, where [path] is wherever Git was installed on your system. If you are using Git for Windows version between v2.0.0 and v2.23.0, there is also a secondary system-level config file at %PROGRAMDATA%\Git\config (C:\Documents and Settings\All Users\Application Data\Git\config on Windows XP, or C:\ProgramData\Git\config on Windows Vista and newer). This config file can only be changed by git config -f <file> as an admin.

Or we could simply ignore versions of GFW that are 2+ years old:

On Windows systems, Git looks for the global .gitconfig file in the %USERPROFILE% directory (C:\Users\%USERNAME% for most people). It also looks for the system config file at [path]/etc/gitconfig, where [path] is wherever Git was installed on your system.

Screenshots:

No response

Additional context:

No response

Device

No response

Operating system

No response

Browser/application + version

No response

主要言語
CSS
スター
6.6k
フォーク
2.1k
PR マージ指標
30日以内にマージされた PR はありません

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

progit/progit2 のほかの issue

progit/progit2 の issue をすべて見る

似ている issue

Documentation の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。