FreeBSD Porter's Handbook
Prev | Chapter 3 Quick Porting | Next

# 3.6 Submitting the New Port

Before you submit the new port, make sure you have read the DOs and DON'Ts section.

Now that you are happy with your port, the only thing remaining is to put it in the main FreeBSD ports tree and make everybody else happy about it too. We do not need your `work` directory or the `pkgname.tgz` package, so delete them now. Next, assuming your port is called oneko, `cd` to the directory above where the `oneko` directory is located, and then type the following: `shar `find oneko` > oneko.shar`

Include your `oneko.shar` file in a bug report and send it with the send-pr(1) program (see Bug Reports and General Commentary for more information about send-pr(1)). Be sure to classify the bug report as category `ports` and class `change-request` (Do not mark the report `confidential`!). Also add a short description of the program you ported to the ``Description'' field of the PR (e.g., perhaps a short version of the `COMMENT`), and add the shar file to the ``Fix'' field.

> Note: You can make our work a lot easier, if you use a good description in the synopsis of the problem report. We prefer something like ``New port: <category>/<portname> <short description of the port>'' for new ports. If you stick to this scheme, the chance that someone will take a look at your PR soon is much better.

One more time, do not include the original source distfile, the `work` directory, or the package you built with `make package`; and, do use shar(1) for new ports, not diff(1).

After you have submitted your port, please be patient. Sometimes it can take a few months before a port is included in FreeBSD, although it might only take a few days. You can view the list of ports PRs waiting to be committed to FreeBSD.

Once we have looked at your port, we will get back to you if necessary, and put it in the tree. Your name will also appear in the list of Additional FreeBSD Contributors and other files. Isn't that great?!? :-)

Prev | Home | Next
Checking Your Port with `portlint` | Up | Slow Porting

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