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

[PATCH 3/3] git-describe.1: clarify that "human readable" is also git-readable

From
FEFrederick Eaton <frederik@ofb.net>
Date
Sep 19, 2018, 20:12 UTC
Message-ID
<20180919201231.609-4-frederik@ofb.net>
In-Reply-To
<20180919201231.609-1-frederik@ofb.net>

The caption uses the term "human readable", but the DESCRIPTION did not explain this in context.

Signed-off-by: Frederick Eaton <frederik@ofb.net>
---
 Documentation/git-describe.txt | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/Documentation/git-describe.txt b/Documentation/git-describe.txt
index e027fb8c4..ccdc5f83d 100644
--- a/Documentation/git-describe.txt
+++ b/Documentation/git-describe.txt
@@ -18,7 +18,9 @@ The command finds the most recent tag that is reachable from a
 commit.  If the tag points to the commit, then only the tag is
 shown.  Otherwise, it suffixes the tag name with the number of
 additional commits on top of the tagged object and the
-abbreviated object name of the most recent commit.
+abbreviated object name of the most recent commit. The result
+is a "human-readable" object name which can also be used to
+identify the commit to other git commands.
 
 By default (without --all or --tags) `git describe` only shows
 annotated tags.  For more information about creating annotated tags
-- 
2.19.0
Previous: frederik@ofb.netNext: Frederick Eaton
Message 5 of 15 in “some documentation changes from the beginning of the alphabet”
  1. 0/3 some documentation changes from the beginning of the alphabetFrederick Eaton, Sep 19, 2018
  2. 1/3 git-archimport.1: specify what kind of Arch we're talking aboutFrederick Eaton, Sep 19, 2018
  3. Junio C HamanoSep 19, 2018
  4. frederik@ofb.netSep 19, 2018
  5. 3/3 git-describe.1: clarify that "human readable" is also git-readableFrederick Eaton, Sep 19, 2018
  6. 2/3 git-column.1: clarify initial description, provide examplesFrederick Eaton, Sep 19, 2018
  7. Junio C HamanoSep 19, 2018
  8. Duy NguyenSep 20, 2018
  9. frederik@ofb.netSep 20, 2018
  10. Eric SunshineSep 21, 2018
  11. Junio C HamanoSep 21, 2018
  12. frederik@ofb.netSep 21, 2018
  13. Junio C HamanoSep 19, 2018
  14. Eric SunshineSep 21, 2018
  15. frederik@ofb.netSep 21, 2018

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.