HAP wiki

How I have published HAP 1.24:

1. Call release script from ReleaseTools with --no-push option (on my machine it has a symlink called gap-package-release - your setup may vary)

$ gap-package-release --no-push
Extracting information from PackageInfo.g...
Package HAP 1.24
Building GAP package documentation (using makedoc.g)
Using archive basename hap-1.24
Using GitHub repository gap-packages/hap
Using GitHub username gap-packages
Publishing on branch master
Creating git tag v1.24

Exporting repository content for tag 'v1.24'
Removing unnecessary files
Building GAP package documentation for archives (using makedoc.g)

Validating PackageInfo.g...
Pushing your branch to GitHub
Counting objects: 8, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (6/6), done.
Writing objects: 100% (8/8), 685 bytes | 685.00 KiB/s, done.
Total 8 (delta 4), reused 0 (delta 0)
remote: Resolving deltas: 100% (4/4), completed with 4 local objects.
To https://github.com/gap-packages/hap
   9b4565d..2a1af39  master -> master
Pushing your tag to GitHub
Total 0 (delta 0), reused 0 (delta 0)
To https://github.com/gap-packages/hap
 * [new tag]         v1.24 -> v1.24
Creating new release v1.24 on GitHub

Creating hap-1.24.tar.gz ...
Uploading hap-1.24.tar.gz with mime type application/x-gzip
######################################################################## 100.0%
Updating website
remote: Enumerating objects: 15, done.
remote: Counting objects: 100% (15/15), done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 8 (delta 4), reused 8 (delta 4), pack-reused 0
Unpacking objects: 100% (8/8), done.
From github.com:gap-packages/hap
   9b4565d..2a1af39  master     -> origin/master
 * [new tag]         v1.24      -> v1.24
Already up-to-date.
cp: /Users/alexk/GITREPS/pkg/hap/tmp/hap-1.24/doc/*.css: No such file or directory

This published the release, but then terminates with an error while trying to update gh-pages, because the manual does not have .css file (as well as .js). That should be fixed. For now, we will fix this manually - anyway we need a manual step because www is not a part of a standard setup, so it's not handled automatically, as well as doc/tutorial.

2. Fixing gh-pages:

cd gh-pages
cp -f ../PackageInfo.g ../README* .
cp -f ../doc/*.{html,txt} doc/
cp -f ../doc/tutorial/*.{css,html,txt} doc/tutorial/
cp -f -r ../www .
gap update.g
git commit -a -m "Update website for HAP 1.24"
git push

Note that doc/tutorial has .css but not .js files. This should also be fixed. After that the procedure to update gh-pages will be simplified.