# [PATCH] Document RUN_SETUP_GENTLY

2 messages from 2014-04-29 to 2014-04-29. Participants: David Turner, Junio C Hamano.
Thread: https://gitlist.dev/t/36534

## David Turner, 2014-04-29 05:04

Subject: [PATCH] Document RUN_SETUP_GENTLY
Message-ID: <CAE+yK_nZ0tVbqvH00vqaAL2mUz4s6CQS5kCfGsayv-40b0yejQ@mail.gmail.com>
URL: https://gitlist.dev/e/CAE%2ByK_nZ0tVbqvH00vqaAL2mUz4s6CQS5kCfGsayv-40b0yejQ%40mail.gmail.com

```
Document RUN_SETUP_GENTLY

Signed-off-by: David Turner <dturner@twitter.com>
---
 Documentation/technical/api-builtin.txt | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Documentation/technical/api-builtin.txt
b/Documentation/technical/api-builtin.txt
index e3d6e7a..1bbeda2 100644
--- a/Documentation/technical/api-builtin.txt
+++ b/Documentation/technical/api-builtin.txt
@@ -28,6 +28,11 @@ where options is the bitwise-or of:
  in a subdirectory.  If there is no work tree, no chdir() is
  done.

+`RUN_SETUP_GENTLY`::
+
+ If there is a Git directory, chdir as per RUN_SETUP, otherwise,
+ don't create one and don't chdir.
+
 `USE_PAGER`::

  If the standard output is connected to a tty, spawn a pager and
--

```

## Junio C Hamano, 2014-04-29 18:25

Subject: Re: [PATCH] Document RUN_SETUP_GENTLY
Message-ID: <xmqq1twgkn6n.fsf@gitster.dls.corp.google.com>
URL: https://gitlist.dev/e/xmqq1twgkn6n.fsf%40gitster.dls.corp.google.com
In-Reply-To: <CAE+yK_nZ0tVbqvH00vqaAL2mUz4s6CQS5kCfGsayv-40b0yejQ@mail.gmail.com>

```
David Turner <dturner@twopensource.com> writes:

> Document RUN_SETUP_GENTLY
>
> Signed-off-by: David Turner <dturner@twitter.com>
> ---
>  Documentation/technical/api-builtin.txt | 5 +++++
>  1 file changed, 5 insertions(+)
>
> diff --git a/Documentation/technical/api-builtin.txt
> b/Documentation/technical/api-builtin.txt
> index e3d6e7a..1bbeda2 100644
> --- a/Documentation/technical/api-builtin.txt
> +++ b/Documentation/technical/api-builtin.txt
> @@ -28,6 +28,11 @@ where options is the bitwise-or of:
>   in a subdirectory.  If there is no work tree, no chdir() is
>   done.
>
> +`RUN_SETUP_GENTLY`::
> +
> + If there is a Git directory, chdir as per RUN_SETUP, otherwise,
> + don't create one and don't chdir.

I can understand "don't chdir" part, but where does "don't create"
come from?  Makes it sound as if non GENTLY version would create one
if there isn't there, but I am guessing that that is not what you
meant to say.

Puzzled.

```