{"thread":{"id":"2366","subject":"Documentation Directions","startedAt":"2005-11-06T17:35:14Z","lastAt":"2005-11-06T22:03:48Z","messageCount":3,"participants":["Jon Loeliger","Junio C Hamano","Nikolai Weibull"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"11209","messageId":"E1EYoQE-0002QX-VM@jdl.com","threadId":"2366","inReplyTo":null,"subject":"Documentation Directions","fromName":"Jon Loeliger","fromEmail":"jdl@freescale.com","sentAt":"2005-11-06T17:35:14Z","receivedAt":"2005-11-06T17:35:14Z","isPatch":false,"sender":{"key":"jdl@jdl.com","avatar":"https://gravatar.com/avatar/75ce9a10b151acd2c28ec4ab2136dba7b2ff1634530bd04b155981a749d08a64?d=mp&s=160"},"body":"Couple of questions regarding documentation direction:\n\n- Is the plan to update all docs to use $GIT_DIR instead of .git?\n\n- Do we intend on adding explicit support for '--help' on most,\n  if not all, of the git commands?  In some cases (git-branch)\n  a -*) case tacitly catches --help and usage()'s it.  In other\n  cases (git-pull) this can't be done as -*) passes options\n  on to git-fetch.  I think that we should catch --help directly\n  so that it doesn't emit git-fetch's *) catch-all usage:\n\n    % git pull --help\n    usage: git-fetch-pack [-q] [-v] [--exec=upload-pack] [host:]directory <refs>...\n    Fetch failure: --help\n\n- Do you want to head in the per-man-page-\"Now What?\" direction\n  as suggested by Junio?\n\nThanks,\njdl\n"},{"id":"11216","messageId":"7vek5ty1su.fsf@assigned-by-dhcp.cox.net","threadId":"2366","inReplyTo":"E1EYoQE-0002QX-VM@jdl.com","subject":"Re: Documentation Directions","fromName":"Junio C Hamano","fromEmail":"junkio@cox.net","sentAt":"2005-11-06T20:11:13Z","receivedAt":"2005-11-06T20:11:13Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Jon Loeliger <jdl@freescale.com> writes:\n\n> Couple of questions regarding documentation direction:\n>\n> - Is the plan to update all docs to use $GIT_DIR instead of .git?\n\nI personally feel we should use less (not more) $GIT_DIR in the\ndocumentation and casual mention of things under .git/ directory\nshould say .git/ instead, with the understanding that the reader\nhave already learned that there is a way to override it if the\nuser chooses to do so.\n\n> - Do we intend on adding explicit support for '--help' on most,\n>   if not all, of the git commands?\n\nI think that would be very helpful.\n\n>     - Do you want to standardize on using a '$' prompt\n>       for all the example command executions samples?\n\nAh, I see you recently added a couple of Csh style '%' prompt.\nAlso I suspect that some examples in earlier tutorial do not\neven have any prompt.\n\nYou are right -- being consistent would be nice.\n"},{"id":"11221","messageId":"20051106220348.GA9036@puritan.petwork","threadId":"2366","inReplyTo":"E1EYoQE-0002QX-VM@jdl.com","subject":"Re: Documentation Directions","fromName":"Nikolai Weibull","fromEmail":"mailing-lists.git@rawuncut.elitemail.org","sentAt":"2005-11-06T22:03:48Z","receivedAt":"2005-11-06T22:03:48Z","isPatch":false,"sender":{"key":"mailing-lists.git@rawuncut.elitemail.org","avatar":null},"body":"Jon Loeliger wrote:\n\n> - Is the plan to update all docs to use $GIT_DIR instead of .git?\n\nWell, shouldn't we go all the way and use ${GIT_DIR:-.git} then?  :-)\n\n        nikolai\n\n-- \nNikolai Weibull: now available free of charge at http://bitwi.se/!\nBorn in Chicago, IL USA; currently residing in Gothenburg, Sweden.\nmain(){printf(&linux[\"\\021%six\\012\\0\"],(linux)[\"have\"]+\"fun\"-97);}\n"}]}