From: Sheik <sahibzone@gmail.com>
Date: Sun, 05 Nov 2023 23:17:15 GMT
Subject: git init --initial-branch (should docs mention v2 protocol)
Message-ID: <9f17f398-83fa-4789-ace7-9230834519d3@gmail.com>

Hi Maintainers,


Currently it is not obvious from the docs that (git init 
--initial-branch) needs v2 protocol setup on ssh server for (git clone) 
to work properly with unborn refs, as seen in this email thread

 1. https://lore.kernel.org/git/63eb269e-72b9-4830-98fc-aeef8b8180d7@gmail.com/T/#u


Should a link to the v2 protocol documentation be added in "git init 
--initial-branch" to make this configuration more obvious for admins/users?

 1. https://git-scm.com/docs/git-init#Documentation/git-init.txt---initial-branchltbranch-namegt
 2. https://git-scm.com/docs/gitprotocol-v2


[System Info]
git version:
git version 2.42.0
cpu: x86_64
no commit associated with this build
sizeof-long: 8
sizeof-size_t: 8
shell-path: /bin/sh
uname: Linux 6.5.0-2-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.5.6-1 
(2023-10-07) x86_64
compiler info: gnuc: 13.2
libc info: glibc: 2.37
$SHELL (typically, interactive shell): /bin/bash


[Enabled Hooks]
not run from a git repository - no hooks to show


Thanks

Sheik