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

5 messages from 2008-08-16 to 2008-08-16. Participants: Miklos Vajna, Junio C Hamano.
Thread: https://gitlist.dev/t/15031

## Miklos Vajna, 2008-08-16 02:09

Subject: [PATCH] Documentation: document the pager.* configuration setting
Message-ID: <1218852584-10523-1-git-send-email-vmiklos@frugalware.org>
URL: https://gitlist.dev/e/1218852584-10523-1-git-send-email-vmiklos%40frugalware.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>
---
 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..676c39b 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>::
+	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.
+
 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..d869942 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 disable the pager for linkgit:git-status[1]:
+
+------------
+% git config pager.status false
+------------
+
 include::config.txt[]
 
 
-- 
1.6.0.rc0.14.g95f8.dirty

```

## Miklos Vajna, 2008-08-16 02:14

Subject: [PATCH] Documentation: document the pager.* configuration setting
Message-ID: <1218852873-10588-1-git-send-email-vmiklos@frugalware.org>
URL: https://gitlist.dev/e/1218852873-10588-1-git-send-email-vmiklos%40frugalware.org
In-Reply-To: <1218852584-10523-1-git-send-email-vmiklos@frugalware.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>
---

Ugh, I just noticed that the example was wrong, because paging for
status is disabled by default. Here is a corrected version.

 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..676c39b 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>::
+	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.
+
 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

```

## Junio C Hamano, 2008-08-16 03:17

Subject: Re: [PATCH] Documentation: document the pager.* configuration setting
Message-ID: <7v63q1lkbj.fsf@gitster.siamese.dyndns.org>
URL: https://gitlist.dev/e/7v63q1lkbj.fsf%40gitster.siamese.dyndns.org
In-Reply-To: <1218852873-10588-1-git-send-email-vmiklos@frugalware.org>

```
Miklos Vajna <vmiklos@frugalware.org> writes:

> 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>
> ---
>
> 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?

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.

```

## Miklos Vajna, 2008-08-16 13:38

Subject: [PATCH] Documentation: document the pager.* configuration setting
Message-ID: <1218893893-11242-1-git-send-email-vmiklos@frugalware.org>
URL: https://gitlist.dev/e/1218893893-11242-1-git-send-email-vmiklos%40frugalware.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:
> > 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

```

## Miklos Vajna, 2008-08-16 13:43

Subject: Re: [PATCH] Documentation: document the pager.* configuration setting
Message-ID: <20080816134313.GE18960@genesis.frugalware.org>
URL: https://gitlist.dev/e/20080816134313.GE18960%40genesis.frugalware.org
In-Reply-To: <1218893893-11242-1-git-send-email-vmiklos@frugalware.org>

```
On Sat, Aug 16, 2008 at 03:38:13PM +0200, Miklos Vajna <vmiklos@frugalware.org> wrote:
> Fixed.

Ah, nevermind. I forgot to pull before sending the patch and I did not
notice the version without the second hunk is already in master.

Sorry for the noise.

```
