Changeset View
Changeset View
Standalone View
Standalone View
head/en_US.ISO8859-1/books/porters-handbook/new-port/chapter.xml
| <?xml version="1.0" encoding="iso-8859-1"?> | <?xml version="1.0" encoding="iso-8859-1"?> | ||||
| <!-- | <!-- | ||||
| The FreeBSD Documentation Project | The FreeBSD Documentation Project | ||||
| $FreeBSD$ | $FreeBSD$ | ||||
| --> | --> | ||||
| <chapter xmlns="http://docbook.org/ns/docbook" | <chapter xmlns="http://docbook.org/ns/docbook" | ||||
| xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" | xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" | ||||
| xml:id="own-port"> | xml:id="own-port"> | ||||
| <title>Making a New Port</title> | <title>Making a New Port</title> | ||||
| <para>So, you are interested in making your own port or | <para>Interested in making a new port, or upgrading existing ports? | ||||
| upgrading an existing one? Great!</para> | Great!</para> | ||||
| <para>What follows are some guidelines for creating a new port for | <para>What follows are some guidelines for creating a new port for | ||||
| &os;. If you want to upgrade an existing port, you should read | &os;. To upgrade an existing port, read | ||||
| this and then read <xref linkend="port-upgrading"/>.</para> | this, then read <xref linkend="port-upgrading"/>.</para> | ||||
| <para>When this document is not sufficiently detailed, you should | <para>When this document is not sufficiently detailed, | ||||
| refer to <filename>/usr/ports/Mk/bsd.port.mk</filename>, which all | refer to <filename>/usr/ports/Mk/bsd.port.mk</filename>, which is | ||||
| port Makefiles include. Even if you do not hack Makefiles daily, | included by all port <filename>Makefile</filename>s. Even those | ||||
| it is well commented, and you will still gain much knowledge from | not hacking <filename>Makefile</filename>s daily can gain much | ||||
| it. Additionally, you may send specific questions to the | knowledge from it. Additionally, specific questions can be sent to the | ||||
| &a.ports;.</para> | &a.ports;.</para> | ||||
| <note> | <note> | ||||
| <para>Only a fraction of the variables | <para>Only a fraction of the variables | ||||
| (<varname><replaceable>VAR</replaceable></varname>) that can be | (<varname><replaceable>VAR</replaceable></varname>) that can be | ||||
| overridden are mentioned in this document. Most (if not all) | overridden are mentioned in this document. Most (if not all) | ||||
| are documented at the start of | are documented at the start of | ||||
| <filename>/usr/ports/Mk/bsd.port.mk</filename>; the others | <filename>/usr/ports/Mk/bsd.port.mk</filename>; the others | ||||
| probably ought to be. Note that this file uses a non-standard | probably ought to be. Note that this file uses a non-standard | ||||
| tab setting: <application>Emacs</application> and | tab setting: <application>Emacs</application> and | ||||
| <application>Vim</application> should recognize the setting on | <application>Vim</application> will recognize the setting on | ||||
| loading the file. Both &man.vi.1; and &man.ex.1; can be set to | loading the file. Both &man.vi.1; and &man.ex.1; can be set to | ||||
| use the correct value by typing | use the correct value by typing | ||||
| <command>:set tabstop=4</command> once the file has been | <command>:set tabstop=4</command> once the file has been | ||||
| loaded.</para> | loaded.</para> | ||||
| </note> | </note> | ||||
| <para> | <para> | ||||
| Looking for something easy to start with? Take a look at the | Looking for something easy to start with? Take a look at the | ||||
| <link xlink:href="http://wiki.freebsd.org/WantedPorts">list of | <link xlink:href="http://wiki.freebsd.org/WantedPorts">list of | ||||
| requested ports</link> and see if you can work on one (or | requested ports</link> and see if you can work on one (or | ||||
| more).</para> | more).</para> | ||||
| </chapter> | </chapter> | ||||