about summary refs log blame commit diff stats
path: root/RELEASE_GUIDE.md
blob: b267c83c1801b32fe59d89eebb5ccfd231251b71 (plain) (tree)
1
2
3
4
5
6
7
8
9
10
11










                                                                                                 
                                                       
                                                           



                                                                                        



                                                                                                              
                                                                                                                  
                                                                                                                                   

                       
                                                     

                     





                                                     
                                         




                        

                                                              


             
 
                                       

   
                             

   
                    

   



               

   
                              

   
                                                     

   
                                     

   
                            

   

                                                                

                                                

                   
                                                                          
                                                              
                                
                                                                
# Release Guide

Usually release candidates are tagged 0.6.0.rc1, 0.6.0.rc2 and tested for a week or so.

* Release libstrophe and libmesode if required

* 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)

* Update Inline command help (./src/command/cmd_defs.c)
* Check copyright dates in all files (Copywright 2012-2019)

* Generate HTML docs (the docgen argument only works when package status is development)
    `./profanity docgen`

* 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.

* Determine if libprofanitys version needs to be [increased](https://github.com/profanity-im/profanity/issues/973)
* Update plugin API docs (./apidocs/c and ./apidocs/python) need to run the `gen.sh` and commit the results to the website git repo
* Update CHANGELOG
* Update profrc.example
* Update profanity.doap (new XEPs and latest version)

## Creating artefacts
* Set the correct release version in configure.ac:

```
AC_INIT([profanity], [0.6.0], [boothj5web@gmail.com])
```

* Set the package status in configure.ac:

```
PACKAGE_STATUS="release"
```

* Add generated command manpages: `git add docs/profanity-*.1`

* Commit
* Tag (0.6.0)
* Push

* Configure to generate fresh Makefile:

```
./bootstrap.sh && ./configure
```

* Generate tarballs:

```
make dist
make dist-bzip2
make dist-xz
make dist-zip
```

* Set version to next release:

```
AC_INIT([profanity], [0.7.0], [boothj5web@gmail.com])
```

* Set the package status back to dev:

```
PACKAGE_STATUS="development"
```

* Remove generated command manpages: `git rm docs/profanity-*.1`

* Create a branch for patch releases (0.6.patch)
* Push

## Updating website
  * Make changes to the git repo including uploading the new artefacts at:
        https://github.com/profanity-im/profanity-im.github.io
  * Update profanity_version.txt
  * Take results from profanity.doap and put them into xeps.html