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

Re: cherry picking changesets instead of commits

From
Junio C Hamano <gitster@pobox.com>
Date
May 28, 2008, 23:56 UTC
Message-ID
<7vbq2qrni6.fsf@gitster.siamese.dyndns.org>
In-Reply-To
<20080528224819.GA15252@sigill.intra.peff.net>
Jeff King <peff@peff.net> writes:
Show 23 quoted lines
> 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
 -----
Previous: Jeff KingNext: Jeff King
Message 10 of 13 in “cherry picking changesets instead of commits”
  1. Geoffrey IrvingMay 28, 2008
  2. Junio C HamanoMay 28, 2008
  3. Geoffrey IrvingMay 28, 2008
  4. Junio C HamanoMay 28, 2008
  5. Geoffrey IrvingMay 28, 2008
  6. Junio C HamanoMay 28, 2008
  7. Geoffrey IrvingMay 28, 2008
  8. Jeff KingMay 28, 2008
  9. Jeff KingMay 28, 2008
  10. Junio C HamanoMay 28, 2008
  11. Jeff KingMay 29, 2008
  12. Documentation: git-cherry uses git-patch-idJunio C Hamano, May 29, 2008
  13. Geoffrey IrvingMay 29, 2008

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.