FreeBSD Porter's Handbook
Prev |  | Next

# Chapter 3 Quick Porting

This section tells you how to quickly create a new port. In many cases, it is not sufficient, so you will have to read further on into the document.

First, get the original tarball and put it into `DISTDIR`, which defaults to `/usr/ports/distfiles`.

> Note: The following assumes that the software compiled out-of-the-box, i.e., there was absolutely no change required for the port to work on your FreeBSD box. If you needed to change something, you will have to refer to the next section too.

# 3.1 Writing the `Makefile`

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=	asami@FreeBSD.org
    COMMENT=	Cat chasing a mouse all over the screen

    MAN1=		oneko.1
    MANCOMPRESSED=	yes
    USE_IMAKE=	yes

    .include <bsd.port.mk>

> Note: 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.

See if you can figure it out. Do not worry about the contents of the `$FreeBSD$` line, it will be filled in automatically by SVN when the port is imported to our main ports tree. You can find a more detailed example in the sample Makefile section.

Prev | Home | Next
Making a New Port Yourself |  | Writing the Description Files

For questions about the FreeBSD ports system, e-mail <ports@FreeBSD.org>.
For questions about this documentation, e-mail <doc@FreeBSD.org>.