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

[PATCH] Documentation: clarify pager.<cmd> configuration

From
Jonathan Nieder <jrnieder@uchicago.edu>
Date
Aug 24, 2008, 05:38 UTC
Message-ID
<Pine.GSO.4.62.0808240028450.28567@harper.uchicago.edu>
In-Reply-To
<Pine.GSO.4.62.0808240019050.28567@harper.uchicago.edu>

It was not obvious from the text that pager.<cmd> is a boolean setting.

While we're changing the description, make some other improvements: lest we forget and fret, clarify that -p and pager.<cmd> do not kick in when stdout is not a tty; point to related core.pager and GIT_PAGER settings; use renamed --paginate option.

Signed-off-by: Jonathan Nieder <jrnieder@uchicago.edu>
---
 This is not related to the core.pager documentation patch I just
 sent; it just caught my eye as I was reading over the file.
 Documentation/config.txt |    8 +++++---
 1 files changed, 5 insertions(+), 3 deletions(-)
diff --git a/Documentation/config.txt b/Documentation/config.txt
index 88638f7..b12e695 100644
--- a/Documentation/config.txt
+++ b/Documentation/config.txt
@@ -988,9 +988,11 @@ pack.packSizeLimit::
 	linkgit:git-repack[1].
 
 pager.<cmd>::
-	Allows to set your own pager preferences for each command, overriding
-	the default. If `\--pager` or `\--no-pager` is specified on the command
-	line, it takes precedence over this option.
+	Allows turning on or off pagination of the output of a
+	particular git subcommand when outputing to a tty.  If
+	`\--paginate` or `\--no-pager` is specified on the command line,
+	it takes precedence over this option.  To disable pagination for
+	all commands, set `core.pager` or 'GIT_PAGER' to "`cat`".
 
 pull.octopus::
 	The default merge strategy to use when pulling multiple branches
-- 
1.6.0.481.g9ef3
Previous: Jonathan NiederNext: Junio C Hamano
Message 7 of 8 in “Do not override LESS”
  1. Do not override LESSAnders Melchiorsen, Aug 22, 2008
  2. Junio C HamanoAug 23, 2008
  3. Anders MelchiorsenAug 23, 2008
  4. Junio C HamanoAug 23, 2008
  5. Anders MelchiorsenAug 23, 2008
  6. Jonathan NiederAug 24, 2008
  7. Documentation: clarify pager.<cmd> configurationJonathan Nieder, Aug 24, 2008
  8. Junio C HamanoAug 24, 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.