Beginning to use Git for FreeBSD ports: a rough guide

freebsd-ports-git.md

Beginning to use Git for FreeBSD ports: a rough guide

Not for committers.

Please treat this page as work in progress during the transition to Git.

Preparations

1. rm /var/db/gitup/ports
2. rm -r /usr/ports/*
3. rm -r /usr/ports/.git*
4. rm /usr/ports/.arcconfig
5. rm /usr/ports/.portsnap.INDEX
6. ls -adhl /usr/ports/.*
7. remove anything else that no longer has a place.

Essentially:

• if the /usr/ports/ directory exists, it must be empty.

If you use FreeBSD 13.⋯, or OpenZFS with FreeBSD 12.⋯

There's the option of zstd-19 for aggressive compression of future writes to your filesystem. Do this only if your computer is suitably specified. Example:

zfs set compression=zstd-19 copperbowl/usr/ports

The initial clone

git -C /usr clone -o freebsd -b main https://git.freebsd.org/ports.git ports

Routine updates

git -C /usr/ports pull --ff-only

– or if you also work with FreeBSD documentation and source files:

git -C /usr/doc pull --ff-only && git -C /usr/ports pull --ff-only && git -C /usr/src pull --ff-only

All of the options are reasonable. but I would recommend --ff-onlyfor people that just want to build ports. If you are modifying files then --rebase=false is what I'd recommend.

Without such options git will suggest

hint:   git config pull.rebase false  # merge (the default strategy)
hint:   git config pull.rebase true   # rebase
hint:   git config pull.ff only       # fast-forward only

I use the 1st of those 3 options.