Submission Guidelines

The SlackBuilds.org project is maintained by a small group of people, but we want the scripts in our repository to be representative of the entire Slackware user community. There's no way that the few of us can possibly write scripts for all of the extra applications that users want to have, so we depend on YOU to help us out. If there's some application that you use, and we don't have it in our repository already, please consider writing a build script for it and submitting it to us for possible inclusion. See below for our submission requirements.

Submit scripts for possible inclusion using our SlackBuilds Upload Form, but make sure you follow the guidelines below. Do not include the source code or your upload will be rejected.

Before expending time and effort in writing a build script, be sure to search our repository to make sure one doesn't already exist. Also, you may wish to have a look at the pending queue to see if someone else has already submitted what you're planning to do.

You will still need to read the list of requirements, but we have SlackBuild Script Templates available if you would like to download them for easy editing.

All submissions should be an archive, compressed or uncompressed - either one is fine - (tar, tar.gz, or tar.bz2) of a directory (named according to the application's name) containing at least the following files:

$PRGNAM.SlackBuild (for instance, rdesktop.SlackBuild)
slack-desc
README
$PRGNAM.info (for instance, rdesktop.info)

$PRGNAM.SlackBuild Requirements

• Follow our template scripts as much as possible. Deviations are fine where needed, but don't change things to be "more clever" or some such - we like consistency
• You will need to note the author of the script and add licensing information (if you choose to do so). The only requirement we have for licensing is this: if you choose to license your script, the license must be open-source and allow for modification and redistribution of the modified version.
  • If you wish to license your scripts under a GPL or variant, then be sure to include a copy of the license with your submission if the license requires it. We don't encourage these licenses, as the license is often much longer than the script itself, but that's your call.
  • If you do not specify a license, then your submission is assumed to be public domain, and as such, anyone can freely modify and/or distribute it with no restrictions. If you do not include licensing information, you can note the author of the script using a format something like this:

    # Written by (your name) (your contact information)

The README file

The README file should contain at least the following information:

1. A descripton of the application. The most common way to do this is by including the contents of the slack-desc file (without the "$PRGNAM:" portion), but you may deviate from this if needed. Have a look at some of the other README files to get an idea of what is expected.
2. Any application and/or library dependencies that are not included in the official Slackware package set; you should also note the home page of the dependencies.
3. Any other relevant information that might be useful to someone using the script:
   • Is special configuration needed before building the package?
   • Is special configuration needed after installing the package?
   • Is this application incompatible with some other application?

The $PRGNAM.info file

The info file should contain the following information in the exact format given below:

• PRGNAM="(name of application)"
• VERSION="(version of application)"
• HOMEPAGE="(homepage of application)"
• DOWNLOAD="(direct download link(s) of application source tarball(s),
  arch-independent or x86)"
• MD5SUM="(md5sum(s) of the source tarball(s) defined in DOWNLOAD)"
• DOWNLOAD_x86_64="(direct download link(s) of application source tarball(s), x86_64 only)"
• MD5SUM_x86_64="(md5sum(s) of the source tarball(s) defined in DOWNLOAD_x86_64)"
• MAINTAINER="(name of SlackBuild script maintainer)"
• EMAIL="(email address of author)"

For example, see the following rdesktop.info file:

PRGNAM="rdesktop"
VERSION="1.4.1"
HOMEPAGE="http://rdesktop.org"
DOWNLOAD="http://downloads.sourceforge.net/rdesktop/rdesktop-1.4.1.tar.gz"
MD5SUM="78dd2bae04edf1cb9f65c29930dcc993"
DOWNLOAD_x86_64=""
MD5SUM_x86_64=""
MAINTAINER="Robby Workman"
EMAIL="rworkman@slackbuilds.org"
APPROVED=""

Pay attention to the fact that all values are enclosed in double quotes; this is a requirement. Other double quotes embedded in the string are not allowed.

Note that the MD5SUM entry contains only the actual checksum rather than the full output of the md5sum command.

Note that the MAINTAINER entry is subject to change; the author of the script should be noted in the actual script itself, and while it will often (usually) be the same as the MAINTAINER, this allows a script author to turn over maintenance of the script to another individual.

If the source tarball is the same for all archs, leave DOWNLOAD_x86_64 and MD5SUM_x86_64 empty. If the application does not build on one of the supported architectures, mark it as UNSUPPORTED like this:

DOWNLOAD="UNSUPPORTED"

or

DOWNLOAD_x86_64="UNSUPPORTED"

In this case you can leave the respective MD5SUM entry empty.
If the application does not build on a clean Slackware64 system, but would if there were 32bit compatibility libraries present at build time, you can mark it as UNTESTED:

DOWNLOAD_x86_64="UNTESTED"

If an application requires multiple source downloads, you can define it like this:

DOWNLOAD="dl1 dl2 dl3"
MD5SUM="md5_of_dl1 md5_of_dl2 md5_of_dl3"

Other concerns

• No custom patches unless absolutely necessary; if at all possible, we want to maintain the Slackware philosophy of distributing "clean" stuff - if it's not in the upstream sources, then it probably doesn't need to be in our scripts. However, we are a bit more liberal about this than Pat is - if a patch (or set of patches) makes the packaging process easier or more efficient, we'll often include the patches.
  
  
• As a general rule, we do not accept SlackBuild scripts of software that is included as part of Slackware; however, exceptions may be made by the admin staff on a case-by-case basis.

Once you're certain that your script meets our guidelines, submit it using the SlackBuilds Upload Form.