git: c5f5a82112 - main - FAQ: Update bits about getting a ports tree

[Mateusz Piotrowski]

On 19/04/2021 12:48, Mathieu Arnold wrote:
> On Mon, Apr 19, 2021 at 10:08:27AM +0000, Mateusz Piotrowski wrote:
>> The branch main has been updated by 0mp:
>>
>> URL: https://cgit.FreeBSD.org/doc/commit/?id=c5f5a82112f0de78da06ae73c19e4c99d4bb3111
>>
>> commit c5f5a82112f0de78da06ae73c19e4c99d4bb3111
>> Author:     Mateusz Piotrowski <0mp at FreeBSD.org>
>> AuthorDate: 2021-04-19 10:00:11 +0000
>> Commit:     Mateusz Piotrowski <0mp at FreeBSD.org>
>> CommitDate: 2021-04-19 10:00:11 +0000
>>
>>      FAQ: Update bits about getting a ports tree
>>      
>>      - Link to the portsnap manual
>>      - Replace Subversion with Git
> Might want to provide other means to get the ports tree than portsnap,
> it is not really supported any more, say, gitup for example.

Good point overall but isn't portsnap being brought back at the moment?

Also, ideally, we'd just rewrite that FAQ entry to just point to appropriate handbook chapters.

>
>> ---
>>   documentation/content/en/books/faq/_index.adoc | 6 +++---
>>   1 file changed, 3 insertions(+), 3 deletions(-)
>>
>> diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc
>> index d7e05aa380..c5829704e8 100644
>> --- a/documentation/content/en/books/faq/_index.adoc
>> +++ b/documentation/content/en/books/faq/_index.adoc
>> @@ -837,12 +837,12 @@ Most ports should work on all supported versions 
of FreeBSD. Those that do not a
>>   FreeBSD supports compressed binary packages to easily install and uninstall ports. Use man:pkg[7] to control the installation of packages.
>>   
>>   [[how-do-download-ports-tree]]
>> -=== How do I download the Ports tree? Should I be using Subversion?
>> +=== How do I download the Ports tree? Should I be using Git?
>>   
>>   Any of the methods listed here work:
>>   
>> -* Use portsnap for most use cases. Refer to link:{handbook}#ports-using/[Using the Ports Collection] for instructions on how to use this tool.
>> -* Use Subversion if custom patches to the ports tree are needed or if 
running FreeBSD-CURRENT. Refer to link:{handbook}#svn/[Using Subversion] for details.
>> +* Use man:portsnap[8] for most use cases. Refer to link:{handbook}#ports-using/[Using the Ports Collection] for instructions on how to use this tool.
>> +* Use Git if custom patches to the ports tree are needed or if running FreeBSD-CURRENT. Refer to link:{handbook}mirrors/#git[Using Git] for details.
>>   
>>   [[ports-4x]]
>>   === Why can I not build this port on my {rel2-relx} -, or {rel-relx} -STABLE machine?
>>