git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 1/2] user-manual: Simplify the user configuration.

From
Junio C Hamano <gitster@pobox.com>
Date
Jan 25, 2009, 20:34 UTC
Message-ID
<7vvds3dszy.fsf@gitster.siamese.dyndns.org>
In-Reply-To
<94a0d4530901240604o5ae0d321h17dc6aabeefe9d53@mail.gmail.com>
Felipe Contreras <felipe.contreras@gmail.com> writes:
> It's much easier for everyone to just use git config --global than
> explain how create and edit the .gitconfig file. If this is explained
> it shouldn't be in the "Telling git your name" section.

I think it is Ok to have, and it probably is helpful to have, a document that accompanies the generic manual, "Platform supplement", to explain things like "On this platform, what is referred to as $HOME in the generic manual is implemented as %HOMEDRIVE%%HOMEPATH%", to cover peculiarities of each platform.

But I think it is going backwards to butcher the description in the main manual in order to make the platform supplement shorter. Even Windows is not a good enough reason to break the logical ordering of how things should be best taught to the readers of the manual, which is not specific to a platform.

Previous: Felipe ContrerasNext: Felipe Contreras
Message 19 of 25 in “user-manual: Simplify the user configuration.”
  1. 1/2 user-manual: Simplify the user configuration.Felipe Contreras, Jan 21, 2009
  2. 2/2 Fix typo.Felipe Contreras, Jan 21, 2009
  3. Markus HeidelbergJan 21, 2009
  4. user-manual: Simplify the user configuration.Felipe Contreras, Jan 21, 2009
  5. Jeff KingJan 21, 2009
  6. Felipe ContrerasJan 21, 2009
  7. Jeff KingJan 21, 2009
  8. Junio C HamanoJan 21, 2009
  9. Wincent ColaiutaJan 21, 2009
  10. Felipe ContrerasJan 21, 2009
  11. Hannu KoivistoJan 22, 2009
  12. Felipe ContrerasJan 22, 2009
  13. Junio C HamanoJan 22, 2009
  14. Johannes SchindelinJan 22, 2009
  15. Hannu KoivistoJan 22, 2009
  16. Felipe ContrerasJan 24, 2009
  17. Johannes SchindelinJan 24, 2009
  18. Felipe ContrerasJan 24, 2009
  19. Junio C HamanoJan 25, 2009
  20. Felipe ContrerasJan 25, 2009
  21. Jeff KingJan 25, 2009
  22. Wincent ColaiutaJan 25, 2009
  23. Jeff KingJan 25, 2009
  24. Kyle MoffettJan 25, 2009
  25. Johannes SchindelinJan 25, 2009

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.