Message ID | 1589681624-36969-3-git-send-email-keni@hers.com (mailing list archive) |
---|---|
State | New, archived |
Headers | show |
Series | None | expand |
Kenneth Lorber <keni@hers.com> writes: > From: Kenneth Lorber <keni@his.com> > > The Hacking Git section of the user manual is the logical place to look > for information on extending Gut, so add a short section of links to > places where that information actually lives. > > Signed-off-by: Kenneth Lorber <keni@his.com> > --- > Documentation/user-manual.txt | 8 ++++++++ > 1 file changed, 8 insertions(+) > > diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt > index 833652983f..2144246444 100644 > --- a/Documentation/user-manual.txt > +++ b/Documentation/user-manual.txt > @@ -4049,6 +4049,14 @@ and that is what higher level `git merge -s resolve` is implemented with. > This chapter covers internal details of the Git implementation which > probably only Git developers need to understand. > > +If you are extending Git using hooks, writing new tools, or otherwise > +looking for technical information but not hacking Git itself, the following > +documents may be what you are really looking for: > + > +* hooks: linkgit:githooks[5] > +* attributes: linkgit:gitattributes[5] > +* new tools: linkgit:git-sh-setup[1] I am not sure if this fits here. It is a distraction to the target audience of this section, no?
> On May 17, 2020, at 2:34 PM, Junio C Hamano <gitster@pobox.com> wrote: > > Kenneth Lorber <keni@hers.com> writes: > >> From: Kenneth Lorber <keni@his.com> >> >> The Hacking Git section of the user manual is the logical place to look >> for information on extending Gut, so add a short section of links to >> places where that information actually lives. >> >> Signed-off-by: Kenneth Lorber <keni@his.com> >> --- >> Documentation/user-manual.txt | 8 ++++++++ >> 1 file changed, 8 insertions(+) >> >> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt >> index 833652983f..2144246444 100644 >> --- a/Documentation/user-manual.txt >> +++ b/Documentation/user-manual.txt >> @@ -4049,6 +4049,14 @@ and that is what higher level `git merge -s resolve` is implemented with. >> This chapter covers internal details of the Git implementation which >> probably only Git developers need to understand. >> >> +If you are extending Git using hooks, writing new tools, or otherwise >> +looking for technical information but not hacking Git itself, the following >> +documents may be what you are really looking for: >> + >> +* hooks: linkgit:githooks[5] >> +* attributes: linkgit:gitattributes[5] >> +* new tools: linkgit:git-sh-setup[1] > > I am not sure if this fits here. It is a distraction to the target > audience of this section, no? I agree and still think this is where it goes (unless we start a new chapter on hacking FOR git, which is more than I can handle at the moment). My reasoning is that from the available chapters, this is my best bet (as a new user) for finding this information; pointing them elsewhere isn't that big a distraction (it's at the top and short) and would be a great help for people looking for that kind of info. My two cents anyway.
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index 833652983f..2144246444 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -4049,6 +4049,14 @@ and that is what higher level `git merge -s resolve` is implemented with. This chapter covers internal details of the Git implementation which probably only Git developers need to understand. +If you are extending Git using hooks, writing new tools, or otherwise +looking for technical information but not hacking Git itself, the following +documents may be what you are really looking for: + +* hooks: linkgit:githooks[5] +* attributes: linkgit:gitattributes[5] +* new tools: linkgit:git-sh-setup[1] + [[object-details]] === Object storage format