Bug 30427 - Debian packages only include release notes for Koha 3.x
Summary: Debian packages only include release notes for Koha 3.x
Status: CONFIRMED
Alias: None
Product: Koha
Classification: Unclassified
Component: Packaging (show other bugs)
Version: Main
Hardware: All All
: P5 - low minor
Assignee: Bugs List
QA Contact: Testopia
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2022-03-31 23:42 UTC by David Cook
Modified: 2026-01-22 20:24 UTC (History)
3 users (show)

See Also:
GIT URL:
Initiative type: ---
Sponsorship status: ---
Comma delimited list of Sponsors:
Crowdfunding goal: 0
Patch complexity: ---
Documentation contact:
Documentation submission:
Text to go in the release notes:
Version(s) released in:
Circulation function:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description David Cook 2022-03-31 23:42:33 UTC
If you look in /usr/share/doc/koha-common, you'll only see release notes for Koha 3.x

It looks like it's because of the following line in the debian/ packaging instructions:

debian/koha-common.docs:misc/release_notes/release_notes_3*.txt
Comment 1 Katrin Fischer 2023-08-04 19:13:57 UTC
Could someone check on a package installation if this is still true?
Comment 2 Katrin Fischer 2023-08-04 19:14:32 UTC
(In reply to Katrin Fischer from comment #1)
> Could someone check on a package installation if this is still true?

I realize this bug is much newer than bug 7750 which mentioned it for the first time.
Comment 3 David Cook 2023-08-06 23:23:48 UTC
(In reply to Katrin Fischer from comment #1)
> Could someone check on a package installation if this is still true?

100% still true for on a 22.11 install. They're totally missing from koha-testing-docker but that looks unrelated.

dpkg -L koha-common | less

/usr/share/doc/koha-common/release_notes_30000.txt.gz
/usr/share/doc/koha-common/release_notes_30000alpha.txt.gz
/usr/share/doc/koha-common/release_notes_30000beta.txt.gz
/usr/share/doc/koha-common/release_notes_30000stableRC1.txt.gz
/usr/share/doc/koha-common/release_notes_30001.txt.gz
/usr/share/doc/koha-common/release_notes_30002.txt.gz
/usr/share/doc/koha-common/release_notes_30003.txt.gz
/usr/share/doc/koha-common/release_notes_30004.txt.gz
/usr/share/doc/koha-common/release_notes_30005.txt.gz
/usr/share/doc/koha-common/release_notes_3_10_0.txt.gz
/usr/share/doc/koha-common/release_notes_3_12_0.txt.gz
/usr/share/doc/koha-common/release_notes_3_14_0.txt.gz
/usr/share/doc/koha-common/release_notes_3_16_0.txt.gz
/usr/share/doc/koha-common/release_notes_3_18_0.txt.gz
/usr/share/doc/koha-common/release_notes_3_20_0.txt.gz
/usr/share/doc/koha-common/release_notes_3_22_0.txt.gz
/usr/share/doc/koha-common/release_notes_3_2_0.txt.gz
/usr/share/doc/koha-common/release_notes_3_4_0.txt.gz
/usr/share/doc/koha-common/release_notes_3_6_0.txt.gz
/usr/share/doc/koha-common/release_notes_3_8_0.txt.gz

The reason is the following:

grep -R "release_notes" debian/*
debian/koha-common.docs:misc/release_notes/release_notes_3*.txt
debian/koha-core.docs:misc/release_notes/release_notes_3*.txt
Comment 4 David Cook 2023-08-06 23:24:55 UTC
It would be an easy fix. It's just super low on the priority list.
Comment 5 David Cook 2026-01-20 01:31:19 UTC
In misc/release_notes it looks like we actually have release notes going back to 2.0 as well.

I don't know if we want to include those going forward, or if we just stay with 3.* and then add the *.html and *.md release notes...
Comment 6 Katrin Fischer 2026-01-20 17:22:28 UTC
I think it would make sense to fix this - currently the packages don't contain the release notes of the most current versions, which certainly should be included.
Comment 7 David Cook 2026-01-20 23:29:07 UTC
(In reply to Katrin Fischer from comment #6)
> I think it would make sense to fix this - currently the packages don't
> contain the release notes of the most current versions, which certainly
> should be included.

Yay!

I think the question is... do we want to include all the release notes? Or just 3.x and onwards? There's probably no harm in including all of theM?
Comment 8 Katrin Fischer 2026-01-22 20:24:21 UTC
(In reply to David Cook from comment #7)
> (In reply to Katrin Fischer from comment #6)
> > I think it would make sense to fix this - currently the packages don't
> > contain the release notes of the most current versions, which certainly
> > should be included.
> 
> Yay!
> 
> I think the question is... do we want to include all the release notes? Or
> just 3.x and onwards? There's probably no harm in including all of theM?

I would assume the same.