version 1.16, 1999/06/01 22:26:38 |
version 1.17, 1999/08/15 02:23:45 |
|
|
any install docs. You may need to modify the WRKSRC variable |
any install docs. You may need to modify the WRKSRC variable |
in the makefile as well as generate initial patches to configure |
in the makefile as well as generate initial patches to configure |
for OpenBSD. |
for OpenBSD. |
<p>Note: Patches go in the directory `patches' and are names patch-xx |
<p>Note: Patches go in the directory `patches' and are named patch-xx |
where xx should be aa, ab, ..., az, ba, bb ... zz. |
where xx should be aa, ab, ..., az, ba, bb ... zz. |
<ul> |
<ul> |
<li>only patch one source file per patchfile, please |
<li>only patch one source file per patchfile, please |
<li>use diff -u to generate patches |
<li>use diff -u to generate patches |
<li>all patches MUST be relative to ${WRKSRC} |
<li>all patches MUST be relative to ${WRKSRC} |
<li>add a small explaination of the patch role in the patchfile before |
<li>add a small explanation of the patch role in the patchfile before |
the patch itself, and an OpenBSD CVS tag |
the patch itself, and an OpenBSD CVS tag |
<code>$OpenBSD$</code> |
<code>$OpenBSD$</code> |
</ul> |
</ul> |
|
|
Create dummy versions of the package files. Edit DESCR and COMMENT. |
Create dummy versions of the package files. Edit DESCR and COMMENT. |
<p>COMMENT is a <strong>SHORT</strong> one-line description of the port |
<p>COMMENT is a <strong>SHORT</strong> one-line description of the port |
(max. 60 characters). Do NOT include the package name (or version number |
(max. 60 characters). Do NOT include the package name (or version number |
of the software) in the comment. Do NOT start by an uppercase letter |
of the software) in the comment. Do NOT start with an uppercase letter |
unless semantically significant, do NOT end by a dot. |
unless semantically significant, do NOT end with a period. |
<p>DESCR is a longer description of the port. One to a few paragraphs |
<p>DESCR is a longer description of the port. One to a few paragraphs |
concisely explaining what the port does is sufficient. |
concisely explaining what the port does is sufficient. |
<p>PLIST is kept empty at this point. |
<p>PLIST is kept empty at this point. |
|
|
</pre> |
</pre> |
|
|
<li>Create pkg/PLIST<br> |
<li>Create pkg/PLIST<br> |
After the install is complete use the developers command: |
After the install is complete use the developer's command: |
<p><code>make plist</code> |
<p><code>make plist</code> |
<p>which makes a the file PLIST-auto in the pkg directory. This file |
<p>which makes the file PLIST-auto in the pkg directory. This file |
is a candidate packing list. Beware: the files are found by |
is a candidate packing list. Beware: the files are found by |
timestamp. This means it does NOT: |
timestamp. This means it does NOT: |
<ul> |
<ul> |
|
|
<p> |
<p> |
<li>uninstall and reinstall; repeat until perfect.<br> |
<li>uninstall and reinstall; repeat until perfect.<br> |
<em>Perfect</em> is when everything installs and uninstalls |
<em>Perfect</em> is when everything installs and uninstalls |
in its proper location. `<code>pkg_delete <pkg_name></code>' is |
in its proper location. `<code>pkg_delete <pkg_name></code>' is |
used to uninstall. `sudo make reinstall' is used to reinstall. See the |
used to uninstall. `sudo make reinstall' is used to reinstall. See the |
`<code>pkg_create</code>' man page for other commands that may be added |
`<code>pkg_create</code>' man page for other commands that may be added |
to PLIST to ensure all is cleaned up. After an uninstall the command |
to PLIST to ensure all is cleaned up. After an uninstall the command |
|
|
platforms (the DEC Alpha is good because it has only static libraries |
platforms (the DEC Alpha is good because it has only static libraries |
and because sizeof int != sizeof long; Sun SPARC is good because it is |
and because sizeof int != sizeof long; Sun SPARC is good because it is |
very common and because its byte order is the reverse of i386; if you |
very common and because its byte order is the reverse of i386; if you |
developed on SPARC, of course, y ou'd want it tested on i386). |
developed on SPARC, of course, you'd want it tested on i386). |
<P>The ports@openbsd mailing list is a good place to find porting-savy |
<P>The ports@openbsd mailing list is a good place to find porting-savy |
people with different platforms! |
people with different platforms! |
<li>Incorporate any feedback you get. Test it again on your platform. |
<li>Incorporate any feedback you get. Test it again on your platform. |