From nobody Sun Aug 31 18:54:55 2025 X-Original-To: dev-commits-doc-all@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 4cFLlz5tPfz66Mkb for ; Sun, 31 Aug 2025 18:54:55 +0000 (UTC) (envelope-from git@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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cFLlz55N7z3c21; Sun, 31 Aug 2025 18:54:55 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756666495; 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=Y1bhvgpJRtl36zBE+ultLjZLLKAg7CMoYqhuEWIooBc=; b=AcDPg6Jdq3P2KumA+E7VEtLzTHghHAzfeOGsExOv0fRproJnCBj9+YKmHPqdLwbe90ftWD zUEffnmfWcrQe4QBH6de15y9BXW9TWPB2bIP2PHY+ZuYxY6bGBK5vSI6jVqYXrgB1j1d5v cpPcAU9JIDROFMgnIxikDHsC9kqzMdqP8bO7BPBWmkgSkSm7Mp+ROQFNsBRyIof0T/C2kX 0kYwWOefGD+FZc8q2rruioFuY9L8PWOo7Fe9Yk7rwVvbVuVJwRomOcsuYsFXuvOkqYXIHJ H7b1m8PkP1MIEmJtZjVi/05GjRrmbaibgbHBIOLkoEoYhL0UXRQ/E4WifouIyA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756666495; 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=Y1bhvgpJRtl36zBE+ultLjZLLKAg7CMoYqhuEWIooBc=; b=osLrMpsj3+f6K6n2DTOE4PE19rv2KxFaX9JsxuDxSX3mEoWY4DvzA/jchy79S1lulax5xg xEYIQW9vgzdelhluMwhPQIy56CZ96uNYWLUGUtPLxotkoCt67HjpElS4lSdu1G0W3M4bLq yQlkSJN0o+IU2B/L+ePhGmSM0qwj6zJ9CS9nPLXjQJ/6Tluk/c2uk7ZArN4EZ2wDCMnB1B 4uVfU+s2HiTyxmU3ig0gfnOL4CYw4Q7ohTnXDkAv0PqLHoMCYXsRfsostVY/k3J0iocDWa ecOegbB47Juf90BXiBQ2JfOJwSaJFodx1vBkIieINWntaIBLJAu0ySM4BY4V+A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756666495; a=rsa-sha256; cv=none; b=Zbsng7JP9uvqDBF8mRKNEjzHRJG0tnpRYcosAKz7ikNxPjsatK8JUTriv1sV4HexZ4Bo7Q //QZP9REXm5hhvomeg0OMLAMIn6AZk5L1WS4IYP/JCNpL6DIHfEGmv0kaFjI/CG1MGx89q gctcnqWGeK+TQJy3fcycby2w4VCr/yKUzJN/IDdYQMphSDq6KU1b2QUcULSQ6u0wP0PCqd btLGZ/8X4PIG5F/o4L6Ndm0jtzo3O4v8+8S+6upvxdLYLkrGkjSdSfeMk27oHDh9Mr3eR/ 0/DLOUWWtjwIIsX2tyZGtLZ7dz65Yhb4oMMDKRXByzs7/d5UTfNDrOJRvVujTA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 4cFLlz4Bwtz951; Sun, 31 Aug 2025 18:54:55 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 57VIsth4040425; Sun, 31 Aug 2025 18:54:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57VIstbJ040422; Sun, 31 Aug 2025 18:54:55 GMT (envelope-from git) Date: Sun, 31 Aug 2025 18:54:55 GMT Message-Id: <202508311854.57VIstbJ040422@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: 50735390bd - main - handbook: Add git switch info for shallow clones List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 50735390bd3ed510a067085d617ba0e0d050b029 Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=50735390bd3ed510a067085d617ba0e0d050b029 commit 50735390bd3ed510a067085d617ba0e0d050b029 Author: Sergei Zhmylev AuthorDate: 2025-01-19 14:10:40 +0000 Commit: Warner Losh CommitDate: 2025-08-31 18:54:28 +0000 handbook: Add git switch info for shallow clones Signed-off-by: Sergei Zhmylev Reviewed-by: Warner Losh --- documentation/content/en/books/handbook/ports/_index.adoc | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index 725e00331c..a6e68a7137 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -730,8 +730,8 @@ If more control over the ports tree is needed or if local changes need to be mai Git can be used to obtain the Ports Collection. Refer to extref:{committers-guide}[the Git Primer, git-primer] for a detailed description of Git. -We add --depth 1 to the git command line to clone the tree without obtaining the commit history, which saves time and is acceptable for most users. -When maintaining custom changes to the ports tree, or need the history for any reason, omit the --depth 1 argument below. +We add `--depth 1` to the git command line to clone the tree without obtaining the commit history, which saves time and is acceptable for most users. +When maintaining custom changes to the ports tree, or need the history for any reason, omit the `--depth 1` argument below. . Git must be installed before it can be used to check out the ports tree. If a copy of the ports tree is already present, install Git like this: + @@ -773,7 +773,8 @@ If the ports tree is not available, or pkg is being used to manage packages, Git + [source,shell] .... -# git -C /usr/ports switch 2023Q1 +# git -C /usr/ports fetch --depth 1 origin 2023Q2:2023Q2 +# git -C /usr/ports switch 2023Q2 .... ****