git-remote add: --no-tags/--tags which one is the default option

git-remote add: --no-tags/--tags which one is the default option

[Francis Moreau]

Hi,

git remote add has --no-tags/--tags option, but I can't find in the man
page which one is the default.

Could anybody tell me the default option ?

Thanks.

[PATCH] git-remote.txt: describe behavior without --tags and --no-tags

[Michael J Gruber]

Signed-off-by: Michael J Gruber <git@drmicha.warpmail.net>
---
 Documentation/git-remote.txt | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/Documentation/git-remote.txt b/Documentation/git-remote.txt
index a77607b..f3f6f0d 100644
--- a/Documentation/git-remote.txt
+++ b/Documentation/git-remote.txt
@@ -56,7 +56,10 @@ With `--tags` option, `git fetch <name>` imports every tag from the
 remote repository.
 +
 With `--no-tags` option, `git fetch <name>` does not import tags from
 the remote repository.
++
+By default, only tags on fetched branches are imported
+(see linkgit:git-fetch[1]).
 +
 With `-t <branch>` option, instead of the default glob
 refspec for the remote to track all branches under
-- 
2.3.1.303.g5174db1

Re: [PATCH] git-remote.txt: describe behavior without --tags and --no-tags

[Francis Moreau]

Hi,

On 03/02/2015 02:08 PM, Michael J Gruber wrote:
> Signed-off-by: Michael J Gruber <git@drmicha.warpmail.net>
> ---
>  Documentation/git-remote.txt | 5 ++++-
>  1 file changed, 4 insertions(+), 1 deletion(-)
> 
> diff --git a/Documentation/git-remote.txt b/Documentation/git-remote.txt
> index a77607b..f3f6f0d 100644
> --- a/Documentation/git-remote.txt
> +++ b/Documentation/git-remote.txt
> @@ -56,7 +56,10 @@ With `--tags` option, `git fetch <name>` imports every tag from the
>  remote repository.
>  +
>  With `--no-tags` option, `git fetch <name>` does not import tags from
>  the remote repository.
> ++
> +By default, only tags on fetched branches are imported
> +(see linkgit:git-fetch[1]).
>  +

So the default is neither --no-tags nor --tags ?

Thanks.

Re: [PATCH] git-remote.txt: describe behavior without --tags and --no-tags

[Michael J Gruber]

Francis Moreau venit, vidit, dixit 02.03.2015 14:36:
> Hi,
> 
> On 03/02/2015 02:08 PM, Michael J Gruber wrote:
>> Signed-off-by: Michael J Gruber <git@drmicha.warpmail.net>
>> ---
>>  Documentation/git-remote.txt | 5 ++++-
>>  1 file changed, 4 insertions(+), 1 deletion(-)
>>
>> diff --git a/Documentation/git-remote.txt b/Documentation/git-remote.txt
>> index a77607b..f3f6f0d 100644
>> --- a/Documentation/git-remote.txt
>> +++ b/Documentation/git-remote.txt
>> @@ -56,7 +56,10 @@ With `--tags` option, `git fetch <name>` imports every tag from the
>>  remote repository.
>>  +
>>  With `--no-tags` option, `git fetch <name>` does not import tags from
>>  the remote repository.
>> ++
>> +By default, only tags on fetched branches are imported
>> +(see linkgit:git-fetch[1]).
>>  +
> 
> So the default is neither --no-tags nor --tags ?
> 
> Thanks.
> 

By default, only tags on fetched branches are imported. That is: When
the fetch is done, all tags are imported that point to commits that are
reachable from refs that you are fetching, in short: "tags on fetched
branches". That is in between "none" (--no-tags) and "all" (--tags).

Michael

Re: [PATCH] git-remote.txt: describe behavior without --tags and --no-tags

[Francis Moreau]

On 03/02/2015 03:48 PM, Michael J Gruber wrote:
> Francis Moreau venit, vidit, dixit 02.03.2015 14:36:
>> Hi,
>>
>> On 03/02/2015 02:08 PM, Michael J Gruber wrote:
>>> Signed-off-by: Michael J Gruber <git@drmicha.warpmail.net>
>>> ---
>>>  Documentation/git-remote.txt | 5 ++++-
>>>  1 file changed, 4 insertions(+), 1 deletion(-)
>>>
>>> diff --git a/Documentation/git-remote.txt b/Documentation/git-remote.txt
>>> index a77607b..f3f6f0d 100644
>>> --- a/Documentation/git-remote.txt
>>> +++ b/Documentation/git-remote.txt
>>> @@ -56,7 +56,10 @@ With `--tags` option, `git fetch <name>` imports every tag from the
>>>  remote repository.
>>>  +
>>>  With `--no-tags` option, `git fetch <name>` does not import tags from
>>>  the remote repository.
>>> ++
>>> +By default, only tags on fetched branches are imported
>>> +(see linkgit:git-fetch[1]).
>>>  +
>>
>> So the default is neither --no-tags nor --tags ?
>>
>> Thanks.
>>
> 
> By default, only tags on fetched branches are imported. That is: When
> the fetch is done, all tags are imported that point to commits that are
> reachable from refs that you are fetching, in short: "tags on fetched
> branches". That is in between "none" (--no-tags) and "all" (--tags).
> 

just my 2 cents, I would find easier to read it like this:

-----
By default, only tags on fetched branches are imported. This can be
changed by the --tags and --no-tags options.

With `--tags` option, `git fetch <name>` imports every tag from the
remote repository (including not reachable tags from fetched refs).

With `--no-tags` option, `git fetch <name>` does not import tags from
the remote repository.
-----

Thanks.

Re: git-remote add: --no-tags/--tags which one is the default option

[Kevin Daudt]

On Mon, Mar 02, 2015 at 10:48:24AM +0100, Francis Moreau wrote:
> Hi,
> 
> git remote add has --no-tags/--tags option, but I can't find in the man
> page which one is the default.
> 
> Could anybody tell me the default option ?
> 


Neither is default. This option has three states, set, unset and
default:

- unset (--no-tags) doesn't fetch any tags at all
- default (no option passed) will fetch any tags that are reachable from the refs that are
  being fetch
- set (--tags) will fetch all tags, even if they aren't reachable.

These options can also be set with the remote.<name>.tagopt config
option, which takes values [--tags|--no-tags].

Kevin