Annotation of www/checklist.html, Revision 1.50
1.14 rohee 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
1.1 marc 2: <html>
1.20 turan 3: <head>
4: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
5: <meta name="resource-type" content="document">
6: <meta name="description" CONTENT="How to make/update an OpenBSD port.">
7: <meta name="keywords" content="openbsd,ports">
8: <meta name="distribution" content="global">
1.41 horacio 9: <meta name="copyright" content="This document copyright 1998-2002 by OpenBSD.">
1.20 turan 10:
11: <title>OpenBSD Porting Checklist</title>
1.45 jsyn 12: </head>
1.20 turan 13:
1.22 rohee 14: <body text=Black bgcolor=White link="#23238E">
1.43 jsyn 15: <a href="index.html"><img alt="[OpenBSD]" height="30" width="141" src="images/smalltitle.gif" border="0"></a>
1.20 turan 16:
17: <h2><font color="#e00000">OpenBSD Porting Checklist</font></h2>
18:
19: This document describes how to make or upgrade a port. It is a useful
1.33 pvalchev 20: reminder of things to do. This is neither totally accurate nor perfect.
1.45 jsyn 21: Direct comments and questions to <a href="mailto:ports@openbsd.org">
22: ports@openbsd.org</a>.
1.20 turan 23:
24: <hr>
25: <ol>
26:
1.22 rohee 27: <li>
1.20 turan 28: If you want to be a maintainer, subscribe to
29: <a href="mailto:ports@openbsd.org"> ports@openbsd.org.</a>
30: <ul><li>
31: This is where all ports discussions take place.
32: <li>
33: Reading this list is important since many announcements go over this list.
34: <li>
1.33 pvalchev 35: You will find a lot of porting-savvy people there. They can often give you
1.20 turan 36: good advice or test ports for you.
37: </ul>
38:
1.22 rohee 39: <br><li>
1.29 espie 40: Being a maintainer means <strong>more</strong> than just submitting ports.
41: It also means trying to keep them up-to-date, and to answer questions about
42: them.
43:
1.45 jsyn 44: <br><br><li>
1.20 turan 45: Check out a copy of the ports tree from cvs.
1.33 pvalchev 46: You can find instructions on how to do this at
1.20 turan 47: <a href="http://www.openbsd.org/anoncvs.html">
48: http://www.openbsd.org/anoncvs.html</a>.
49:
1.22 rohee 50: <br><br><li>
1.20 turan 51: Pick a place to put your port and create the basic
52: infrastructure there. Use the template Makefile at
53: <code>/usr/ports/infrastructure/templates/Makefile.template</code>.
1.44 pvalchev 54: NEED_VERSION is obsolete and should not be used in new ports.
55: As you are a port developer, you are supposed to update
56: your ports tree, including bsd.port.mk.
1.20 turan 57: <ul><li>
1.49 cannings 58: Create the directory <code>pkg</code>.
1.20 turan 59: <li>
1.45 jsyn 60: Create the empty files <code>pkg/DESCR, pkg/PLIST</code>.
1.20 turan 61: </ul>
62:
1.22 rohee 63: <br><li>
1.20 turan 64: Add the fetch portions of the Makefile.
65: <ul><li>
1.37 pvalchev 66: Fill in EXTRACT_SUFX if it's anything besides .tar.gz. Other examples are
1.20 turan 67: .tar.Z, or .tgz.
68: <li>
1.45 jsyn 69: Fill in DISTNAME which is the name of the file minus the extract suffix.
70: E.g., if you have foo-1.0.tar.gz, DISTNAME is foo-1.0.
1.20 turan 71: <li>
72: Fill in MASTER_SITES which is a URL to the directory where the distfile
1.45 jsyn 73: is kept. E.g., ftp://ftp.openbsd.org/pub/OpenBSD/distfiles/.
74: <strong>Don't forget the trailing slash.</strong>
75: Try to have at least three distinct sites as well.
1.20 turan 76: Place the most easily accessible first as they are traversed in order.
77: <li>
78: Keep in mind that fetch references the file as
1.32 naddy 79: ${MASTER_SITES}${DISTNAME}${EXTRACT_SUFX}. All three are used. Don't
1.20 turan 80: set DISTNAME to point to the file directly.
81: <li>
1.33 pvalchev 82: You can check to see if you have filled these values in correctly by typing
1.45 jsyn 83: <b>make fetch-all</b>.
1.20 turan 84: </ul>
85: <p>
86: For more complex ports, you have more options and tools available to you:
87: <ul><li>
88: You also have the variable PATCHFILES available. This is a list of vendor
1.22 rohee 89: (not OpenBSD) patches to the port. Common uses are things like security
1.20 turan 90: or reliability fixes.
91: <li>
92: If your ports are available over large public mirrors such as GNU, SunSite, or
93: CPAN, we have already provided a list of sites for your use in
1.48 david 94: /usr/ports/infrastructure/templates/network.conf.template.
1.20 turan 95: Set MASTER_SITES to ${MASTER_SITE_GNU}, or ${MASTER_SITE_SUNSITE}, etc.
1.42 pvalchev 96: To simplify this process, use the construct ${MASTER_SITE_FOO:=subdir/} to
97: append the distribution subdirectory.
1.20 turan 98: <li>
99: Ports normally correspond to given versions of software. Once they are retrieved, files are checksummed and compared to the recorded
1.40 naddy 100: checksum(s) in distinfo. So, to avoid confusion, DISTFILES and PATCHFILES should have clearly visible version numbers:
1.20 turan 101: don't retrieve foo-latest.tar.gz if it is a link to foo-1.0.5.tar.gz. If necessary, gently ask the original program author
102: to make such distinctions clear.
103: <li>
104: If a given port needs more than about 5 DISTFILES + PATCHFILES to work, use DIST_SUBDIR to avoid cluttering
105: /usr/ports/distfiles too much.
106: <li>
107: DIST_SUBDIR must not include version numbers. When the port is updated to a later version, some distfiles may not change, but will be
108: refetched if DIST_SUBDIR is changed. Even if all distfiles change, it is easier for the user to track cruft.
109: <li>
110: All DISTFILES and PATCHFILES don't necessarily come from the same set of MASTER_SITES. Supplementary sites can be
111: defined using the variables MASTER_SITES0 to MASTER_SITES9. Just write DISTFILES=foo-1.0.5.tar.gz:5 to
112: retrieve foo-1.0.5.tar.gz from MASTER_SITES5.
113: <li>
114: Some ports don't always need to retrieve all files in all circumstances. For instance, some ports may have some compilation options, and
115: associated files which are only required in such a case. Or they may need some files for some architectures only. In such a case, those
116: supplementary optional files must be mentioned in the SUPDISTFILES variable. Targets such as makesum or
117: mirror-distfiles will fetch those supplementary files that the casual user doesn't need.
118: </ul>
1.1 marc 119:
1.22 rohee 120: <br><li>
1.40 naddy 121: Create a checksum in <i>distinfo</i> by typing <b>make makesum</b>.
1.45 jsyn 122: Then verify the checksum is correct by typing <b>make checksum</b>.
1.20 turan 123: <ul><li>
124: In some rare cases, files checksums can't be verified reliably. By all means, porters should try to find sites that are reliable. Communicating
125: with the software author and the archive site maintainer at this stage is highly desirable. In the worst case, non-checksummable files can be
126: mentioned in the IGNOREFILES variable.
127: <li>
128: All files in DISTFILES are usually processed during make extract. EXTRACT_ONLY may be used to limit extraction to a
129: subset of files (possibly empty). The customary use of this variable is to customize extraction: for instance, if some DISTFILES need
130: some special treatment, they will be removed from EXTRACT_ONLY and handled manually at post-extract stage.
131: For historic reasons, make extract does set up the working directory first along with extracting files. Thus, providing a
132: pre-extract or a do-extract target is highly unusual (and fairly suspicious behavior, indicative of a high degree of obfuscation
133: in the port).
134: <li>
135: Patches that need specific treatment should be mentioned in DISTFILES, and removed from EXTRACT_ONLY, for historic reasons.
136: </ul>
1.1 marc 137:
1.22 rohee 138: <br><li>
1.20 turan 139: Extract the port with <b>make extract</b>. Pay attention to where the base
1.38 pvalchev 140: of the sources are. Usually, it's <i>w-${PKGNAME}${FLAVOR_EXT}/${DISTNAME}</i>. You may need to
141: modify the Makefile's WRKDIST variable if it is different.
1.9 espie 142:
1.22 rohee 143: <br><br><li>
1.20 turan 144: Read the installation documentation and note what you have to do to build
145: the port and any special options that might be needed.
1.22 rohee 146:
147: <br><br><li>
1.20 turan 148: Now is also a good time to figure out what kind of licensing restrictions
1.33 pvalchev 149: apply to your port. Many are freely redistributable but then again, quite
1.20 turan 150: a few are not. We need four questions answered to distribute ports
151: properly. These are the PERMIT_* values in the Makefile.
152: <ul><li>
153: PERMIT_PACKAGE_CDROM tells us if we can put the package on the cdrom.
154: <li>
155: PERMIT_PACKAGE_FTP tells us if we can put the package on the ftp sites.
156: <li>
157: PERMIT_DISTFILES_CDROM tells us if we can mirror the distfiles on the cdrom.
158: <li>
159: PERMIT_DISTFILES_FTP tells us if we can mirror the distfiles on the ftp sites.
1.45 jsyn 160: </ul>
161: <p>
1.20 turan 162: Set these values to Yes if it is permitted or to a comment string stating why
163: it is not. Pay attention to any special conditions you may need to fulfill
1.45 jsyn 164: later on. E.g., some ports require to install a copy of the license. We
1.20 turan 165: recommend you place the license in <code>/usr/local/share/DISTNAME/</code>.
166:
1.22 rohee 167: <br><br><li>
1.20 turan 168: Add configuration options to Makefile and/or create the configuration script.
169: <ul><li>
170: You can add a port configuration script named `configure' to a directory
171: named <code>scripts/</code>. This will be run before any configuration
1.40 naddy 172: specified by CONFIGURE_STYLE is run.
1.20 turan 173: <li>
1.40 naddy 174: If GNU configure is used you may want to run ./configure --help
1.20 turan 175: to see what options are available.
176: <li>
177: Anything that you may want to override can be changed by adding the
178: --option flags to the CONFIGURE_ARGS parameter in the Makefile.
179: <li>
180: Use CONFIGURE_ARGS+= to append to the variable. CONFIGURE_ARGS= will
181: overwrite it.
182: </ul>
183:
1.22 rohee 184: <br><li>
1.20 turan 185: Try building the port with <b>make build</b>.
186: <ul><li>
187: If you're lucky, the port will go all the way through without errors.
188: <li>
189: If it exits with an error, you will need to generate patches for your port.
1.33 pvalchev 190: Figure out what needs to be changed and make a patch for it.
1.20 turan 191: <li>
192: Patches must be relative to ${WRKDIST}.
193: <li> The easiest way to reset the port and test your patches is
194: <b>make clean patch</b>. This will delete the work directory, re-extract,
195: and patch your port.
196: </ul>
197:
1.22 rohee 198: <br><li>
1.26 reinhard 199: Begin and cycle of <b>make build</b>, generate a patch (or use <b>make
200: update-patches</b>), and
1.20 turan 201: <b>make clean patch</b>.
202: <ul><li>
203: Patches go in the directory <i>patches/</i> and should be named patch-* with
204: * being something meaningful. We recommend you name your patches
1.26 reinhard 205: patch-FILENAME where FILENAME is the name of the file it is patching.
206: (<tt>make update-patches</tt> does this automatically for you.)
1.20 turan 207: <li>
208: Applying PATCHFILES is the first half of the make patch stage. It can be
209: invoked separately as make distpatch, which is a convenient target for
210: porters. Ignore this if you haven't set it.
211: <li>
212: Only patch one source file per patchfile, please,
213: <li>
1.40 naddy 214: Use <b>make update-patches</b> to generate patches,
1.20 turan 215: <li>
216: All patches MUST be relative to ${WRKDIST},
217: <li>
218: Check that patches <strong>DON'T</strong> contain tags that cvs
219: will replace. If they do, your patches won't apply after you check
220: them in. You can check in your changes with -kk to avoid this.
221: <li>
222: Add a small explanation of the patch role in the patchfile before
223: the patch itself, and an OpenBSD CVS tag <code>$OpenBSD$</code>.
224: <li>
225: <b>Please</b> feed your patches back to the author of that piece of software.
226: </ul>
227:
1.22 rohee 228: <br><li>
1.45 jsyn 229: Try setting <code>SEPARATE_BUILD</code>.
1.20 turan 230: <ul><li>
231: If the port can build with object files outside its source tree,
1.40 naddy 232: this is cleaner (many programs using <code>CONFIGURE_STYLE=gnu</code> can),
1.20 turan 233: and may help people who mount their ports tree on several arches.
234: <li>
235: This can also spare you some effort, as you will possibly be able to
236: restart the cycle at <code>configure</code> most of the time.
237: </ul>
238:
1.22 rohee 239: <br><li>
1.20 turan 240: Peruse the output (if any) and tweak any options in the Makefile.
241: To repeat issue the command `<b>make clean configure</b>'.
242: <p>
1.45 jsyn 243: Note: make sure host-dependent files go in <i>/etc</i> or
244: <i>/etc/<name></i>, but <strong>NEVER REPLACE OR MODIFY</strong>
245: existing files in <i>/etc</i>. Best to have install place them
1.20 turan 246: in <i>/usr/local/share/<name></i> and then copy to
247: <i>/etc</i> or <i>/etc/<name></i> only if the files do not exist.
248: If the files exist, display a message that says such-and-such files need
249: to be modified. This also guarantees that the files will be included in
1.40 naddy 250: the package since everything under <i>/usr/local</i> is included in the PLIST.
251: After a package has been installed the contents of <code>pkg/MESSAGE</code>
252: will be displayed if it exists.
1.20 turan 253:
254: <p>
255: The OpenBSD file locations are:
256: <pre>
1.1 marc 257: user executables: /usr/local/bin
258: system admin executables: /usr/local/sbin
259: program executables: /usr/local/libexec
260: libraries /usr/local/lib
1.14 rohee 261: architecture dependent data /usr/local/lib/<name>
1.1 marc 262: installed include files: /usr/local/include or
1.14 rohee 263: /usr/local/include/<name>
264: single-machine data: /etc or /etc/<name>
1.1 marc 265: local state: /var/run
1.35 brad 266: games score files: /var/games
1.1 marc 267: GNU info files: /usr/local/info
268: man pages: /usr/local/man/...
1.14 rohee 269: read-only architecture-independent: /usr/local/share/<name>
270: misc documentation: /usr/local/share/doc/<name>
1.20 turan 271: </pre>
1.9 espie 272:
1.22 rohee 273: <li>
1.20 turan 274: Begin a cycle of makes until the port is ready. Patch (see above)
275: clean, and make until the port is generated. Get rid of all warnings
276: if possible, especially security related warnings.
1.22 rohee 277:
278: <br><br><li>
1.20 turan 279: Control SEPARATE_BUILD semantics.
280: You have to do this only if the port builds with
281: SEPARATE_BUILD defined.
1.45 jsyn 282: Ideally, the port should not modify any file in
1.20 turan 283: ${WRKSRC} after <b>make patch</b>.
284: You can check this by making sure you don't have any write access
285: to ${WRKSRC}. Then you can set
1.45 jsyn 286: <code>SEPARATE_BUILD=concurrent</code> -- someone can use the same
1.20 turan 287: source tree to build on distinct arches simultaneously.
1.45 jsyn 288: Otherwise, set <code>SEPARATE_BUILD=simple</code> -- building on
289: distinct arches simultaneously may be met with problems, as some
1.20 turan 290: source files may be regenerated at awkward moments.
1.9 espie 291:
1.22 rohee 292: <br><br><li>
1.31 reinhard 293: Add <i>COMMENT</i> in Makefile.
1.20 turan 294: COMMENT is a <strong>SHORT</strong> one-line description of the port
1.24 espie 295: (max. 60 characters). Do <strong>NOT</strong> include the package
296: name (or version number of the software) in the comment.
297: Do <strong>NOT</strong> start with an uppercase letter
1.45 jsyn 298: unless semantically significant, and
1.24 espie 299: do <strong>NOT</strong> end with a period.
1.45 jsyn 300: <strong>DON'T EVER START WITH AN INDETERMINATE ARTICLE SUCH AS `a' or `as';
1.24 espie 301: remove the article altogether.</strong>
1.31 reinhard 302:
303: <br><br><li>
304: Edit <i>pkg/DESCR</i>, <i>pkg/PLIST</i>.
1.45 jsyn 305: <ul><li>
1.20 turan 306: DESCR is a longer description of the port. One to a few paragraphs
1.39 jufi 307: concisely explaining what the port does is sufficient. It is also advised to
1.46 pvalchev 308: wrap your lines at 72 characters. This can be done by first editing the DESCR
309: file and then running it through 'fmt -w 72'.
1.20 turan 310: <li>
311: PLIST is kept empty at this point.
312: </ul>
313:
1.22 rohee 314: <br><li>
1.45 jsyn 315: Install the application with <b>make install</b>.
1.20 turan 316: If the port installs dynamic libraries, check their symbol tables
317: with <code>nm</code>, as some mistaken software strips dynamic libraries,
1.34 jsyn 318: which may lead to weird failures later. On the other hand, executable binaries
319: SHOULD be stripped; <code>file</code> can be used to determine this. If the
320: port already contains code for stripping binaries, use it (i.e., an
321: 'install-strip' target); otherwise, add a provision in the port Makefile.
1.20 turan 322:
1.22 rohee 323: <br><br><li>
1.20 turan 324: <strong>Check port for security holes again</strong>. This is
325: especially important for network and setuid programs. See
1.50 ! jolan 326: <a href="porting.html#Security">our security recommendations</a>
1.20 turan 327: for that. Log interesting stuff and fixes in the
328: <code>pkg/SECURITY</code> file. This file
329: should list audited potential problems, along with relevant patches,
330: so that another person can see at first glance what has been done.
331: Example:
1.14 rohee 332: <pre>
333: $OpenBSD$
1.9 espie 334:
335: ${WRKDIR}/receiver.c
336: call to mktemp (wrapper function do_mktemp) does seem to be correct.
337:
338: The server makes extensive use of strlcpy/strlcat/snprintf.
1.20 turan 339: </pre>
340:
1.22 rohee 341: <li>
1.20 turan 342: Create pkg/PLIST. After the install is complete use the developer's command,
1.33 pvalchev 343: <b>make plist</b> which makes the file PLIST in the <i>pkg</i> directory.
1.20 turan 344: This file is a candidate packing list.
345: <p>
346: Beware! The files are found by timestamp. This means it does NOT:
1.45 jsyn 347: <ul><li>
1.20 turan 348: list any files installed with `tar' as their timestamp
1.45 jsyn 349: will not change and thus won't be found by `find'.
1.20 turan 350: <li>
351: Update the <code>info/dir</code> file if .info files are added.
352: Also, be sure that the <code>info/dir</code> is not part of the PLIST.
353: <li>
354: Try to do anything special with links or symbolic links. A
355: cursory test of tar shows it does the right thing with links
356: and symbolic links so I don't see why we need to special case
357: anything in the packing list. But still...
358: </ul>
359: <p>
1.33 pvalchev 360: Peruse `PLIST' and verify that everything was installed and
1.20 turan 361: that it was installed in the proper locations. Anything not installed
362: can be added to a port Makefile `post-install' rule.
363:
364: <p>
1.45 jsyn 365: Ports that install shared libraries will have another file called PFRAG.shared.
366: <ul><li>
1.33 pvalchev 367: PLIST describes the files being independent of whether the architecture supports shared libraries or not.
368: <li>
369: PFRAG.shared describes only the files being additionally installed on those architectures that support
1.20 turan 370: shared libraries.
371: <li>
1.33 pvalchev 372: PFRAG.noshared describes only the files being additionally installed on architectures that do not
373: support shared libraries.
1.20 turan 374: </ul>
375:
1.22 rohee 376: <br><li>
1.45 jsyn 377: Keep repeating uninstall and reinstall until perfect.
1.20 turan 378: <em>Perfect</em> is when everything installs and uninstalls
379: in its proper location. `pkg_delete <pkg_name>' is
380: used to uninstall. `sudo make reinstall' is used to reinstall. See the
381: `pkg_create' man page for other commands that may be added
1.45 jsyn 382: to PLIST to ensure all is cleaned up. After an uninstall the command:
383: <pre>
384: $ find /usr/local -newer w-${PKGNAME}${FLAVOR_EXT}/fake-${MACHINE_ARCH}[-${FLAVOR}]/.install_started -print
385: </pre>
386: should only list standard directory names.
1.20 turan 387:
1.22 rohee 388: <br><br><li>
1.45 jsyn 389: Test the packaging.
1.20 turan 390: After the port installs correctly issue the command
391: <code>make package</code> to create a package. To test the
392: package first do a <code>pkg_delete</code> and then do a
393: <code>pkg_add</code> The results after an add should EXACTLY
394: match the results after a `make install'.
1.9 espie 395:
1.22 rohee 396: <br><br><li>
1.20 turan 397: Mail <a href="mailto:ports@openbsd.org">ports@openbsd.org</a> with a short
398: note asking for comments and testing. Attach the port to this email and
1.30 espie 399: sent it out.
1.20 turan 400: <p>
401: Try to get others to test it on a variety of platforms for you.
402: <ul><li>
403: The DEC Alpha is good because it has only static libraries and because
1.45 jsyn 404: <code>sizeof(int) != sizeof(long)</code>.
1.20 turan 405: <li>
406: Sun SPARC is good because it is very common and because its byte order is
407: the reverse of i386; if you developed on SPARC, of course, you'd want it
1.45 jsyn 408: tested on i386.
1.20 turan 409: </ul>
410:
1.22 rohee 411: <br><li>
1.20 turan 412: Incorporate any feedback you get. Test it again on your platform.
413: Get those who gave you feedback to test it again from your new port.
414:
1.22 rohee 415: <br><br><li>
1.20 turan 416: Finally, include it in the "ports" tree.
417: If you do not have CVS access, ask someone on
1.30 espie 418: <a href="mailto:ports@openbsd.org">ports@openbsd.org</a> to commit it.
1.9 espie 419:
1.22 rohee 420: <br><br><li>
1.20 turan 421: If you are a developer with CVS access, check it in.
422: We normally use "import" for a new port,
423: rather than adding a zillion (or a dozen) files individually.
424: Import uses "vendor branch" version numbers like 1.1.1.1, but don't worry
425: about that! :-) If you make changes to a specific file (edit, then
426: cvs commit), it will be 1.2, and that will be used.
427: <p>
428: In short, import is typically used when a port is created.
429: From that point on cvs add and cvs rm are typically used to add or remove
430: files, and the normal edit->commit cycle for changes.
431: You might use something like this:
432: <pre>
1.45 jsyn 433: $ cd kaffe1
1.47 david 434: $ make clean # you really don't want to check in all of work!
1.45 jsyn 435: $ cvs -d cvs.openbsd.org:/cvs import -m 'kaffe port' ports/lang/kaffe1 \
1.4 ian 436: <I>YourName</I> <I>YourName_YYYY-MMM-DD</I>
1.20 turan 437: </pre>
438: <ul><li>
439: -d cvs.openbsd.org:/cvs says where cvs lives. This can be omitted if you
1.21 form 440: have a CVSROOT environment variable defined.
1.20 turan 441: <li>
442: -m 'kaffe port' is your login message. Change it to whatever you like
443: <li>
444: ports/lang/kaffe1 is the path relative to /cvs where the port lives
445: <li>
1.45 jsyn 446: <i>YourName</i> (replaced with your login name) is the 'vendor tag'.
1.20 turan 447: You imported it so you are the vendor.
448: <li>
449: <i>YourName_YYYY-MMM-DD</i> (e.g., ian_2000-Jan-01)
450: is the 'vendor release tag'. This is as good as any.
451: </ul>
1.45 jsyn 452: <br>
1.20 turan 453: As a real example, here is the output of checking in the Kaffe1 port,
454: which one of us did on September 8, 1998:
455: <pre>
1.4 ian 456: $ cd kaffe1
457: $ make clean >/dev/null
458: $ cvs import -m 'kaffe1.0(==JDK1.1) port' ports/lang/kaffe1 ian ian_1998-Sep-08
459: ian@cvs.openbsd.org's password: (not shown, obviously)
460: I ports/lang/kaffe1/CVS
461: I ports/lang/kaffe1/files/CVS
462: I ports/lang/kaffe1/pkg/CVS
463: N ports/lang/kaffe1/Makefile
464: cvs server: Importing /cvs/ports/lang/kaffe1/files
465: N ports/lang/kaffe1/files/md5
466: cvs server: Importing /cvs/ports/lang/kaffe1/pkg
467: N ports/lang/kaffe1/pkg/COMMENT
468: N ports/lang/kaffe1/pkg/DESCR
469: N ports/lang/kaffe1/pkg/PLIST
470:
471: No conflicts created by this import
472: $
1.20 turan 473: </pre>
474:
1.22 rohee 475: <li>
1.20 turan 476: Last but not least, add a one-line entry for the new port
1.45 jsyn 477: in its parent directory's Makefile, e.g., for ports/lang/kaffe1,
1.20 turan 478: add it to ports/lang/Makefile.
479:
1.22 rohee 480: <br><br><li>
1.20 turan 481: Maintain the port! As time goes by, problems may arise, or new versions
482: of the software may be released. You should strive to keep your port up
1.22 rohee 483: to date. In other words - iterate, test, test, iterate...
1.29 espie 484:
1.45 jsyn 485: <br><br><li>
1.29 espie 486: When updating a port, remember to handle dependencies! You shouldn't break any
487: port that depends on yours. In case of problems, communicate with the
488: maintainers of such ports. Likewise, be alert for dependency updates, and
489: check that the maintainer did their job.
1.22 rohee 490: </ol>
1.20 turan 491:
492: Thank you for supporting the OpenBSD "ports" process!
493: <hr>
494: <a href="porting.html"><img height=24 width=24 src=back.gif
495: border=0 alt=Porting></a>
496: <a href="mailto:www@openbsd.org">www@openbsd.org</a>
1.50 ! jolan 497: <br><small>$OpenBSD: checklist.html,v 1.49 2003/05/11 04:59:48 cannings Exp $</small>
1.20 turan 498: </body>
1.1 marc 499: </html>