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

[PATCH] Documentation: document the pager.* configuration setting

From
Miklos Vajna <vmiklos@frugalware.org>
Date
Aug 16, 2008, 13:38 UTC
Message-ID
<1218893893-11242-1-git-send-email-vmiklos@frugalware.org>
In-Reply-To
<7v63q1lkbj.fsf@gitster.siamese.dyndns.org>

It was already documented in RelNotes-1.6.0, but not in the git-config manual page.

Signed-off-by: Miklos Vajna <vmiklos@frugalware.org>
---
On Fri, Aug 15, 2008 at 08:17:52PM -0700, Junio C Hamano <gitster@pobox.com> wrote:
Show 6 quoted lines
> > Ugh, I just noticed that the example was wrong, because paging for
> > status is disabled by default. Here is a corrected version.
>
> Honestly, I do not think the distinction between your two versions
> matter.
> Do we need a new example there?

That is a frequently asked question on #git (in the past, people asked how to disable it, now they ask how to enable it), so I thought an example can be helpful. Also Jeff provided such an example in the commit message of 4e10738.

If you think it's unnecessary, then just remove that hunk.
> The patch to Documentation/config.txt looks Ok, but I do not think you
> need to say "allows to set your preference".  "Sets your preference"
> would
> be enough.

Fixed. I also noticed that above the documentation uses "Specify" and not "Specifies" in such a case, so I dropped the "s" here as well.

 Documentation/config.txt     |    5 +++++
 Documentation/git-config.txt |    6 ++++++
 2 files changed, 11 insertions(+), 0 deletions(-)
diff --git a/Documentation/config.txt b/Documentation/config.txt
index b8ec01c..dc70ba6 100644
--- a/Documentation/config.txt
+++ b/Documentation/config.txt
@@ -978,6 +978,11 @@ pack.packSizeLimit::
 	can be overridden by the `\--max-pack-size` option of
 	linkgit:git-repack[1].
 
+pager.<cmd>::
+	Set your pager preference for each command, overriding the default. If
+	`\--pager` or `\--no-pager` is specified on the command line, it takes
+	precedence over this option.
+
 pull.octopus::
 	The default merge strategy to use when pulling multiple branches
 	at once.
diff --git a/Documentation/git-config.txt b/Documentation/git-config.txt
index 28e1861..c0bc6fa 100644
--- a/Documentation/git-config.txt
+++ b/Documentation/git-config.txt
@@ -315,6 +315,12 @@ RESET=$(git config --get-color "" "reset")
 echo "${WS}your whitespace color or blue reverse${RESET}"
 ------------
 
+To enable the pager for linkgit:git-status[1]:
+
+------------
+% git config pager.status true
+------------
+
 include::config.txt[]
 
 
-- 
1.6.0.rc0.14.g95f8.dirty
Previous: Junio C HamanoNext: Miklos Vajna
Message 4 of 5 in “Documentation: document the pager.* configuration setting”
  1. Documentation: document the pager.* configuration settingMiklos Vajna, Aug 16, 2008
  2. Documentation: document the pager.* configuration settingMiklos Vajna, Aug 16, 2008
  3. Junio C HamanoAug 16, 2008
  4. Documentation: document the pager.* configuration settingMiklos Vajna, Aug 16, 2008
  5. Miklos VajnaAug 16, 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.