| Revision History | ||
|---|---|---|
| Revision 1 | 20 April 2001 | jm - [email protected] |
| Created. | ||
Abstract
Many Mac OS X users are enthusiastically porting their favorite Unix tools and utilities to Mac OS X not only for themselves but also to share with the rest of the Apple science community. This HOWTO provides some guidelines for how to distribute tools you've created. While some of the email addresses and such are aimed at scientific applications, most of these tips do apply to any UNIX software
Check with the original source code developers or documentation to be sure that you are complying with the terms of their license.
Do some testing of your precompiled binary under the latest version of Mac OS X. Pass it around to your colleagues for their assessment.
If all goes well, create a package. Either a .tar.gz, .pkg.sit or a dmz.sit file as appropriate. Include in the root:
Your own README
All the required source code
Your Makefile
The precompiled binary
A folder containing
The original docs for the software
Original READMEs
Any original license or notification docs
Your README file should contain:
Your name
A short description of what the software does.
Your permanent e-mail address (Yes, fame requires some publicity!)
Makefile and installation notes if required
Known issues and workarounds if required
A URL if you've created a home for this port on the Internet. For example: http://www.slac.stanford.edu/~benc/root/index.html.
When the package is ready, post it in the appropriate Mac OS X category at http://www.stepwise.com/softrak. After posted, it will have its own URL there.
Notify the Apple SciTech team with an e-mail both at <[email protected]> and <[email protected]>. Provide the software title, short description, and the Softrak URL.
Finally. (Yes, fame requires administrivia!). Post information about the port in Apple's Macintosh Product Guide (MPG) here: http://submit.macsoftware.apple.com/usupdate/upindex.html. Where it asks for the product URL, use the Softrak URL created when you posted it there. This step is very important because the MPG is a searchable database.
Optionally, you may want to notify the Apple mail lists (http://lists.apple.com/scitech and http://lists.apple.com/darwin-development) as well as other Macintosh news organizations on the Internet.
Happy porting!