2019-01-15 07:57:05 -05:00
|
|
|
# Release Guide
|
|
|
|
|
2022-10-12 10:39:20 -04:00
|
|
|
* Release libstrophe if required
|
2019-01-15 07:57:05 -05:00
|
|
|
|
|
|
|
* Run Unit tests: `make check-unit`
|
|
|
|
* Run Functional tests - Currently disabled
|
|
|
|
* Run manual valgrind tests for new features
|
|
|
|
* Build and simple tests in Virtual machines ideally all dists including OSX and Windows (Cygwin)
|
|
|
|
|
2019-01-16 06:29:24 -05:00
|
|
|
* Update Inline command help (./src/command/cmd_defs.c)
|
2022-09-13 06:19:16 -04:00
|
|
|
* Check copyright dates in all files
|
2019-01-15 07:57:05 -05:00
|
|
|
|
|
|
|
* Generate HTML docs (the docgen argument only works when package status is development)
|
|
|
|
`./profanity docgen`
|
|
|
|
|
2020-12-04 11:29:31 -05:00
|
|
|
* Generate manpages for profanity commands (the mangen argument only works when package status is development)
|
|
|
|
`./profanity mangen`
|
|
|
|
These files should be added to the docs subfolder and added to git whenever a command changes.
|
|
|
|
|
2019-06-11 01:45:11 -04:00
|
|
|
* Determine if libprofanitys version needs to be [increased](https://github.com/profanity-im/profanity/issues/973)
|
2019-01-16 06:29:24 -05:00
|
|
|
* Update plugin API docs (./apidocs/c and ./apidocs/python) need to run the `gen.sh` and commit the results to the website git repo
|
2019-01-15 07:57:05 -05:00
|
|
|
* Update CHANGELOG
|
|
|
|
* Update profrc.example
|
2022-02-22 10:12:10 -05:00
|
|
|
* Update profanity.doap (new XEPs and latest version)
|
2019-01-15 07:57:05 -05:00
|
|
|
|
|
|
|
## Creating artefacts
|
|
|
|
* Set the correct release version in configure.ac:
|
|
|
|
|
|
|
|
```
|
|
|
|
AC_INIT([profanity], [0.6.0], [boothj5web@gmail.com])
|
|
|
|
```
|
|
|
|
|
2019-03-04 11:26:28 -05:00
|
|
|
* Set the package status in configure.ac:
|
2019-01-15 07:57:05 -05:00
|
|
|
|
|
|
|
```
|
|
|
|
PACKAGE_STATUS="release"
|
|
|
|
```
|
|
|
|
|
2021-01-09 02:34:44 -05:00
|
|
|
* Add generated command manpages: `git add docs/profanity-*.1`
|
|
|
|
|
2019-01-15 07:57:05 -05:00
|
|
|
* Commit
|
2022-09-13 06:19:16 -04:00
|
|
|
* Tag (0.1.2)
|
2019-01-15 07:57:05 -05:00
|
|
|
* Push
|
|
|
|
|
2019-03-04 11:26:28 -05:00
|
|
|
* Configure to generate fresh Makefile:
|
2019-01-15 07:57:05 -05:00
|
|
|
|
|
|
|
```
|
2019-03-04 11:26:28 -05:00
|
|
|
./bootstrap.sh && ./configure
|
2019-01-15 07:57:05 -05:00
|
|
|
```
|
|
|
|
|
2019-03-04 11:26:28 -05:00
|
|
|
* Generate tarballs:
|
2019-01-15 07:57:05 -05:00
|
|
|
|
|
|
|
```
|
2019-03-04 11:26:28 -05:00
|
|
|
make dist
|
|
|
|
make dist-bzip2
|
|
|
|
make dist-xz
|
|
|
|
make dist-zip
|
2019-01-15 07:57:05 -05:00
|
|
|
```
|
|
|
|
|
2021-08-25 21:17:42 -04:00
|
|
|
* Set the package status back to dev:
|
2019-01-15 07:57:05 -05:00
|
|
|
|
|
|
|
```
|
2019-03-04 11:26:28 -05:00
|
|
|
PACKAGE_STATUS="development"
|
2019-01-15 07:57:05 -05:00
|
|
|
```
|
|
|
|
|
2022-09-13 06:19:16 -04:00
|
|
|
* Remove generated command manpages:
|
|
|
|
`git rm docs/profanity-*.1`
|
|
|
|
`git checkout HEAD -- docs/profanity-ox-setup.1`
|
|
|
|
docs/profanity.1 and docs/profanity-ox-setup.1 are handwritten.
|
2021-01-09 02:34:44 -05:00
|
|
|
|
2019-03-04 11:26:28 -05:00
|
|
|
* Push
|
2019-01-15 07:57:05 -05:00
|
|
|
|
|
|
|
## Updating website
|
2021-08-25 21:17:42 -04:00
|
|
|
* Make changes to the git repo including uploading the new artefacts at:
|
2019-05-03 04:51:28 -04:00
|
|
|
https://github.com/profanity-im/profanity-im.github.io
|
2022-09-13 06:19:16 -04:00
|
|
|
* Add .xz and .zip tarballs to `tarballs` directory
|
|
|
|
* Copy `guide/latest` to `guide/newversion`
|
|
|
|
* Update tarball location and name in index.html
|
|
|
|
* Update checksums in index.html
|
2020-07-09 11:03:05 -04:00
|
|
|
* Update profanity_version.txt
|
2022-02-22 10:12:10 -05:00
|
|
|
* Take results from profanity.doap and put them into xeps.html
|