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

Re: Parameter --color-words not documented for "git show"

From
MMaaartin <grajcar1@seznam.cz>
Date
Jan 21, 2011, 10:08 UTC
Message-ID
<4D395B15.2040406@seznam.cz>
In-Reply-To
<20110120233429.GB9442@sigill.intra.peff.net>
On 11-01-21 00:34, Jeff King wrote:
> On Fri, Jan 21, 2011 at 12:16:49AM +0100, Nicolas Sebrecht wrote:
Show 7 quoted lines
>   4. Do (3), but also list the all (or common) diff options in a succint
>      list without descriptions, and refer the user to git-diff(1). Then
>      they can grep if they like, and while they won't get the immediate
>      answer, they will get referred to the right place.
> 
> As you can probably guess, I favor option (4), though we already do (3)
> in some places.
I also favor (4), for the following reasons:
- sometimes you want to read the whole manpage, e.g., it's good for
beginners to get feeling what is it all about.
- repeated information makes the page too long and reading too boring.
- too long manpages may scare beginners.

Maybe there could be sort-of extended manpage, containing everything, but it would need some markup beyond the capabilities of a terminal (a grayed or collapsed area in html, or whatever). However, this could be a lot of additional work, and I don't claim it should be done, just an idea.

Previous: Jeff KingNext: Jeff King
Message 12 of 14 in “Parameter --color-words not documented for "git show"”
  1. Sebastian PippingJan 20, 2011
  2. Thomas RastJan 20, 2011
  3. Sebastian PippingJan 20, 2011
  4. Junio C HamanoJan 20, 2011
  5. Nicolas SebrechtJan 20, 2011
  6. Jeff KingJan 20, 2011
  7. Sebastian PippingJan 21, 2011
  8. Jeff KingJan 21, 2011
  9. Sebastian PippingJan 21, 2011
  10. Junio C HamanoJan 21, 2011
  11. Jeff KingJan 21, 2011
  12. MaaartinJan 21, 2011
  13. Jeff KingJan 21, 2011
  14. Jakub NarebskiJan 23, 2011

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.