Making a tarball

This section describes how to create an official packaged version of plastimatch.

Step 1: Preliminary testing

  1. Download tarball from gitlab:

    wget https://gitlab.com/plastimatch/plastimatch/-/archive/master/plastimatch-master.tar.gz

  2. Unpack and test tarball on linux (don’t skip this step)

  3. Unpack and test tarball on windows (don’t skip this step)

  4. Unpack and test tarball on mac (don’t skip this step)

  5. Test parallel regression tests (don’t skip this step):

    cd ~/build/plastimatch
ctest -j 16

Step 2: Marking the version

  1. Update CHANGELOG; Bump version number in CHANGELOG

  2. Bump version number in CMakeLists

  3. Bump version number in doc/sphinx/conf.py

  4. Also check copyright year range in doc/sphinx/conf.py

  5. Bump version number in doc/sphinx/plastimatch.rst

  6. Regenerate man pages:

    sphinx-build -b man -d ~/shared/web-plastimatch/.doctrees  ~/work/plastimatch/doc/sphinx ~/work/plastimatch/doc/man

  7. Push above changes to remote and tag version:

    export V=1.8.0
git commit -am "Version ${V}"
git push origin master
git tag -a "${V}" -m "Version ${V}"
git push origin --tags

  8. Edit changelog on gitlab site.

Step 3: Making the final version

  1. Download tarball from gitlab.

  2. Unpack and test tarball on linux (don’t skip this step).

  3. Unpack and test tarball on windows (don’t skip this step).

  4. Upload to sourceforge:

    sftp gregsharp@frs.sourceforge.net
cd /home/pfs/project/plastimatch/Source
put plastimatch-1.6.4.tar.bz2