This section describes how to quickly create a new port. For applications where this quick method is not adequate, the full “Slow Porting” process is described in Chapter 4, Slow Porting.
First, get the original tarball and put it into
DISTDIR, which defaults to
/usr/ports/distfiles.
These steps assume that the software compiled out-of-the-box. In other words, absolutely no changes were required for the application to work on a FreeBSD system. If anything had to be changed, refer to Chapter 4, Slow Porting.
It is recommended to set the DEVELOPER
make(1) variable in /etc/make.conf
before getting into porting.
#echo DEVELOPER=yes >> /etc/make.conf
This setting enables the “developer mode”
that displays deprecation warnings and activates some further
quality checks on calling make.
The minimal Makefile would look
something like this:
# $FreeBSD$ PORTNAME= oneko PORTVERSION= 1.1b CATEGORIES= games MASTER_SITES= ftp://ftp.cs.columbia.edu/archives/X11R5/contrib/ MAINTAINER= [email protected] COMMENT= Cat chasing a mouse all over the screen .include <bsd.port.mk>
In some cases, the Makefile of an
existing port may contain additional lines in the header,
such as the name of the port and the date it was created.
This additional information has been declared obsolete, and
is being phased out.
Try to figure it out. Do not worry about the
contents of the $FreeBSD$
line, it will be filled in automatically by
Subversion when the port is
imported to our main ports tree. A more detailed
example is shown in the
sample Makefile
section.
All FreeBSD documents are available for download at http://ftp.FreeBSD.org/pub/FreeBSD/doc/
Questions that are not answered by the
documentation may be
sent to <[email protected]>.
Send questions about this document to <[email protected]>.