From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS31976 209.132.180.0/23 X-Spam-Status: No, score=-4.1 required=3.0 tests=AWL,BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI, RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by dcvr.yhbt.net (Postfix) with ESMTP id 2D8621F466 for ; Mon, 27 Jan 2020 06:29:04 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726380AbgA0G3D (ORCPT ); Mon, 27 Jan 2020 01:29:03 -0500 Received: from bsmtp2.bon.at ([213.33.87.16]:45100 "EHLO bsmtp2.bon.at" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725763AbgA0G3D (ORCPT ); Mon, 27 Jan 2020 01:29:03 -0500 Received: from dx.site (unknown [93.83.142.38]) by bsmtp2.bon.at (Postfix) with ESMTPSA id 485fwD3197z5tl9; Mon, 27 Jan 2020 07:29:00 +0100 (CET) Received: from [IPv6:::1] (localhost [IPv6:::1]) by dx.site (Postfix) with ESMTP id 266D64184; Mon, 27 Jan 2020 07:28:59 +0100 (CET) Subject: Re: [PATCH v2] git: update documentation for --git-dir Cc: Heba Waly via GitGitGadget , git@vger.kernel.org References: To: Heba Waly From: Johannes Sixt Message-ID: Date: Mon, 27 Jan 2020 07:28:58 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.4.1 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Am 27.01.20 um 03:24 schrieb Heba Waly via GitGitGadget: > diff --git a/Documentation/git.txt b/Documentation/git.txt > index b1597ac002..cf73f501b6 100644 > --- a/Documentation/git.txt > +++ b/Documentation/git.txt > @@ -110,9 +110,23 @@ foo.bar= ...`) sets `foo.bar` to the empty string which `git config > Do not pipe Git output into a pager. > > --git-dir=:: > - Set the path to the repository. This can also be controlled by > - setting the `GIT_DIR` environment variable. It can be an absolute > - path or relative path to current working directory. > + Set the path to the repository (".git" directory). This can also be > + controlled by setting the `GIT_DIR` environment variable. It can be > + an absolute path or relative path to current working directory. > + > + Specifying the location of the ".git" directory using this > + option (or GIT_DIR environment variable) turns off the > + repository discovery that tries to find a directory with > + ".git" subdirectory (which is how the repository and the > + top-level of the working tree are discovered), and tells Git > + that you are at the top level of the working tree. If you > + are not at the top-level directory of the working tree, you > + should tell Git where the top-level of the working tree is, > + with the --work-tree= option (or GIT_WORK_TREE > + environment variable) > + > + If you just want to run git as if it was started in then use > + git -C. Does this render well? Judging by the precedent set by the descriptions of -C and -c options earlier in this file, continuation paragraphs should not be indented and separated by a line with just a plus sign instead of an empty line. -- Hannes