Previous: , Up: Installation   [Index]


1.7 Distributing

Due to the licensing conditions of C-INTERCAL, you are allowed to release your own version or distribution if you want to. In such cases, it’s recommended that you follow the following guidelines:

  1. Make sure the new version is based on the most recent existing version. Looking at the alt.lang.intercal newsgroup will normally let you know what version is most recent.
  2. Increment the version number; if you add any new features, increment the major version number (after the decimal point) and drop the minor version number (before the decimal point) to 0, and otherwise increment the minor version number. You have to update the version number in the following files: configure.ac, configure, and doc/ick.txi. You also have to rename the installation directory to reflect the new version number.
  3. Add an entry to the NEWS file explaining what’s new in the version that you’re releasing, following the same format as the other entries.
  4. Update the README with a description of any new files you may have added.
  5. Remove any autosave or backup files that may be littering the installation directory or its subdirectories.
  6. Run make distcheck, which will make the distribution paxballs, and rename them to have the correct extensions (Automake thinks they’re tarballs, so will use ‘.tar’ rather than ‘.pax’, and you have to fix this by hand). make distcheck will also perform some sanity checks on the build system of the resulting paxball, which will help to ensure that nothing important is missing from it; and some regression tests on a version of C-INTERCAL built from the distribution tarball itself, to prove that it runs correctly and produces plausible output. (A failure of the regression checks will not stop the build, but should stop you distributing the resulting compiler.)
  7. Place the new version somewhere on the Internet, and announce the location and the fact that a new version has been released on alt.lang.intercal.

Previous: , Up: Installation   [Index]