"First-Time Git Setup" docs about .gitconfig are incorrect as of Git For Windows v2.24
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 2/5
- Thời gian dự kiến
- 1-3 giờ
- Mức phù hợp với người mới
- 68/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- git
- Lĩnh vực
- documentation
Hướng nghiên cứu
Mở trang Getting Started—First-Time Git Setup và tìm đoạn văn mô tả các đường dẫn .gitconfig trên Windows; sau đó tìm phần văn bản tương ứng trong mã nguồn Pro Git. Cập nhật phần này để phản ánh vị trí hiện tại của cấu hình hệ thống của Git for Windows, hoặc nêu rõ phạm vi áp dụng của đường dẫn dành cho phiên bản cũ, rồi xác minh rằng trang được tạo không còn đưa ra hướng dẫn lỗi thời.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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
.gitconfigfile in the$HOMEdirectory (C:\Users\$USERfor 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 atC:\Documents and Settings\All Users\Application Data\Git\configon Windows XP, and inC:\ProgramData\Git\configon Windows Vista and newer. This config file can only be changed bygit 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 --systemwork as expected, the location of the system config is nowC:\Program Files\Git\etc\gitconfig(no longer split betweenC:\Program Files\Git\mingw64\etc\gitconfigandC:\ProgramData\Git\config), and likewise the location of the system gitattributes is nowC:\Program Files\Git\etc\gitattributes(no longerC:\Program Files\Git\mingw64\etc\gitattributes). Any manual modifications toC:\ProgramData\Git\configneed to be ported manually.
Steps to reproduce:
- Go to https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup
- Read text :)
Expected behavior:
I think we could change this to say something like:
On Windows systems, Git looks for the global
.gitconfigfile 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\configon Windows XP, orC:\ProgramData\Git\configon Windows Vista and newer). This config file can only be changed bygit 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
.gitconfigfile 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
- Ngôn ngữ chính
- CSS
- Star
- 6.6k
- Fork
- 2.1k
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của progit/progit2
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
-
Semi-stale link for GitHosting Đang mởbug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
-
enhancement
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 82/100
-
enhancement
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 65/100
-
enhancement
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 62/100
Tất cả issue của progit/progit2
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
agilepathway/label-checker#640 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
BasedHardware/omi#15662 · 1 bình luận ·
-
documentation help wanted
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 90/100
-
Docs are out of date: README structure tree, "Make It Yours" pointer, CONTRIBUTING test notes Đang mởdocumentation good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 88/100
amponce/archive-movie-browser#167 ·
-
user-reported
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
Kong/developer.konghq.com#7316 ·