Reducing the depth of git pull in ports.
I'm not sure about this. This limits the log history to the last commit.
This section starts with the following sentence:
If more control over the ports tree is needed or if local changes need to be maintained, or if running FreeBSD-CURRENT...
I would say having the whole history is important if you want more control or need to keep local changes.
That said, I think that paragraph needs rephrasing. It mentions more than one method to install the ports collection yet it describes only one: the git method.
We should here, or in a different review:
- Change the sentence If it was not installed during the installation of FreeBSD, use one of the following methods to install it: to If it was not installed during the installation of FreeBSD, use the following method to install it:
- When doing the git clone, specify something like if you don't need complete control over the ports collection and you don't keep local changes, you can add --depth=1 as shown below
I think we might want to extend this in the future but this is a decent incremental improvement for most users.
There's some ambiguity so I would clarify the "It" in the second sentence - it could be taken as "omitting the --depth 1 argument is faster for most situations."