Editing 9.1 Release Checklist

{{Note|'''Timeline''' (tentative)
* 2023-11-15 🚀 Release Kick-off ⚽ (default branch merged to stable)
* 2023-12-xx 🛠️ 1st release candidate '''9.0.90''' on https://alpha.gnu.org/gnu/octave/
* 2023-12-xx 🏁 Final Release 🎉 '''9.1.0''' on https://ftp.gnu.org/gnu/octave/}}

:Please use <code>&lt;strike&gt; &lt;/strike&gt;</code> to mark items below as done.

== 🚀 Kick-off ⚽ ==

=== 📢 Call for bug reports ===
:Completion Date:
* Put out a general call for reports on [https://octave.discourse.group/ Octave Discourse] for all outstanding unreported known bugs.
* Create Savannah tag '''9.0.90''' on bug tracker.
* Mark items that should be fixed for the release with this tag.
* Bug overview at https://octave.space/savannah/ .

=== 📢 Update GUI translation files ===
:Completion Date: 2023-11-28
* Call for updates that might change GUI strings.
* String freeze date: 2023-11-25
* Update language translation files (*.ts). 2023-11-24
* Create issue report on Savannah as a centralized location for uploading files. bug {{bug|63404}}
* Call for translations for GUI strings on maintainers@octave.org, CC-ing the translators (see [https://hg.savannah.gnu.org/hgweb/octave/file/tip/libgui/languages/translators list of translators]). [https://lists.gnu.org/archive/html/octave-maintainers/2023-11/msg00004.html message in mailing list archive]
* Collect and push all translated files. 

=== <strike> ⚙️ Update gnulib to latest version </strike> ===
:Completion Date: 2023-11-19
: <strike> Must occur first as it could resolve existing, or create new, bug reports. You should run <code>./bootstrap</code> in the source tree after updating to the new gnulib version. </strike>

=== ⚖️ GPL License activities ===
:Completion Date: 2023-12-13
* Update copyright statements for all source controlled files. 
* Update dates in any other locations (launch message, citation, MXE files, etc.). 
* Add any new contributors to {{Path|doc/interpreter/contributors.in}} who wish to be mentioned (don't add them without permission). 

=== ✅ Style-check code base ===
:Completion Date: 2023-12-6
: This will produce lots of whitespace changes, but no behavior changes. '''Must occur after patches have been added''', since whitespace changes can prevent patches from applying. 
* [[Octave style guide|m-file style check]] 
* [[C++ style guide|C++ style check]] 

=== 📖 Review documentation ===
:Completion Date: 2023-12-14
* Grammar check documentation. 
* Spell check documentation. 
* Verify no functions missing from manual. 
* Verify deprecated functions removed from "see also" links. 
* Verify all formats (Info, HTML, PDF) build correctly. 
* Review {{Path|NEWS}} for any features which should be announced. 
* Review {{Path|__unimplemented__.m}} for the latest changes to [[Octave Forge]] packages and new Matlab functions. 
* Update major version number in "@subtitle Edition XXX" in {{Path|octave.texi}}. 
* Update {{Path|[https://hg.octave.org/mxe-octave/file/tip/installer-files/README.html installer-files/README.html]}} in MXE Octave with version highlights. 

== 🔃 Repeat until all bugs are resolved ==
:Completion Date first iteration:

=== ⚠️ Current state at Savannah ===

* Bug overview at https://octave.space/savannah/ .

=== ✅ <code>make check</code> ===
* Verify <code>make check</code> is passing on all [http://buildbot.octave.org:8010/#/waterfall buildbot combinations of OS and compilers] and [https://github.com/gnu-octave/octave/actions GitHub CI runners]. Also check [https://github.com/gnu-octave/octave-buildbot/actions test suite runs on "freshly brewed Octave for Windows"] (Kai's buildbots on octave.space).
* Compiling with <code>-fsanitize=undefined</code>, <code>--enable-address-sanitizer-flags</code> to check for memory leaks. Use other tools <code>cppcheck</code>, etc. 
** Update PVS static analyzer results [[PVS static analyzer - 5.0 Release]].
** Or use any static analyzer, such as Clang's `scan-build make all`.
* Start discussion on maintainers@octave.org about which failing tests that must be fixed and which can be declared '''WON'T FIX'''.

=== 🛠️ Create new release candidate ===
* Ensure correct [[#Versioning hints|version information]].
* Create hg tag in repository with release candidate version number.
* Verify <code>make distcheck</code> passes. 
* Verify <code>make dist</code> works. 
* Create [[Windows Installer]].
* Upload release candidates.
* Check [[Windows Installer]] (executable and zip formats) against false positive detection at [https://virustotal.com virustotal.com]
* Add release candidate version to Savannah bug tracker.
* Announce release candidate to [https://octave.discourse.group/ Octave Discourse].

== 🏁 Final Release 🎉 ==

=== 📃 Update version information ===
:Completion Date:
* Ensure correct [[#Versioning hints|version information]].
* Create hg tag in repository with release version number.
* Update {{Path|NEWS}} (final release date).
* Update {{Path|CITATION}} (version, year, URL).
* Update {{Path|org.octave.Octave.appdata.xml}} (version number and release date).
* Update Savannah bug tracker version info.
* Update Savannah bug tracker: '''OPEN''' bugs marked as '''WON'T FIX''' should be marked as '''CONFIRMED''' (or more appropriate) for the final release.
* Remove release candidate versions from Savannah.

=== 📢 Announce final release ===
:Completion Date:
* Octave mailing-lists
* Octave web site (https://hg.octave.org/web-octave)
** Steps documented in [https://hg.octave.org/web-octave/rev/fe59d0118a2b this changeset].
** Upload documentation (manual HTML + PDF {{Path|octave.org/doc}} and version in {{Path|octave.org/.htaccess}}, Doxygen {{Path|octave.org/doxygen}})
* This wiki
** [[Template:Release]] = {{Release}}
** [[Template:Release Date]] = {{Release Date}}
** [[Template:Release Year]] = {{Release Year}}

== ☑️ Post-Release ==
:Completion Date:
* Remove all deprecated functions (either tagged with <code>OCTAVE_DEPRECATED</code> in C++ or in the directory <code>scripts/deprecated</code> for m-files) scheduled for deletion on default branch. Check file <code>etc/NEWS.VERSION-2.md</code> for list of features that have been deprecated. 
* Create new <code>etc/NEWS.VERSION+1.md</code> file by copying <code>etc/NEWS.VERSION.md</code> and then removing text so that it is a template file with headings only. 

== ℹ️ Versioning hints ==

{{Note|Read [https://hg.savannah.gnu.org/hgweb/octave/file/tip/etc/HACKING.md <code>etc/HACKING.md</code>] carefully!!}}

* Update {{Path|configure.ac}}:
** <code>AC_INIT</code>
** <code>OCTAVE_API_VERSION</code>
** <code>OCTAVE_MAJOR/MINOR/PATCH_VERSION</code>
** <code>OCTAVE_RELEASE_DATE</code>
* Update libtool versioning:
** {{Path|liboctave/module.mk}} <code>%canon_reldir%_%canon_reldir%_current</code>
** {{Path|libinterp/module.mk}} <code>%canon_reldir%_liboctinterp_current</code>
** {{Path|libgui/module.mk}} <code>%canon_reldir%_liboctgui_current</code>

[[Category:Releases]]