From nobody Thu Jul 11 22:45:42 2024 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4WKqZG65l3z5Q7Yh for ; Thu, 11 Jul 2024 22:45:42 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4WKqZG3M7Qz4VZY for ; Thu, 11 Jul 2024 22:45:42 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1720737942; a=rsa-sha256; cv=none; b=utAeCuETLjm8yyMnYVVLJd338MdsbWr4bLtLbNDNEZbx7IQc/vh4NfTcjvoQZjztdYEhU4 SM0/CnJB6fzk8b0lGJZeuri+GllGD9wxvu4YWdVboXeoIE8cJqhQj442iMmHgrDYE+TrvT rJRl5+c+nFeo7bA1wP8KjhQDUOdA5B0+oiH1OIE91AW0pvQrDMKnUy7dLUfVuvxIkTnokH sM3/DACjxxTFuHHvD8PHpiV8FQ8e8KkobKb4x/i6YqZyZYoRBoylqjLh0A8OsXoWaNhU0R +f2/M0vAuHAzQGsL83NNRdq3fz388ghVAQHx4GJPHH3MV3W7QsZkZeR9WXePAQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1720737942; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=7Wr/tpnFjHEttNCT2KYu1PZWE/leSTZeaTIp17fBQm4=; b=Z8RJMn921/MX58Zq2Al04qpPVcBntYZ7r3jDc2aX8/wXuq0wLjS7GD90JddZQ8hAMSTGr/ yktqh1RrV3x82URPlrFA2xrDactD4pIYQxx/pNFQh+25Fca0LUyz2AOAcg3UVOogltfPzn kCfYR41T/VH9HTM8P1fnBEYkKl0YdnymkERevilO6d2t1ddApM2QZ6x0nGzL06bsTiwUhv kDvoNVFmAImnUrqKadpTrUrN7SiaSRJA7IiKcZ9YEmP7yzEwvAc7uamuK+BvXdlf1pDab6 zf9KhawjuCIV9El/pYE+BPAvOSnQMSny6gpk9wVaXX45QaazbyBDyUDN8Zsakw== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4WKqZG2XMyzJSj for ; Thu, 11 Jul 2024 22:45:42 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 46BMjgUD013128 for ; Thu, 11 Jul 2024 22:45:42 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 46BMjgwJ013126 for doc@FreeBSD.org; Thu, 11 Jul 2024 22:45:42 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 280233] Handbook: Wrong git instructions to switch quarterly branch Date: Thu, 11 Jul 2024 22:45:42 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Books & Articles X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Only Me X-Bugzilla-Who: majo-bugs.freebsd.org@cerny.sk X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@FreeBSD.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D280233 Bug ID: 280233 Summary: Handbook: Wrong git instructions to switch quarterly branch Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Only Me Priority: --- Component: Books & Articles Assignee: doc@FreeBSD.org Reporter: majo-bugs.freebsd.org@cerny.sk In FreeBSD handbook, section 4.5.1. Installing the Ports Collection (https://docs.freebsd.org/en/books/handbook/ports/#ports-using-installation= -methods), subsection Procedure: Git Method are non-functional instruction to switch t= o a different quarterly branch: > 5. As needed, switch /usr/ports to a different quarterly branch: > # git -C /usr/ports switch 2023Q1 However that does not work, it show the following error: "fatal: invalid reference: 2023Q1", because the current clone is a shallow clone, as per instruction: > 3. Or, check out a copy of a quarterly branch: > # git clone --depth 1 https://git.FreeBSD.org/ports.git -b 2023Q1 /usr/po= rts The following works (when --depth 1 was used): # cd /usr/ports # git remote set-branches origin 2024Q3 # git fetch --depth 1 origin 2024Q3 # git checkout 2024Q3 The instruction for step 5 should be changed. Maybe the simple switch comma= nd could remain there as an option when --depth 1 argument has been omitted. --=20 You are receiving this mail because: You are the assignee for the bug.=