From patchwork Sun Mar 10 19:10:25 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Jean-No=C3=ABl_Avila?= X-Patchwork-Id: 13588170 Received: from mail-wr1-f42.google.com (mail-wr1-f42.google.com [209.85.221.42]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id B0B4A39FC6 for ; Sun, 10 Mar 2024 19:10:34 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.42 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097836; cv=none; b=ae68J+tKuaCwOz1jKklWnSUOc3yR/HLKIb0hvMt0KPFIML54ct1yF7ZPHLJupz14ZL8SIu3LAXpXMDknpdpZBjUCE23fNYz+zRzSP/0ua9lMq2gGWpPCiLQ54dCw6hKUQxg8nYeZ47RC+6wLxKuXgLNHpq7b83USJX88zqszfeY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097836; c=relaxed/simple; bh=s8rsLfJ0It10V/qP3mN+GKVVFkpCsROWXbJxOt3hkOc=; h=Message-ID:In-Reply-To:References:From:Date:Subject:MIME-Version: Content-Type:To:Cc; b=l2aareehsjaGbJMbcdnO1aE6/Kd16LevffL1XGRuo/lQbAZIwb/wb9JJ9IPmhmr1am+4uRm5Q7HQfe95k+Sm9QlIDifL1Jw3Kz0aCXXQk8gVkHnfu0Z7PFZh06TOYmsuE25k2G82KfhJC31lcv7oyyUhLBEKZIv6JITgkBNdbCk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=lFVCxKNQ; arc=none smtp.client-ip=209.85.221.42 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="lFVCxKNQ" Received: by mail-wr1-f42.google.com with SMTP id ffacd0b85a97d-33e93514a6aso301150f8f.1 for ; Sun, 10 Mar 2024 12:10:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1710097832; x=1710702632; darn=vger.kernel.org; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:from:to:cc:subject:date :message-id:reply-to; bh=791zlujvpnIKZ7sWFnggdeQ38j2Ml+BtSpVAUgB3EpM=; b=lFVCxKNQkijEPTmBljKnEzX6cA9XB89ojp1PMVb1/Wp+iwEX57YLimXN+Gn/+ogH11 nUUsjsBgipIgqAwuWPNZQ2Cvq4gWXUSK8FnrN46JMrx0Hv0Y/lvI61Wg4Kr8Sl0n2PZl 8dRymlfH0hZkWTdybv89Q7rAvXEPZzaEpe7MA1eeKtN3/k8EY0QGxQ4rN7LuMAkpyr6D D0lJuAkdho0ry4DTJGOSHOcy3kpgxPUBW4VDZQL+TRTc1PMXGO/avg945MaPRk6D1CN1 qCccTSxgXVq7w8qFp8m0f8MnQWUIycOvQI6HSOxMgXlGaH1/h0Pi2CaTqLaTa+Y+LCWo Txrw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710097832; x=1710702632; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=791zlujvpnIKZ7sWFnggdeQ38j2Ml+BtSpVAUgB3EpM=; b=SOQBTTl3b4Gt+dn58DiDKEx/oAWHvOjrs6QZUViF2rANmAtPUxQvzxpd7dwtBIo3hK ulR6ffGYU7nb5Rm5cVpupBY5LucfOTSiB+xTMYYDNxlggP9eM6aYk4gwkoi2/RU/2sjs 1OD8qn5IQ5GINDDk4+3TCd4SdIYboEngBRyCFxl4AXctKhV1+n0bWloenoFUOT1hLCP1 mg3V3lIoNrW11ydhaRJ1DPaDJQ8iFHRmyrPoGe/34qsu0l/c323yhFYUn8IsefTs0NkB V7icSGUgY5UVS9Dxu6YnPYa9yF9nW4uEso/8ULIaH5eZSwNOktqpLXpa909atH+YjzNc 42VA== X-Gm-Message-State: AOJu0YxHDrCTdSMP9xM5sBRd3Oe0abOs2PoawF3GSK7KmxBXS4J1E1Lr v9of9I8s4IJq6Amg0Ijl+c3g2Vq5b9HHIsEdcR96RUWDO5iLpi4BDJukl95M X-Google-Smtp-Source: AGHT+IFHQBg0N3wvP1lI80V5LQf2R6a2kbk8llxg7ObwuzlW73OTW7pL1zUypFxYuMpTlz9v03F3xw== X-Received: by 2002:adf:fc46:0:b0:33e:745a:d98e with SMTP id e6-20020adffc46000000b0033e745ad98emr3200525wrs.23.1710097832056; Sun, 10 Mar 2024 12:10:32 -0700 (PDT) Received: from [127.0.0.1] ([13.74.141.28]) by smtp.gmail.com with ESMTPSA id y9-20020a056000108900b0033e206a0a7asm4557560wrw.26.2024.03.10.12.10.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 10 Mar 2024 12:10:31 -0700 (PDT) Message-ID: <908b45b8a4c3ac7e1846e9cf323bb4ace7140dc1.1710097830.git.gitgitgadget@gmail.com> In-Reply-To: References: Date: Sun, 10 Mar 2024 19:10:25 +0000 Subject: [PATCH 1/6] doc: git-init: format verbatim parts Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Fcc: Sent To: git@vger.kernel.org Cc: =?utf-8?q?Jean-No=C3=ABl?= Avila , =?utf-8?q?Jean-No?= =?utf-8?q?=C3=ABl_Avila?= From: =?utf-8?q?Jean-No=C3=ABl_Avila?= From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= Verbatim parts are all formatted as `fixed font`. Signed-off-by: Jean-Noël Avila --- Documentation/git-init.txt | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt index e8dc645bb59..7ff7d8e7ee0 100644 --- a/Documentation/git-init.txt +++ b/Documentation/git-init.txt @@ -33,10 +33,10 @@ If the object storage directory is specified via the are created underneath; otherwise, the default `$GIT_DIR/objects` directory is used. -Running 'git init' in an existing repository is safe. It will not +Running `git init` in an existing repository is safe. It will not overwrite things that are already there. The primary reason for -rerunning 'git init' is to pick up newly added templates (or to move -the repository to another place if --separate-git-dir is given). +rerunning `git init` is to pick up newly added templates (or to move +the repository to another place if `--separate-git-dir` is given). OPTIONS ------- @@ -53,8 +53,8 @@ current working directory. --object-format=:: -Specify the given object format (hash algorithm) for the repository. The valid -values are 'sha1' and (if enabled) 'sha256'. 'sha1' is the default. +Specify the given object __ (hash algorithm) for the repository. The valid +values are `sha1` and (if enabled) `sha256`. `sha1` is the default. + include::object-format-disclaimer.txt[] @@ -90,12 +90,12 @@ customized via the `init.defaultBranch` configuration variable). Specify that the Git repository is to be shared amongst several users. This allows users belonging to the same group to push into that -repository. When specified, the config variable "core.sharedRepository" is +repository. When specified, the config variable `core.sharedRepository` is set so that files and directories under `$GIT_DIR` are created with the requested permissions. When not specified, Git will use permissions reported -by umask(2). +by `umask(2)`. + -The option can have the following values, defaulting to 'group' if no value +The option can have the following values, defaulting to `group` if no value is given: + -- @@ -109,21 +109,21 @@ specified. Make the repository group-writable, (and g+sx, since the git group may not be the primary group of all users). This is used to loosen the permissions of an otherwise safe umask(2) value. Note that the umask still applies to the other -permission bits (e.g. if umask is '0022', using 'group' will not remove read -privileges from other (non-group) users). See '0xxx' for how to exactly specify +permission bits (e.g. if umask is `0022`, using `group` will not remove read +privileges from other (non-group) users). See `0xxx` for how to exactly specify the repository permissions. 'all' (or 'world' or 'everybody'):: -Same as 'group', but make the repository readable by all users. +Same as `group`, but make the repository readable by all users. '':: '' is a 3-digit octal number prefixed with `0` and each file -will have mode ''. '' will override users' umask(2) -value (and not only loosen permissions as 'group' and 'all' -do). '0640' will create a repository which is group-readable, but -not group-writable or accessible to others. '0660' will create a repo +will have mode ''. '' will override users'`umask(2)` +value (and not only loosen permissions as `group` and `all` +do). `0640` will create a repository which is group-readable, but +not group-writable or accessible to others. `0660` will create a repo that is readable and writable to the current user and group, but inaccessible to others (directories and executable files get their `x` bit from the `r` bit for corresponding classes of users). @@ -172,7 +172,7 @@ $ git add . <2> $ git commit <3> ---------------- + -<1> Create a /path/to/my/codebase/.git directory. +<1> Create a `/path/to/my/codebase/.git` directory. <2> Add all existing files to the index. <3> Record the pristine state as the first commit in the history. From patchwork Sun Mar 10 19:10:26 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Jean-No=C3=ABl_Avila?= X-Patchwork-Id: 13588171 Received: from mail-wm1-f51.google.com (mail-wm1-f51.google.com [209.85.128.51]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E4EFA39FC5 for ; Sun, 10 Mar 2024 19:10:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.51 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097837; cv=none; b=q90WyAnVfyAY8M0u6rB7hYtv6XXku/cDI67E+bEzviZHS4up7k4LKyjjxrW8wB4anJRXrPCPmHig5DSauP6npuy9AZ2VfgCYrKNpv+cYh7EbIRaNV+UFMbuvTtLrlue6Re1zn5oeSJBWUZzGZ16cVoP6DSPaWz3Iu72LvJwdYZU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097837; c=relaxed/simple; bh=KidVfI2IkhVGVmsFjX0KdeWxickZi9XilN8IgcX6gg8=; h=Message-ID:In-Reply-To:References:From:Date:Subject:MIME-Version: Content-Type:To:Cc; b=KH93FSBD3UEYJ6cKeGdyYqE8c4pQY+4p9uuKdNblNfmzPCe9e4jp3xymQDeR5Eg/tCX4UENdXwHaa/uwmk3UBSJor/hzGbReLaZDqXJjb7LwKDW9o1i/l/09McMEWUyLHZNapBiwVfBuJ1X5EITH3DrZmlFfQH+VfhIIp0r1mMg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=HYltzYcM; arc=none smtp.client-ip=209.85.128.51 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="HYltzYcM" Received: by mail-wm1-f51.google.com with SMTP id 5b1f17b1804b1-4132ab0eea9so489105e9.1 for ; Sun, 10 Mar 2024 12:10:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1710097834; x=1710702634; darn=vger.kernel.org; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:from:to:cc:subject:date :message-id:reply-to; bh=s20xuP5bGQ37kPqFLC2kcQ3WEp9FWkSn9bpExYJE0IE=; b=HYltzYcMocs0KrvCiQ4ckHYxdfPQHtpA6XlIMWcMrocqJ1AqoNr5pTvBlTwDvj/hjN 4cL/G/Wvl+gpRrMAjTnSxA161x/+xdvpIycPI1Y3rRVECqQ65TeSSaOGQGHcV88dAbVS EwXephXeheW1RCnGd9xK3tCKqUfw20AudZ4NZ8t0VlJp2xgdHxQTn2sO3SQAem6AnjeH 7IrTW4gYFs0zM7M+rihGM50kbKrn8RY9D3mEe9kAl0sA758zrAr6k52Oi+BmAfTD0gaU P0sFlSMZvx7flU0Sh19bw+gzFRAYAuqAYKkqj/DazWfv4RB+QKaaC3uCdq1lrmPCO3dw gsCw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710097834; x=1710702634; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=s20xuP5bGQ37kPqFLC2kcQ3WEp9FWkSn9bpExYJE0IE=; b=IshG1eQDsLnKgGGvVySBUdU5K3WI3e6OzORl9dqMZWGVUkTK98S2p/mUZY7grbsudB hti+bX59IB2lOWBIvb/Cz/ns8iW/hMWrbjsn8lp4lcPhPu7LfvWZRqwgDyEYv+d5hlpS wRiAuzAUbT+6F1c22nnULsDSp+0M8H8678lHDqw3eWOg2MwUrdcmFthjMz75LBER5ALp 4eNM/Hx6Q5ZugTvoxWLFAeEAPsJUMF5rTNi79Cl9TEDZeM4UIu/t7D2VGHwsfuHn4JPp glnpbU2iIMlezeCYPBzcmuaMsqtOumSFUNAdBUy3Ux9oxplQo4s5XOR6JfHTRqNVgrdX qM1g== X-Gm-Message-State: AOJu0YwKzWjK4HNILuvfzSURfj96ApRAjDPfyAuCYlQYHt8xP5Fi5BZ3 SgkS0Ttu0E2UT4LQYIKl1raCfxfSu4R2XJQGm4Ww0CgbzVW3Hz9207EdPK8J X-Google-Smtp-Source: AGHT+IEddbfei5SEe+XT9LT1inWp4N81MQWUKZlA4fJSdKHMO831cLqCppO0DDNH5sfjY0jkcGr46A== X-Received: by 2002:a05:600c:4fd4:b0:413:16c3:b99f with SMTP id o20-20020a05600c4fd400b0041316c3b99fmr3653600wmq.16.1710097833595; Sun, 10 Mar 2024 12:10:33 -0700 (PDT) Received: from [127.0.0.1] ([13.74.141.28]) by smtp.gmail.com with ESMTPSA id q14-20020a05600c46ce00b00412b4dca795sm6552319wmo.7.2024.03.10.12.10.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 10 Mar 2024 12:10:32 -0700 (PDT) Message-ID: In-Reply-To: References: Date: Sun, 10 Mar 2024 19:10:26 +0000 Subject: [PATCH 2/6] doc: git-init: format placeholders Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Fcc: Sent To: git@vger.kernel.org Cc: =?utf-8?q?Jean-No=C3=ABl?= Avila , =?utf-8?q?Jean-No?= =?utf-8?q?=C3=ABl_Avila?= From: =?utf-8?q?Jean-No=C3=ABl_Avila?= From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= With the new doc format conventions, we use __. Signed-off-by: Jean-Noël Avila --- Documentation/git-init.txt | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt index 7ff7d8e7ee0..e8fe72861dc 100644 --- a/Documentation/git-init.txt +++ b/Documentation/git-init.txt @@ -60,7 +60,7 @@ include::object-format-disclaimer.txt[] --ref-format=:: -Specify the given ref storage format for the repository. The valid values are: +Specify the given ref storage __ for the repository. The valid values are: + include::ref-storage-format.txt[] @@ -81,7 +81,7 @@ If this is a reinitialization, the repository will be moved to the specified pat -b :: --initial-branch=:: -Use the specified name for the initial branch in the newly created +Use __ for the initial branch in the newly created repository. If not specified, fall back to the default name (currently `master`, but this is subject to change in the future; the name can be customized via the `init.defaultBranch` configuration variable). @@ -119,8 +119,8 @@ Same as `group`, but make the repository readable by all users. '':: -'' is a 3-digit octal number prefixed with `0` and each file -will have mode ''. '' will override users'`umask(2)` +__ is a 3-digit octal number prefixed with `0` and each file +will have mode __. __ will override users'`umask(2)` value (and not only loosen permissions as `group` and `all` do). `0640` will create a repository which is group-readable, but not group-writable or accessible to others. `0660` will create a repo @@ -133,7 +133,7 @@ By default, the configuration flag `receive.denyNonFastForwards` is enabled in shared repositories, so that you cannot force a non fast-forwarding push into it. -If you provide a 'directory', the command is run inside it. If this directory +If you provide a __, the command is run inside it. If this directory does not exist, it will be created. TEMPLATE DIRECTORY From patchwork Sun Mar 10 19:10:27 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Jean-No=C3=ABl_Avila?= X-Patchwork-Id: 13588172 Received: from mail-wr1-f45.google.com (mail-wr1-f45.google.com [209.85.221.45]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 16E3939FF2 for ; Sun, 10 Mar 2024 19:10:36 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.45 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097838; cv=none; b=U4flyXjUR35XghO0kT2w3JnRKsg+QoCah7BaV5KVwaVnd+0xNSR8N+tFLyEFkJszu1NJwOU2ej/7LXAcxSeYClcWWLpoKIxZ9K2Q+Tq7OuPVYCHbp/SIv8BuwYZSFVKL6bfGYk9ju8QubBIwdVThjsSPPr79LWHS+VoOVpO2p2o= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097838; c=relaxed/simple; bh=90HxWsU2BCP2rylwHkJyP+rYOqNK+yV8Ax7EpdcgPiY=; h=Message-ID:In-Reply-To:References:From:Date:Subject:MIME-Version: Content-Type:To:Cc; b=Jlhjvq2y0Iw8eBcApw7+4D9MB+I0n0DgLbJRNMibpKaK96vVHCzGfuQtcOMeYtb0L+femxzAAxc/L2TOCPU4K67fg7gKlhWxb2Olj8hb2Zf5IVPk4//0dCJ+SjvDROP0gxrU7eH2Qjcvb81PI55VQ4J971cs6anX/rL/7La904I= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=lwC2mZJQ; arc=none smtp.client-ip=209.85.221.45 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="lwC2mZJQ" Received: by mail-wr1-f45.google.com with SMTP id ffacd0b85a97d-33e82c720f8so2014446f8f.3 for ; Sun, 10 Mar 2024 12:10:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1710097835; x=1710702635; darn=vger.kernel.org; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:from:to:cc:subject:date :message-id:reply-to; bh=FiIezj2K0kuo+pWkujXGrWNl0hgKlSlWfUI73N+JpvE=; b=lwC2mZJQvGd4cDcU6jN0VPRbuyDEnevPdQO9lTPjLf5U9ptpn9RmobBEldCtXjJuBw JRav1+hkviCFy82qz5xeu5LmyKjiL2/AoTE05OrUr7wFLoA49rrHATu/rbFgM2Tmqw4I gXuIt92fLyb7pFYya6nCYTMxeQeo9ggi/uGOefOVZTl0R6dOJ4yV1Y47A23DuYcKfYAQ CNt3qWOhM8EyZ1A+g5RHic9ZwPD+VDinmOWy8dbWy4jsBFvBsiZqLGo0TNPIXNSWAN7O pazCvaH+Y1AmK+rGlndBMG7WdPXip80/Td24ufCA7rPgTO4dLPFJDk3F8PMDCkwZ0c9G ip7Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710097835; x=1710702635; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=FiIezj2K0kuo+pWkujXGrWNl0hgKlSlWfUI73N+JpvE=; b=vxGLR83O6s/jeLR33OdWq85HxgK2HaFwbbkXELY0Xg3wnTi0GANvARkhXbASPeWm8R oKK8K1eyrDGQuKyIbhH3xDySSFDetz+ZK4GouRvjKfTqbOMCyy+1qFcrE2K632TljxLj R/xur31t3laBAbV17Q9rdf5WfBlJrXPzUUkxWsYzvOSyfoS0Gl9BDWKBDLz6F8MB9rve f3s8ieKmlkFhSZ+Ymv1X1J1P7vD4szPoQ+CY+3vBJDH/rx3pT8am6oWKT5BUGGy+iwB9 jf1ISQ2A/Qbubo0IBzzztCd7LE9KL+gveO71B3eBQLe+VY024DM9JYTZhogtX2QHYNOw 1oZw== X-Gm-Message-State: AOJu0Yxfl0/vsbuKvElL+eSS+BoEzfYjxTDuMjxk/sHCTtMdhKJDqcBN HQM4Tf4QvUMAVPRkfPuR5waV9h5BqhQsgY2u+oMXSojnuwTPiGLypEE70tI+ X-Google-Smtp-Source: AGHT+IGGlrONgWBBsNrFz+K+JKGvOeTXDIx3k/LXjyFRVVdiQnziK6fLOlsW/J3Sfr9I2suREltVUQ== X-Received: by 2002:adf:e483:0:b0:33e:67c7:e2c0 with SMTP id i3-20020adfe483000000b0033e67c7e2c0mr2901180wrm.38.1710097834823; Sun, 10 Mar 2024 12:10:34 -0700 (PDT) Received: from [127.0.0.1] ([13.74.141.28]) by smtp.gmail.com with ESMTPSA id f19-20020adfb613000000b0033dc931eb06sm4617743wre.0.2024.03.10.12.10.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 10 Mar 2024 12:10:33 -0700 (PDT) Message-ID: <4140c44a34e8c05581de14c2074945d74ecea1d4.1710097830.git.gitgitgadget@gmail.com> In-Reply-To: References: Date: Sun, 10 Mar 2024 19:10:27 +0000 Subject: [PATCH 3/6] doc: git-init: rework definition lists Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Fcc: Sent To: git@vger.kernel.org Cc: =?utf-8?q?Jean-No=C3=ABl?= Avila , =?utf-8?q?Jean-No?= =?utf-8?q?=C3=ABl_Avila?= From: =?utf-8?q?Jean-No=C3=ABl_Avila?= From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= In all cases of option description, each option is in its own term. Use the same format here. Signed-off-by: Jean-Noël Avila --- Documentation/git-init.txt | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt index e8fe72861dc..5fce39040f2 100644 --- a/Documentation/git-init.txt +++ b/Documentation/git-init.txt @@ -99,12 +99,14 @@ The option can have the following values, defaulting to `group` if no value is given: + -- -'umask' (or 'false'):: +umask:: +false:: Use permissions reported by umask(2). The default, when `--shared` is not specified. -'group' (or 'true'):: +group:: +true:: Make the repository group-writable, (and g+sx, since the git group may not be the primary group of all users). This is used to loosen the permissions of an @@ -113,11 +115,13 @@ permission bits (e.g. if umask is `0022`, using `group` will not remove read privileges from other (non-group) users). See `0xxx` for how to exactly specify the repository permissions. -'all' (or 'world' or 'everybody'):: +all:: +world:: +everybody:: Same as `group`, but make the repository readable by all users. -'':: +:: __ is a 3-digit octal number prefixed with `0` and each file will have mode __. __ will override users'`umask(2)` From patchwork Sun Mar 10 19:10:28 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Jean-No=C3=ABl_Avila?= X-Patchwork-Id: 13588173 Received: from mail-wr1-f46.google.com (mail-wr1-f46.google.com [209.85.221.46]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E0C1E3A1A2 for ; Sun, 10 Mar 2024 19:10:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.46 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097839; cv=none; b=Me52Fm0EjpCO8pIbH+y3Q7h7Z1ygbz6eAtyaTWSzkExmDKUsFoVdy/qPzkgpGKd1yoQFeeEY7WoLaCJExWA096yp01uqcjY33aVOBTq9cZjjr/3BHU4jM6QnNf434p63bKO8GFOXF5s/lU4Hw1W8vffchWtxr0YD1z0YEg4V40k= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097839; c=relaxed/simple; bh=dS/kGFZ8UdygBtKvlYcjBywO95rAq45nGdWwlT5d5hY=; h=Message-ID:In-Reply-To:References:From:Date:Subject:MIME-Version: Content-Type:To:Cc; b=ldE69VwKTQ1BYmRUnfGSEGnN549zIe0oH2BzSRmW0CrPXSMX9jpA1fYyDCswpJrOnzMJ41jewNC6nHoI+uW4GVjJ2AgWpNnuTD8zn+JXVfI6ONliWDFYQ2095QZ82h2rXem/AgroFw8mdOtyzClTrhuaA9SUGx96cd445fyjeRs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=R5vqoXDh; arc=none smtp.client-ip=209.85.221.46 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="R5vqoXDh" Received: by mail-wr1-f46.google.com with SMTP id ffacd0b85a97d-33e76d653b5so2379738f8f.3 for ; Sun, 10 Mar 2024 12:10:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1710097836; x=1710702636; darn=vger.kernel.org; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:from:to:cc:subject:date :message-id:reply-to; bh=vDV6Y44U3/+qx6Teeh+JIqjoMXZiMeRFuaYW9xgqqqE=; b=R5vqoXDhaO8DmuGBwlI5FSHX0hAWor/+kCU0ly0C9Nt6CxJ6SBbz0ry90y8lrWJhfS jXuNzVmgGzvVKcvKgGkQBoQX/kAjDP7MdgROLw7P71Loltt3LwqxHaAW1ydJhZYzS4ON 2p67aUMGczhTfu8ysu0b0T9e/zHXdXdmfJGaJPBqSj0ID6sJnaMIBf4RdEUXkVTfWrxh +Mtgy2OekBi2d7zHpWx46T0OsfJEiwFjSM/5WJokC61ev3hkIYvbNCuKCT4nR3cx0aUm sWVkCSVLN6iCqxhFx2NoIdpiI4HvDqHr7qR1DwQ+Tt5ml1Mxju+uMnGVB1AJj8smmxdy ag2w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710097836; x=1710702636; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=vDV6Y44U3/+qx6Teeh+JIqjoMXZiMeRFuaYW9xgqqqE=; b=LyRGxC9a/g7X9GPFy4oM7a2HjTHs1mWRVWl3VzIXPe5UCpn5cEqD+dz9gZd8qE8IUC SP4nnb2X6HyXeavu8N5HOCb4dkUwh6Sg2nDjFshjLJrY5hYHzTKTc3EouDXAILjd3pmu mM2N+j6JngBHj2KZA5DEN8heD0r/mUVoy/TeCK5AgYN+PLeG8cenBB5GCyTzdH/4VnIa wzsr2Dw8tinMJWluHCalR3D5YhH8Do/TBcRmJQMNfdLri5LTJBDrrAjvrroa6D34tasA V3Q7lASlcZ3mRBrVno8Ga0yV6wkYdObNZWJyJQSfMv7T38mFPFVzSMZtkszd9CZWS7BO P6kg== X-Gm-Message-State: AOJu0YxIhrXp0urB4h6JuNZ8OPhIeOvMtNFSV9wjAoztdpdMDVacePdS E0CId2f4V9T6/v47exVKDW7FCRrXg4CHq15bHLZ0Y09fL64/W5aCErXy5+fq X-Google-Smtp-Source: AGHT+IEu83w13CgPktCnlfgIapjI1AA/Zor8QFcvol7iaLViZtkb74xkpxlGk4h88ywYZCSVOT6trA== X-Received: by 2002:a05:6000:1001:b0:33d:a2f7:ab33 with SMTP id a1-20020a056000100100b0033da2f7ab33mr3052125wrx.55.1710097835956; Sun, 10 Mar 2024 12:10:35 -0700 (PDT) Received: from [127.0.0.1] ([13.74.141.28]) by smtp.gmail.com with ESMTPSA id m38-20020a05600c3b2600b00412b6fbb9b5sm13218961wms.8.2024.03.10.12.10.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 10 Mar 2024 12:10:35 -0700 (PDT) Message-ID: <8fda922dddf4278786acab4df8d7b31ed7605bc2.1710097830.git.gitgitgadget@gmail.com> In-Reply-To: References: Date: Sun, 10 Mar 2024 19:10:28 +0000 Subject: [PATCH 4/6] doc: git-init: rework config item init.templateDir Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Fcc: Sent To: git@vger.kernel.org Cc: =?utf-8?q?Jean-No=C3=ABl?= Avila , =?utf-8?q?Jean-No?= =?utf-8?q?=C3=ABl_Avila?= From: =?utf-8?q?Jean-No=C3=ABl_Avila?= From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= When included into a the manpage of git-init, the param section must not refer to the manpage. Signed-off-by: Jean-Noël Avila --- Documentation/config/init.txt | 9 ++++++--- Documentation/git-init.txt | 2 ++ 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/Documentation/config/init.txt b/Documentation/config/init.txt index 79c79d66174..dd1d8332737 100644 --- a/Documentation/config/init.txt +++ b/Documentation/config/init.txt @@ -1,7 +1,10 @@ -init.templateDir:: - Specify the directory from which templates will be copied. - (See the "TEMPLATE DIRECTORY" section of linkgit:git-init[1].) +:see-git-init: +ifndef::git-init[] +:see-git-init: (See the "TEMPLATE DIRECTORY" section of linkgit:git-init[1].) +endif::[] +init.templateDir:: + Specify the directory from which templates will be copied. {see-git-init} init.defaultBranch:: Allows overriding the default branch name e.g. when initializing a new repository. diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt index 5fce39040f2..2f864e11ed9 100644 --- a/Documentation/git-init.txt +++ b/Documentation/git-init.txt @@ -185,6 +185,8 @@ CONFIGURATION include::includes/cmd-config-section-all.txt[] +:git-init: + include::config/init.txt[] GIT From patchwork Sun Mar 10 19:10:29 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Jean-No=C3=ABl_Avila?= X-Patchwork-Id: 13588174 Received: from mail-wm1-f46.google.com (mail-wm1-f46.google.com [209.85.128.46]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id CE1903A1C5 for ; Sun, 10 Mar 2024 19:10:38 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.46 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097840; cv=none; b=Vfx7IYZt8/W9zSbovTavMhPD7fSQfRSyBC6n5xQQ4kzYCyiX8kI12q+V66xQSFm0hAp6d1jLrD9ccoyMaDkEIGALwWud36BpH7e6laJGTrLOITPtyR7C/H701m19ZZBgRZECEY7N1GeabYV4HgzA9CWcQpz1KwlP+W3zEwSZZFw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097840; c=relaxed/simple; bh=vOLqEJCObHpSCjeaObQdFsiOn7PnHKApodVZhe132xk=; h=Message-ID:In-Reply-To:References:From:Date:Subject:MIME-Version: Content-Type:To:Cc; b=RyFm/3y/jJyfiyv0rQgoTSa80dIRqE4ynPo0Q83QQNWlslkoBf+7RZG+2Jn0PDfr8GX9Y0uAhsRR/wCkUL3uBCCzvxJVujavxejz39a5aP85rQLrrw5ftzuny7lpbGb31TEOch9CAGxgtl6YIUiIqGEDfbFlXtYUCpvjKgyL/hE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=QcjQAi1G; arc=none smtp.client-ip=209.85.128.46 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="QcjQAi1G" Received: by mail-wm1-f46.google.com with SMTP id 5b1f17b1804b1-41329a665d8so1919225e9.2 for ; Sun, 10 Mar 2024 12:10:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1710097836; x=1710702636; darn=vger.kernel.org; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:from:to:cc:subject:date :message-id:reply-to; bh=iK45SV2ohTWRxcqILSkwK9ayI5NTetuU7nt2g3ZdZhI=; b=QcjQAi1GJEJ0WcsAqRqNPDIeFmRYE4yPtzPG7AReHfDgNefWwieTdMQE4FwfHefJuK tg17jLB3KAH936QEUZwp84dwnTa+qQurso36J8Dh+sR7YjNNiFfiS3by2oFirUvixM6M cDJ/4j7kaHG+UoJDRdnwwIvShRx3bGK2S3T36ASbPJwCintz34SR7cJo6Vrln/dviDv6 EPznCfYwfoPP/XtgmJOtQTaQm5niOSCJFKOR9j/DDPvpeYlsCdcHRzq0P48KUaq71KRH 1BfC35s5gLpAopgGRusR/g31omzTRT+o9B8AEqOIaejtHm3JYSAZs5dhgv+QTdTbCtKx J9ng== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710097836; x=1710702636; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=iK45SV2ohTWRxcqILSkwK9ayI5NTetuU7nt2g3ZdZhI=; b=dPS0wlwMBlWVFQH/ahRoch5dzIUE61VlySyRVUOGi2qwP8mjRCmPEPC1ZidWa6joOa s1lUb78xURvKek5wxv58VGlWBGb6yg1Qxy2lnQYmevSq/ErPRl7ztnFbsD5IKKc0523z xxXqdvISGq0pR/I9ExZBKKSvj1WtCCBIq9gYMTU9BqLxG/9HXcRJNKc+yGuQfB34mFmB hpOPG9DD6UixLiLMgnEgMdmR3PsonWJjZubMp1EzHSG6Iou53xeI7WHXz6FGgEqUqau7 Ub6Z49MP8/EtXF1ICb0lNvAUBoZ9ifGsMJ+o529tTqmCGYNap71Ztr/fefK9eBTl16QQ 6siw== X-Gm-Message-State: AOJu0Yyzg3s9kGL4ztmoUIAXYLYth/W3Kjzmaqu/lPB+9Yw2HORivYaS Q9smFqEvCVDNX1lTgFGWwxQxsQqURky+6Kfqvy+4/H7LepswqDbVZDkhqJuO X-Google-Smtp-Source: AGHT+IEMnETc8BDA733O5SSSzu76SDSgs4oZ33Kxo5Rj0bFkWvJALlA9qz+Lcz9hjsh3m5A9kIXCRg== X-Received: by 2002:a05:600c:3b95:b0:413:166c:242e with SMTP id n21-20020a05600c3b9500b00413166c242emr3475761wms.28.1710097836436; Sun, 10 Mar 2024 12:10:36 -0700 (PDT) Received: from [127.0.0.1] ([13.74.141.28]) by smtp.gmail.com with ESMTPSA id f15-20020a05600c154f00b004131f8b622bsm6075192wmg.14.2024.03.10.12.10.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 10 Mar 2024 12:10:36 -0700 (PDT) Message-ID: <54e5d8735c4351e5041f777f8d9da0fcadfcfef6.1710097830.git.gitgitgadget@gmail.com> In-Reply-To: References: Date: Sun, 10 Mar 2024 19:10:29 +0000 Subject: [PATCH 5/6] doc: git-clone: format verbatim words Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Fcc: Sent To: git@vger.kernel.org Cc: =?utf-8?q?Jean-No=C3=ABl?= Avila , =?utf-8?q?Jean-No?= =?utf-8?q?=C3=ABl_Avila?= From: =?utf-8?q?Jean-No=C3=ABl_Avila?= From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= We also apply the formatting to urls.txt which is included. Signed-off-by: Jean-Noël Avila --- Documentation/git-clone.txt | 4 ++-- Documentation/urls.txt | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt index 0c07720c6f4..6bad5641151 100644 --- a/Documentation/git-clone.txt +++ b/Documentation/git-clone.txt @@ -156,7 +156,7 @@ objects from the source repository into a pack in the cloned repository. --[no-]reject-shallow:: Fail if the source repository is a shallow repository. - The 'clone.rejectShallow' configuration variable can be used to + The `clone.rejectShallow` configuration variable can be used to specify the default. --bare:: @@ -263,7 +263,7 @@ corresponding `--mirror` and `--no-tags` options instead. branch remote's `HEAD` points at. Further fetches into the resulting repository will only update the remote-tracking branch for the branch this option was used for the - initial cloning. If the HEAD at the remote did not point at any + initial cloning. If the `HEAD` at the remote did not point at any branch when `--single-branch` clone was made, no remote-tracking branch is created. diff --git a/Documentation/urls.txt b/Documentation/urls.txt index ce671f812d4..9af19be2075 100644 --- a/Documentation/urls.txt +++ b/Documentation/urls.txt @@ -44,20 +44,20 @@ syntaxes may be used: ifndef::git-clone[] These two syntaxes are mostly equivalent, except when cloning, when -the former implies --local option. See linkgit:git-clone[1] for +the former implies `--local` option. See linkgit:git-clone[1] for details. endif::git-clone[] ifdef::git-clone[] These two syntaxes are mostly equivalent, except the former implies ---local option. +`--local` option. endif::git-clone[] -'git clone', 'git fetch' and 'git pull', but not 'git push', will also +`git clone`, `git fetch` and `git pull`, but not `git push`, will also accept a suitable bundle file. See linkgit:git-bundle[1]. When Git doesn't know how to handle a certain transport protocol, it -attempts to use the 'remote-' remote helper, if one +attempts to use the `remote-` remote helper, if one exists. To explicitly request a remote helper, the following syntax may be used: From patchwork Sun Mar 10 19:10:30 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Jean-No=C3=ABl_Avila?= X-Patchwork-Id: 13588175 Received: from mail-wr1-f54.google.com (mail-wr1-f54.google.com [209.85.221.54]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 5E6C83A1DA for ; Sun, 10 Mar 2024 19:10:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.54 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097841; cv=none; b=j8mBnYS2MaBEjwpg1S4x7Eyus9EKiVlYGUcwFetWERZZf+0z47x8Rwbx8NkNzlF41byPm/Qz/qKbklJdAf9VnzhLPVkRdAaqtfBvuY0lprlwVjHb3dSKvG1wBqEQV1+nbN2RW0EqbDaTITVo//Hdx5Bz4ZQkaEzJWtUbEGnGDKI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710097841; c=relaxed/simple; bh=wFu0Hcfi2qpKiCNUSZbRzV2hirCOUEflPdZJX4yfh7M=; h=Message-ID:In-Reply-To:References:From:Date:Subject:MIME-Version: Content-Type:To:Cc; b=WPiU2tKwHOyKKQQMxlXWgIfRXA5N+zCJkzeQXfzzBTYZP+Dd7PJ5W+Gn/VlIiubGNW22tKKKBcEaslEGqLMr3RrndooUbLzvVsIJdiYJW+lmKzTuvWWlr7wbEuxMbLCCRWPkdmK6Zd2KkyCaQFJEc+JG4YiU7Ow3p0zDVmyWQjk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=RHOYbAQa; arc=none smtp.client-ip=209.85.221.54 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="RHOYbAQa" Received: by mail-wr1-f54.google.com with SMTP id ffacd0b85a97d-33e17342ea7so1267117f8f.2 for ; Sun, 10 Mar 2024 12:10:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1710097837; x=1710702637; darn=vger.kernel.org; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:from:to:cc:subject:date :message-id:reply-to; bh=c9o8yU3FSfbdOlNhDd5jaRhClYbLhMj1eyaJqcYqQeA=; b=RHOYbAQa0sc+EiLPB9Xdl0dsb83ouiAj1RoITG3tYTa2fYawc5fxaLLWgBiuA1PiUg YypaGIDT1jxNz2as4zM/nZh1HKr9oV+Vx/qDsUAwFlM/Ql1bMJumpMmijFULcdRqewQ/ GYLL7NX+7Aq/X8is14OQv+9tFEtE0WiUzujcSimX09arRQsaslJzoCrI81kv5ttphr9n HNgrXDZZipYegd8KJVUQDJ3uZBj/Ygxw75hjRpBeUucNn7X1c/x/v19g5faZj9kKTDPA 6uGCJDvphnFsod1uUBjSZlmX+X6YD7H2SChBHuzANnLJkEtjbwxjdnrHNAtFgwacMQVY px/A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710097837; x=1710702637; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=c9o8yU3FSfbdOlNhDd5jaRhClYbLhMj1eyaJqcYqQeA=; b=Zj8nzMJlMrpPeFEP9WpYbTTUKJy8Sg2CoGY777zvQIzSj3UMjg8Nwa+alIFB3ahtJb xnTV5FAjSD5xj7ZB+AaCuUmNCvDcx3FHqPhaHYLhvMq4jQPTiX/CK5WnCllWGkJVFwBR Ahvx/X5Qe5/y+xKa/zI3ss8uUWQKsObMcoMD+U3wxvX5WrrPYJBL/Hw/XOEvJMhalSG0 Ld+9QQk6Df/VkzND0YYZMdDL2kF/oZJ0u6wrHLmop+84DjrGQ0gyu8e7jEv49ZHBPfQz sZVRQNZhb+cFqcjMjWfMlgSK7H2Md6PCRN39/kuRGrbr0pFsxibbqIi3ee9magC/T6L2 jTfg== X-Gm-Message-State: AOJu0YwDW+VPKvGPOPDm6STXJZowlsFYCgQmsu2pjqf5dlS8LrdfY7ue 0D1COvx1sZxec0Qi0JYCwpuek2bKOV7B2bCMLzBifKsS+0b4Nngf2pb8TUqS X-Google-Smtp-Source: AGHT+IHW0RzoYDjsssvrs37BoyRcFIjxZnE9GSHNKhsRu5nknoKIXz2RVPGsTGTR04oXmFPPFj6yog== X-Received: by 2002:a5d:6909:0:b0:33e:3d71:445f with SMTP id t9-20020a5d6909000000b0033e3d71445fmr3080847wru.32.1710097837565; Sun, 10 Mar 2024 12:10:37 -0700 (PDT) Received: from [127.0.0.1] ([13.74.141.28]) by smtp.gmail.com with ESMTPSA id g13-20020adfe40d000000b0033e756ed840sm4531245wrm.47.2024.03.10.12.10.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 10 Mar 2024 12:10:36 -0700 (PDT) Message-ID: <9a949d98a3ec8b7730b5a6b66e8ef8bb62cd06aa.1710097830.git.gitgitgadget@gmail.com> In-Reply-To: References: Date: Sun, 10 Mar 2024 19:10:30 +0000 Subject: [PATCH 6/6] doc: git-clone: format placeholders Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Fcc: Sent To: git@vger.kernel.org Cc: =?utf-8?q?Jean-No=C3=ABl?= Avila , =?utf-8?q?Jean-No?= =?utf-8?q?=C3=ABl_Avila?= From: =?utf-8?q?Jean-No=C3=ABl_Avila?= From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= With the new formatting rules, we use __. Signed-off-by: Jean-Noël Avila --- Documentation/git-clone.txt | 26 +++++++++++++------------- Documentation/urls.txt | 4 ++-- 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt index 6bad5641151..f90977a8519 100644 --- a/Documentation/git-clone.txt +++ b/Documentation/git-clone.txt @@ -102,9 +102,9 @@ its source repository, you can simply run `git repack -a` to copy all objects from the source repository into a pack in the cloned repository. --reference[-if-able] :: - If the reference repository is on the local machine, + If the reference __ is on the local machine, automatically setup `.git/objects/info/alternates` to - obtain objects from the reference repository. Using + obtain objects from the reference __. Using an already existing repository as an alternate will require fewer objects to be copied from the repository being cloned, reducing network and local storage costs. @@ -161,8 +161,8 @@ objects from the source repository into a pack in the cloned repository. --bare:: Make a 'bare' Git repository. That is, instead of - creating `` and placing the administrative - files in `/.git`, make the `` + creating __ and placing the administrative + files in `/.git`, make the __ itself the `$GIT_DIR`. This obviously implies the `--no-checkout` because there is nowhere to check out the working tree. Also the branch heads at the remote are copied directly @@ -180,11 +180,11 @@ objects from the source repository into a pack in the cloned repository. --filter=:: Use the partial clone feature and request that the server sends a subset of reachable objects according to a given object filter. - When using `--filter`, the supplied `` is used for + When using `--filter`, the supplied __ is used for the partial clone filter. For example, `--filter=blob:none` will filter out all blobs (file contents) until needed by Git. Also, `--filter=blob:limit=` will filter out all blobs of size - at least ``. For more details on filter specifications, see + at least __. For more details on filter specifications, see the `--filter` option in linkgit:git-rev-list[1]. --also-filter-submodules:: @@ -203,13 +203,13 @@ objects from the source repository into a pack in the cloned repository. -o :: --origin :: Instead of using the remote name `origin` to keep track of the upstream - repository, use ``. Overrides `clone.defaultRemoteName` from the + repository, use __. Overrides `clone.defaultRemoteName` from the config. -b :: --branch :: Instead of pointing the newly created HEAD to the branch pointed - to by the cloned repository's HEAD, point to `` branch + to by the cloned repository's HEAD, point to __ branch instead. In a non-bare repository, this is the branch that will be checked out. `--branch` can also take tags and detaches the HEAD at that commit @@ -230,7 +230,7 @@ objects from the source repository into a pack in the cloned repository. Set a configuration variable in the newly-created repository; this takes effect immediately after the repository is initialized, but before the remote history is fetched or any - files checked out. The key is in the same format as expected by + files checked out. The __ is in the same format as expected by linkgit:git-config[1] (e.g., `core.eol=true`). If multiple values are given for the same key, each value will be written to the config file. This makes it safe, for example, to add @@ -281,7 +281,7 @@ branch of some repository for search indexing. --recurse-submodules[=]:: After the clone is created, initialize and clone submodules - within based on the provided pathspec. If no pathspec is + within based on the provided __. If no _=_ is provided, all submodules are initialized and cloned. This option can be given multiple times for pathspecs consisting of multiple entries. The resulting clone has `submodule.active` set to @@ -323,20 +323,20 @@ include::ref-storage-format.txt[] Defaults to the `submodule.fetchJobs` option. :: - The (possibly remote) repository to clone from. See the + The (possibly remote) __ to clone from. See the <> section below for more information on specifying repositories. :: The name of a new directory to clone into. The "humanish" - part of the source repository is used if no directory is + part of the source repository is used if no __ is explicitly given (`repo` for `/path/to/repo.git` and `foo` for `host.xz:foo/.git`). Cloning into an existing directory is only allowed if the directory is empty. --bundle-uri=:: Before fetching from the remote, fetch a bundle from the given - `` and unbundle the data into the local repository. The refs + __ and unbundle the data into the local repository. The refs in the bundle will be stored under the hidden `refs/bundle/*` namespace. This option is incompatible with `--depth`, `--shallow-since`, and `--shallow-exclude`. diff --git a/Documentation/urls.txt b/Documentation/urls.txt index 9af19be2075..0b9e0c4302d 100644 --- a/Documentation/urls.txt +++ b/Documentation/urls.txt @@ -61,9 +61,9 @@ attempts to use the `remote-` remote helper, if one exists. To explicitly request a remote helper, the following syntax may be used: -- ::
+- __::_
_ -where
may be a path, a server and path, or an arbitrary +where _
_ may be a path, a server and path, or an arbitrary URL-like string recognized by the specific remote helper being invoked. See linkgit:gitremote-helpers[7] for details.