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

Aperta Adatta ai principianti
#1,717 4 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
68/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Ferma
Stack tecnologico
git
Ambito
documentation

Direzione di ricerca

Apri la pagina Getting Started—First-Time Git Setup e individua il paragrafo che descrive i percorsi di .gitconfig su Windows; quindi trova il testo corrispondente nel codice sorgente di Pro Git. Aggiornalo in modo che rifletta la posizione attuale della configurazione di sistema di Git for Windows, oppure circoscrivi chiaramente il percorso relativo alla versione precedente, e verifica che la pagina generata non fornisca più indicazioni obsolete.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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

Lingua principale
CSS
Stelle
6.6k
Fork
2.1k
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di progit/progit2

Tutte le issue di progit/progit2

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.