= Adding Ports =

This page assumes you have ported an application/library to the BeOS platform. If you aren't quite there yet, see PortingTips and [wiki:Guidelines].

To add a port to the !BePorts tree, you have to:

 1. Create a patch for the software's original source tree. It is important that this patch is generated in such a way that !BePorter can automatically apply the patch. See CreatePatch.
 1. Rename the patch like such: {{{<portname>-<version>.patch}}}. For example, a patch for libsdl version 1.2.12 would be named {{{libsdl-1.2.12.patch}}}
 1. Create the BepFile. Here's an [http://tools.assembla.com/BePorts/browser/BePorts/trunk/media-libs/libsdl/libsdl-1.2.12.bep example] for libsdl-1.2.12.
 1. Place the !BepFile and patch - at the right location - in your local !BePorts tree. Look up to what category your port belongs at http://gentoo-portage.com
   * The !BepFile should go in {{{category/portname}}}
   * The patch should go in {{{category/portname/patches}}}
 1. Test the !BepFile and patch with BePorter. Make sure !BePorter is able to download, unpack, patch, build and install your port.
 1. Commit the !BepFile and patch to the repository. Place '''only''' !BepFiles and patches in the repository.