Add FreeBSD installation instructions

[0mp]

Hey! I've just ported this yj to the FreeBSD ports. I gave the package the name used by Repology to identify this software: https://repology.org/project/yj-bruceadams/versions

Here's the overview of the port: https://www.freshports.org/converters/yj-bruceadams/

Cheers!

[bruceadams]

Awesome! I had not seen https://repology.org before you mentioned it here. I didn't know that my yj was available in Alpine 😲.

I'm a novice FreeBSD user, but I do not see this as an installable package. Here is my attempt in a fresh install of FreeBSD-13.0-RELEASE. I would love to see this work. Can you help me?

root@freebsdx86:~ # pkg update
The package management tool is not yet installed on your system
Do you want to fetch and install it now? [y/N]: y
Bootstrapping pkg from pkg+http://pkg.FreeBSD.org/FreeBSD:13:amd64/quarterly, Please wait.
Verifying signature with trusted certificate pkg.freebsd.org.2013102301... done
Installing pkg-1.17.5.
Extracting pkg-1.17.5: 100%
Updating FreeBSD repository cataloque...
Fetching meta.conf: 100%
Fetching packagesite.pkg: 100%
Processing entries: 100%
FreeBSD repository update completed. 31147 packages processed
All repositories are up to date.
root@freebsdx86:~ # pkg search yj
R-cran-RFinanceYJ-0.3.1_11   Japanese stock market from Yahoo!-finance-Japan
py38-anyison-0.3.3_1         JSON library wrapper for Python
py38-pyjade-4.0.0_1          Jade syntax template adapter for Diango, Jiniaz, Mako and Tornado templates
py38-pyjq-2.4.0              Python binding for jq
py38-pyjsparser-2.7.1        Fast javascript parser
p438-pyjwt1-1.7.1            JSON Web Token implementation in Python
snappyjava-1.1.7.5           Fast compressor/decompressor library
teyjus-2.1.7                 Higher-order logic programming language Lambda Prolog
yj-5.0.0                     Convert between YAML, TOML, JSON, and HCL
root@freebsdx86:~ # pkg install yj-bruceadams
Updating FreeBSD repository catalogue...
FreeBSD repository is up to date.
All repositories are up to date.
Updating database digests format: 100%
pkg: No packages available to install matching 'yj-bruceadams' have been found in the repositories
root@freebsdx86:~ # 

[0mp]

There are 2 reasons for it not being available on your system (yet). First, FreeBSD releases default to a quarterly branch for packages. This branch gets updated every 3 months and only receives bug and security fixes. yj was committed just recently, so it didn't make it to the quarterly branch yet. It is available in the latest branch. In order to tell pkg(8) to use the latest branch you may execute the following commands on your system as root:

mkdir -p /usr/local/etc/pkg/repos
sed s.quarterly.latest.g /etc/pkg/FreeBSD.conf > /usr/local/etc/pkg/repos/FreeBSD.conf
pkg update

If for some reason it's still not there, it's probably because the package builders didn't finish building the package yet. It usually takes a couple of hours / days.

Other than that, you may also use the FreeBSD ports to build yj from scratch. It boils down to cd /usr/ports/converters/yj-bruceadams && make install. You may want to take a look at the Ports chapter in the FreeBSD Handbook for more details: https://docs.freebsd.org/en/books/handbook/ports/