From: Junio C Hamano <gitster@pobox.com>
Date: Tue, 12 Feb 2008 03:07:39 GMT
Subject: Re: [PATCH] git clone -s documentation: force a new paragraph for the NOTE
Message-ID: <7v4pce7tz8.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <20080212001257.GG25954@genesis.frugalware.org>

Miklos Vajna <vmiklos@frugalware.org> writes:

> It should be loud and clear.
> ...
> diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt
> index 2341881..9758243 100644
> --- a/Documentation/git-clone.txt
> +++ b/Documentation/git-clone.txt
> @@ -62,12 +62,13 @@ OPTIONS
>  	.git/objects/info/alternates to share the objects
>  	with the source repository.  The resulting repository
>  	starts out without any object of its own.
> -	*NOTE*: this is a possibly dangerous operation; do *not* use
> -	it unless you understand what it does. If you clone your
> -	repository using this option, then delete branches in the
> -	source repository and then run linkgit:git-gc[1] using the
> -	'--prune' option in the source repository, it may remove
> -	objects which are referenced by the cloned repository.

The "Note" is already in bold and quite loud.  I am not sure if
this is worth it.