Re: cherry picking changesets instead of commits

[Junio C Hamano <gitster@pobox.com>]

Jeff King <peff@peff.net> writes:

> doc/git-gui: make gitk "see also" a link
>
> Even though git-gui and gitk are both maintained separately,
> the documentation is part of core git, and thus it makes
> sense to use the linkgit macro to create an href in the HTML
> documentation.
> ---
>  Documentation/git-gui.txt |    2 +-
>  1 files changed, 1 insertions(+), 1 deletions(-)
>
> diff --git a/Documentation/git-gui.txt b/Documentation/git-gui.txt
> index 6d6cd5d..cf2541f 100644
> --- a/Documentation/git-gui.txt
> +++ b/Documentation/git-gui.txt
> @@ -81,7 +81,7 @@ git gui browser maint::
>  
>  See Also
>  --------
> -'gitk(1)'::
> +linkgit:gitk[1]::
>  	The git repository browser.  Shows branches, commit history
>  	and file differences.  gitk is the utility started by
>  	git-gui's Repository Visualize actions.

Hmm.

First a bit offtopic to avoid duplicated work.  Please nobody waste your
time sending s/See Also/SEE ALSO/ clean-up patch.  I've done that already.

Now, I do not think it is customary to say anything but the name of the
manual page if you refer to one in SEE ALSO section.  I am wondering if we
would want to remove the three-liner for consistency (but haven't done so,
neither the short description of qgit and others in gitk manual page is
gone yet).

 Documentation/git-gui.txt |    7 ++-----
 1 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/Documentation/git-gui.txt b/Documentation/git-gui.txt
index 6d6cd5d..cea8f8a 100644
--- a/Documentation/git-gui.txt
+++ b/Documentation/git-gui.txt
@@ -79,12 +79,9 @@ git gui browser maint::
 	selected in the browser can be viewed with the internal
 	blame viewer.
 
-See Also
+SEE ALSO
 --------
-'gitk(1)'::
-	The git repository browser.  Shows branches, commit history
-	and file differences.  gitk is the utility started by
-	git-gui's Repository Visualize actions.
+linkgit:gitk[1]
 
 Other
 -----