====== Upgrade Ports-Tree ab FreeBSD 14.0 ======

  * [[https://www.freebsd.org/releases/14.0R/relnotes/]]
  * [[https://docs.freebsd.org/en/books/porters-handbook/quick-porting/#porting-submitting]]
  * [[https://docs.freebsd.org/en/books/handbook/cutting-edge/#makeworld|]]
  * [[https://wiki.freebsd.org/Ports/INDEX]]
  * **[[https://forums.freebsd.org/threads/guide-using-git-to-manage-ports-source-and-documentation.79721/|[Guide] Using Git to manage ports, source and documentation.]]**

[[https://wiki.freebsd.org/Ports/GitQuickStart|Git Quick Start Guide]]


===== Vorbereitungen =====

Seit FreeBSD 14.0 wird der Ports-Tree per GIT geholt => [[https://github.com/freebsd/freebsd-ports]]

GIT installieren:
  > pkg install devel/git


===== Ports-Tree frisch holen =====

alten Baum löschen:
  > rm -fr /usr/ports/* /usr/ports/.*

neuen Baum holen:
  > git clone https://git.freebsd.org/ports.git /usr/ports

INDEX generieren:
  > cd /usr/ports/ && time make index
  > ls -lha /usr/ports/INDEX-*.db


===== Ports-Tree updaten =====

Ports-Tree aktuallisieren + ''INDEX'' neu generieren:
  > portsclean -CL
  > cd /usr/ports/ && git pull && time make index
  > ls -lha /usr/ports/INDEX-*.db


===== Ports-Tree-Branch einstellen =====

Fummelt man an dem Ports-Tree-Zweig nicht herum, dann ist man im "''main''"-Zeig //(main-Branch)// und hat quasi die Version "''latest''".
Ich mag diese Version nicht besonders, weil sich darin viel zu oft und viel zu viele Dinge ändern. Das hat bei mir gelegentlich zu Problemen bei der Installation von neuen Paketen geführt.
Viel angenehmer ist ein Quartals-Zweig, der bekommt nur Fehlerbereinigungen und wird nur alle 3 Monate erneuert.

Zweig-Zweig anzeigen:
  > git -C /usr/ports branch
  * main

//Es ist immer empfehlenswert entweder in einem aktiven Zweig oder im ''main''-Zeig zu sein.//

nachschauen welche Zweige aktiv sind: [[https://github.com/freebsd/freebsd-ports/branches]]

verfügbare Ports-Tree-Zweige anzeigen:
  > git -C /usr/ports branch -a

Zweig wechseln:
  > git -C /usr/ports switch 2024Q1

aktuellen Ports-Tree-Zweig anzeigen:
  > git -C /usr/ports branch
  * 2024Q1
    main

aktuellen Ports-Tree-Zweig verlassen:
  > git switch -d


===== alle installierten und veralteten Ports anzeigen =====

  > portversion -vl '<'