Bug 255323 - handbook: Discourage use of portsnap, document gitup
Summary: handbook: Discourage use of portsnap, document gitup
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-doc (Nobody)
URL:
Keywords: needs-patch
Depends on:
Blocks:
 
Reported: 2021-04-22 09:08 UTC by Mateusz Piotrowski
Modified: 2021-04-26 07:32 UTC (History)
4 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Mateusz Piotrowski freebsd_committer 2021-04-22 09:08:32 UTC
portmgr suggests that we update the documentation so that it discourages the use of portsnap. As a substitute, we can document how to use gitup.

The reasoning behind discouraging the use of portsnap is:

portsnap is fragile, portmgr has had absolutely no success in having
things evolved for years, and while it was great in the old CVS times
where networks were flacky, and CVS was hard to use, there has been
better alternatives, with svn, there was svnup, and with git, there is
gitup.  Both use the repository directly, and don't require a third
party middleware.
Comment 1 Adam Weinberger freebsd_committer 2021-04-22 15:46:53 UTC
gitup works, but it's not the main thing we should be encouraging. People should use just plain git. We are in this weird cycle where we're recommending tool after tool to avoid just checking out the repo, when the simplest thing is just to check out the repo.
Comment 2 VVD 2021-04-23 12:24:35 UTC
gitup is useless - too slow.

On local SATA SSD:
[~]# time gitup ports
# Host: git.freebsd.org
# Port: 443
# Repository: /ports.git
# Target: /usr/ports
# Have: a2c5d69385fe0d8c5a666d570f5b464ca302d37d
# Want: a2c5d69385fe0d8c5a666d570f5b464ca302d37d
# Branch: main

real    2m58,839s
user    0m34,055s
sys     0m20,755s

On remote HDD via NFS:
[~]# time gitup ports
# Host: git.freebsd.org
# Port: 443
# Repository: /ports.git
# Target: /usr/ports
# Have: a2c5d69385fe0d8c5a666d570f5b464ca302d37d
# Want: a2c5d69385fe0d8c5a666d570f5b464ca302d37d
# Branch: main

real    22m28,088s
user    0m57,772s
sys     0m36,280s

Look at fields: "Have" = "Want", so it's just check without update.
Comment 3 Mathieu Arnold freebsd_committer 2021-04-26 07:32:19 UTC
The only reason I mentioned gitup is because people seem to be allergic to git, and it provided another way to access the repository, of course using git is better.