FreeBSD Trinity Installation Instructions - Revision history

SlavekB: /* Building the port */ Update to build ports integrated into /usr/ports

2023-05-01T00:54:37Z

Building the port: Update to build ports integrated into /usr/ports

SlavekB: /* Cloning the repo */ Updated for R14.1.x.

2023-04-30T19:14:11Z

Cloning the repo: Updated for R14.1.x.

SlavekB: /* Installing git and other core dependencies */ Added other recommended packages to install

2023-04-30T19:10:27Z

Installing git and other core dependencies: Added other recommended packages to install

Hunter0one: /* Installing git and other core dependencies */

2022-05-03T03:24:14Z

Installing git and other core dependencies

Hunter0one at 03:23, 3 May 2022

2022-05-03T03:23:17Z

Hunter0one: Updated for R14.0.12

2022-05-03T03:21:25Z

Updated for R14.0.12

Hunter0one at 16:53, 17 January 2022

2022-01-17T16:53:13Z

Hunter0one at 16:52, 17 January 2022

2022-01-17T16:52:10Z

Hunter0one: Removed some tips I provided based on my own error and added its solution at the prerequisites

2022-01-17T16:51:17Z

Removed some tips I provided based on my own error and added its solution at the prerequisites

Hunter0one: This imlib solution did not work

2021-11-28T14:16:46Z

This imlib solution did not work

@@ Line 62: / Line 62: @@
 =Building the port=
+=== Spread ports from GIT folder to /usr/ports===
-To build the complete desktop environment with build prompts along the way do the following:
+Starting with TDE R14.1.0, the ports are ready to be integrated into the standard port structure in /usr/ports. For this reason, each TDE port now contains "TDE port map" information in the header, which contains information for synchronization from the GIT source folder to the target folder in /usr/ports. The tde-ports-map script is used to perform synchronization:
 <syntaxhighlight lang="shell-session">
-$ cd ~/tde-packaging/freebsd && sudo make install clean
+$ sudo ~/tde-packaging/freebsd/tde-ports-map
+</syntaxhighlight>
+===Building all ports===
+To build the complete desktop environment with build prompts along the way you, can use meta-port 'tde-meta', which does not contain any software, but depends on all ports that are part of the TDE of the umbrella:
+<syntaxhighlight lang="shell-session">
+$ cd /usr/ports/x11/tde-meta && sudo make install clean
 </syntaxhighlight>
@@ Line 75: / Line 84: @@
 <syntaxhighlight lang="shell-session">
-$ ee ~/tde-packaging/freebsd/applications/system/Makefile
+$ ee /usr/ports/x11/tde-meta/Makefile
 </syntaxhighlight>
-And then comment out (add a '''#''') the entry for Dolphin:
+And then comment out (add a '''#''') the entry for Dolphin – port x11-fm/dolphin-trinity:
 [[File:2021-11-26_12-33.png]]
-This can be applied to any of the other Makefiles, but it's best to not touch essentials (i.e anything in the "dependencies" directory") unless absolutely necessary.
+This can be applied to any of the other parts of Makefile, but it's best to not touch essentials (i.e anything in the "dependencies" section) unless absolutely necessary.
 ==Issues==

@@ Line 52: / Line 52: @@
 ===Cloning the repo===
-Now that we have git, we can go ahead and clone the r14.0.x branch:
+Now that we have git, we can go ahead and clone the r14.1.x branch:
 <syntaxhighlight lang="shell-session">
-$ git clone --single-branch --branch r14.0.x https://mirror.git.trinitydesktop.org/gitea/TDE/tde-packaging.git
+$ git clone --single-branch --branch r14.1.x https://mirror.git.trinitydesktop.org/gitea/TDE/tde-packaging.git
 </syntaxhighlight>

@@ Line 41: / Line 41: @@
 <syntaxhighlight lang="shell-session">
-# pkg install git libtool gettext findutils gsed bash automake cmake gmake ninja
+# pkg install git libtool gettext findutils gsed gtar bash automake cmake gmake ninja rsync
+</syntaxhighlight>
+To prevent the need to build many other packages that are needed as dependencies, we also recommend installing the following packages:
+<syntaxhighlight lang="shell-session">
+# pkg install aspell bison btparse chmlib clamav cups djvulibre doxygen exempi exif exiv2 facile ffmpeg file firebird30-client gamin gpgme gstreamer1-plugins gtk3 htdig html2ps iceauth imlib2 intltool iw-hspell jasper jpeg-turbo lcms2 libgphoto2 libgpod libmng libmtp libofx libotr libqalculate libssh libvisual04 libwmf libxine libxslt meanwhile mysql56-client nas ocaml-num openexr pl-libgadu png poppler postgresql11-client pulseaudio py39-boost-libs py39-rdiff-backup ruby samba413 sane-backends sqlite streamripper subversion torsocks transfig unixODBC upower xf86-video-vesa xmedcon xmodmap xorg-fonts xorg-server xprop xrandr xscreensaver xset xsetroot yaz
 </syntaxhighlight>

@@ Line 38: / Line 38: @@
 ===Installing git and other core dependencies===
-After making sure we are on the latest branch of packages, we will need to install '''git''' to obtain the files from the Trinity Gitea Workspace:
+After making sure we are on the latest branch of packages, we will need to install '''git''' to obtain the files from the Trinity Gitea Workspace as well as some other core dependencies to avoid building them later:
 <syntaxhighlight lang="shell-session">

@@ Line 7: / Line 7: @@
 =Prerequisites=
 ===Installing the latest versions of the FreeBSD base system and Ports Collection===
-This could very possibly help with some of the issues mentioned below by ensuring you are using the latest ports and base system packages. Follow the next step if you want to mix ports and packages.
+This could very possibly help with some issues by ensuring you are using the latest ports and base system packages. Follow the next step if you want to mix ports and packages.
 <syntaxhighlight lang="shell-session">
 # portsnap auto && freebsd-update fetch install
@@ Line 35: / Line 35: @@
 </syntaxhighlight>
-You can now run <tt>pkg update</tt> which will re-generate the list with the latest branch of packages.
+You can now run <tt>pkg update</tt> which will re-generate the list with the latest branch of packages. If you are in a non-clean environment (i.e you already have another wm/desktop environment and were using quarterly), please run <tt>pkg upgrade</tt> before proceeding with the next step.
 ===Installing git and other core dependencies===

@@ Line 7: / Line 7: @@
 =Prerequisites=
 ===Installing the latest versions of the FreeBSD base system and Ports Collection===
-This could very possibly help with some of the issues mentioned below by ensuring you are using the latest ports and base system packages.
+This could very possibly help with some of the issues mentioned below by ensuring you are using the latest ports and base system packages. Follow the next step if you want to mix ports and packages.
 <syntaxhighlight lang="shell-session">
 # portsnap auto && freebsd-update fetch install
 </syntaxhighlight>
+===Ports + packages: Switching to "latest" package branch===
-===Installing git and core tools===
+''Make sure you do this if you are going to install anything via pkg beforehand, or are installing TDE in a non-clean environment.''
-We will need to install '''git''' to obtain the files from the Trinity Gitea Workspace. We can also go ahead and get some of the core build dependencies used by the TDE port to avoid building them later:
+To avoid building some things that would be much quicker to avoid, we can use pkg to fetch and install core dependencies instead of compiling every dependency as a port. As of 2 May 2022, some package libraries from the "quarterly" branch are older than what some TDE applications are looking for. <tt>devel/icu</tt> is a notable example. Therefore, it is recommended that we use the latest repository which has the same versions as the Ports Collection. If you haven't, you can do this the following way:
+<syntaxhighlight lang="shell-session">
+# mkdir -p /usr/local/etc/pkg/repos && cp /etc/pkg/FreeBSD.conf /usr/local/etc/pkg/repos
+</syntaxhighlight>
+You then need to edit the original <tt>/etc/pkg/FreeBSD.conf</tt> in your favorite text editor (as root) and make sure its disabled by setting <tt>enabled: yes</tt> to <tt>enabled: no</tt>
+After editing that, edit <tt>/usr/local/etc/pkg/repos/FreeBSD.conf</tt> and change the
+<syntaxhighlight>
+url: "pkg+http://pkg.FreeBSD.org/${ABI}/quarterly",
+</syntaxhighlight>
+to:
+<syntaxhighlight>
+url: "pkg+http://pkg.FreeBSD.org/${ABI}/latest",
+</syntaxhighlight>
+You can now run <tt>pkg update</tt> which will re-generate the list with the latest branch of packages.
+===Installing git and other core dependencies===
+After making sure we are on the latest branch of packages, we will need to install '''git''' to obtain the files from the Trinity Gitea Workspace:
 <syntaxhighlight lang="shell-session">
@@ Line 38: / Line 63: @@
 * <tt>sudo</tt> is used because if this is performed entirely as root then "cd" will go into root's home directory. You could also use <tt>doas</tt> or enter the directory first then switch to root using <tt>su</tt>.
-* If you are okay with the default build options and don't want to be prompted, you can add <code>NO_DIALOG=yes</code> to the <tt>make</tt> command.
+* If you are okay with the default build options or have an <tt>/etc/make.conf</tt> file and don't want to be prompted, you can add <code>NO_DIALOG=yes</code> to the <tt>make</tt> command.
 ===Choosing packages manually===
@@ Line 54: / Line 79: @@
 ==Issues==
-You may run into a snag during the build process. Even if you fix it yourself, it would be great to write a bug report to TGW [https://mirror.git.trinitydesktop.org/gitea/TDE/tde-packaging/issues/new here]. This will help improve the quality of the port by locating and indicating the severity of a bug so it doesn't happen again in the future. This section should cover known issues and ways to bypass them for now.
+You may run into a snag during the build process. Even if you fix it yourself, it would be great to write a bug report to TGW [https://mirror.git.trinitydesktop.org/gitea/TDE/tde-packaging/issues/new here]. This will help improve the quality of the port by locating and indicating the severity of a bug so it doesn't happen again in the future. This section should cover known issues.
-====tdepim stuck on "[29/30] Running tests...."====
-Use <code>Ctrl + C</code> to stop the build process. Don't worry, when you start it again it will start from where you left off. Open the Makefile for <tt>tdepim-trinity</tt> in an editor (such as <tt>ee</tt>):
-<syntaxhighlight lang="shell-session">
-$ ee ~/tde-packaging/freebsd/core/tdepim/Makefile
-</syntaxhighlight>
+As of R14.0.12, the [https://mirror.git.trinitydesktop.org/gitea/TDE/tde-packaging/issues/110 imlib issue (#110)] has been fixed.
-Now scroll to the bottom and comment out the line starting with <code>post-build:</code>. This will disable the CMake check that gets stuck. Return to the master directory and start the build process again.
 =Post-installation=

@@ Line 74: / Line 74: @@
 [[File:2021-11-26_13-30-Fixed.png]]
-Where the yellow cursor is will be the line that will contain <tt>/usr/local/bin/xdm</tt>. You want to replace this line with <tt>/opt/trinity/bin/tdm</tt> like in the image and change "off" to "on".
+Where the yellow cursor is will be the line that will contain <tt>/usr/local/bin/xdm</tt>. You want to replace this line with <tt>/opt/trinity/bin/tdm</tt> like in the image and change <tt>off</tt> to <tt>on</tt>.
 '''If all is done correctly, you should be greeted with TDM once you reboot. You can then enter your newly installed Trinity Desktop Environment. Enjoy!'''