A porter's field notes

These are my field notes for porting software to FreeBSD.

The FreeBSD ports system is fairly well documented, but I keep running into uncertainties, oddities and more or less undocumented features during my learning the ins and outs. Some things can be done in more ways than one, and some times a certain way is preferable over another for various reasons.

I realized I need to make field notes while learning this, and decided to publish them on the web for others to use and learn from.

What this is:

This is a collection of (relatively) short articles where each article discusses a certain topic within the scope of creating, updating or maintaining ports in the ports collection.

What this is NOT:

This is:

• NOT a handbook - the FreeBSD project maintains the Porter's Handbook already, there is no need for another
• NOT a guide to using the ports collection - refer to the FreeBSD Handbook Chapter 4 for that
• NOT an effort that is endorsed or promoted by the FreeBSD Project nor the FreeBSD Foundation.

How

Use the hamburger menu button () on the top of the page to toggle the left-hand menu.

The previous (←) and next (→) links at the bottom of the page lets you navigate the articles in chronological order.

Who

Reach me at @fosstodon.org/@vkarlsen

Copyright/licensing

All content on this site is provided under the following license unless otherwise stated:

Copyright 2017 Vidar Karlsen. All rights reserved.

Redistribution and use in source (plain text or database dumps) and 'compiled' forms (SGML, HTML, PDF, PostScript, 
RTF and so forth) with or without modification, are permitted provided that the following conditions are 
met:

    1. Redistributions of source code must retain the above copyright notice, this list of 
       conditions and the following disclaimer as the first lines of this file unmodified.

    2. Redistributions in compiled form (transformed to other DTDs, converted to PDF, PostScript, RTF 
       and other formats) must reproduce the above copyright notice, this list of conditions and the 
       following disclaimer in the documentation and/or other materials provided with the distribution.

THIS DOCUMENTATION IS PROVIDED BY VIDAR KARLSEN "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL VIDAR KARLSEN BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS DOCUMENTATION,
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.