From owner-dev-commits-doc-all@freebsd.org Fri Mar 19 20:20:40 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 065D85AA87C for ; Fri, 19 Mar 2021 20:20:40 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4F2FdM6nKyz3qYZ; Fri, 19 Mar 2021 20:20:39 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 DBD5B1B43E; Fri, 19 Mar 2021 20:20:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 12JKKd3t090186; Fri, 19 Mar 2021 20:20:39 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 12JKKde2090185; Fri, 19 Mar 2021 20:20:39 GMT (envelope-from git) Date: Fri, 19 Mar 2021 20:20:39 GMT Message-Id: <202103192020.12JKKde2090185@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: 05792e1b62 - main - Minor word smithing 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: 05792e1b62221dc9cb7e6985f71e074f84d3b4c5 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 19 Mar 2021 20:20:40 -0000 The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=05792e1b62221dc9cb7e6985f71e074f84d3b4c5 commit 05792e1b62221dc9cb7e6985f71e074f84d3b4c5 Author: Warner Losh AuthorDate: 2021-03-19 20:19:28 +0000 Commit: Warner Losh CommitDate: 2021-03-19 20:19:28 +0000 Minor word smithing Fix a few typoes, grammar errors, wrong word choices, and a bad url. Submitted by: Pau Amma --- .../content/en/articles/committers-guide/_index.adoc | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 8237c47680..3f39b45571 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -1738,7 +1738,8 @@ If not, you'll need to resolve the conflicts as you go. The other way to do this would be to checkout `wilma` and then create the branch `fred` to point to the same point in the tree. You can then `git rebase -i` both these branches, selecting the changes you want in `fred` or `wilma` by retaining the pick likes, and deleting the rest from the editor. -Some people would create a tag/branch called `pre-split` before starting in case something goes wrong in the split, you can undo it with the following sequence: +Some people would create a tag/branch called `pre-split` before starting in case something goes wrong in the split. +You can undo it with the following sequence: [source,shell] .... @@ -1781,10 +1782,10 @@ Here we see the changes I've made. You can use it to figure out where things went wrong. I'll just point out a few things here. The first one is that HEAD@{X} is a 'commitish' thing, so you can use that as an argument to a command. -Though if that command commits anything to the repository, the X numbers change. -You can also use the hash (first column) as well. +Although if that command commits anything to the repository, the X numbers change. +You can also use the hash (first column). -Next 'Encourage contributions' was the last commit I did to `wilma` before I decided to split things up. +Next, 'Encourage contributions' was the last commit I made to `wilma` before I decided to split things up. You can also see the same hash is there when I created the `fred` branch to do that. I started by rebasing `fred` and you see the 'start', each step, and the 'finish' for that process. While we don't need it here, you can figure out exactly what happened. @@ -1981,7 +1982,7 @@ There's a number of ways around this with 'git worktree': [source,shell] .... -% git clone --mirror https://cgit.freebsd.org/ports.git ports.git +% git clone --mirror https://git.freebsd.org/ports.git ports.git % cd ports.git % git worktree add ../ports main % git worktree add ../quarterly branches/2020Q4 @@ -2014,7 +2015,7 @@ To setup your repository to do that: git config --add remote.freebsd.fetch '+refs/*:refs/freebsd/*' .... -which will put everything in the upstream repository into your local repository's 'ref/freebsd/' namespace. +which will put everything in the upstream repository into your local repository's 'refs/freebsd/' namespace. Please note, that this also grabs all the unconverted vendor branches and the number of refs associated with them is quite large. You'll need to refer to these 'refs' with their full name because they aren't in and of Git's regular namespaces.