Making a tarball

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

Step 1: Preliminary testing

  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. 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. Bump version number in doc/sphinx/plastimatch.rst

  5. Regenerate man pages:

    sphinx-build -b man -d ~/work/web-plastimatch/.doctrees  ~/work/plastimatch/doc/sphinx ~/work/plastimatch/doc/man
    
  6. Push above changes to remote

  7. Tag version:

    git tag -a "v1.6.5" -m "Version 1.6.5"
    git push origin --tags
    
  8. Edit changelog on gitlab site.

Step 3: Making the final version

  1. Download tarball from gitlab.

  2. Repackage the tarball from hash-based to version-based.:

    tar xvf plastimatch-v1.7.0.tar.gz
    rm plastimatch-v1.7.0.tar.gz
    mv plastimatch-v1.7.0* plastimatch-1.7.0
    tar cjvf plastimatch-1.7.0.tar.bz2 plastimatch-1.7.0
    rm -rf plastimatch-1.7.0
    
  3. Unpack and test tarball on linux (don’t skip this step).

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

  5. Upload to sourceforge:

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