#1090956 debhelper: support CHANGELOG.org as changelog

#1090956#5
Date:
2024-12-21 01:25:37 UTC
From:
To:
Dear Maintainer,

It would be great that if dh_installchangelogs can support CHANGELOG.org
as changelog.

A bit background: CHANGELOG.org is a type of changelog file in Org mode
format[1].  This is becoming more and more commonly used by many Emacs
addon packages, such as dap-mode, corfu, dape, vertico, etc.  It would
be great that dh_installchangelogs can support CHANGELOG.org OOTB so
that maintainers can avoid manual handling.

The change is trivial and I have made an MR at [2].  PTAL.  TIA!

[1] https://orgmode.org/
[2] https://salsa.debian.org/debian/debhelper/-/merge_requests/130

#1090956#12
Date:
2024-12-29 12:38:55 UTC
From:
To:
Xiyue Deng:

Hi,

I am happy to add `CHANGELOG.org` to the list provided we have data on
how many false positives it would have. Basically, how many packages
have a `CHANGELOG.org` that is not an org-mode changelog (or where a
different changelog would be a better fit).

I think an `apt-file search` through the source indices (or reading the
Contents files) might be the most reliable option.

Depending on the results, I would either enable it unconditionally or
conditionally.

Best regards,
Niels

#1090956#17
Date:
2024-12-29 12:38:55 UTC
From:
To:
Xiyue Deng:

Hi,

I am happy to add `CHANGELOG.org` to the list provided we have data on
how many false positives it would have. Basically, how many packages
have a `CHANGELOG.org` that is not an org-mode changelog (or where a
different changelog would be a better fit).

I think an `apt-file search` through the source indices (or reading the
Contents files) might be the most reliable option.

Depending on the results, I would either enable it unconditionally or
conditionally.

Best regards,
Niels

#1090956#22
Date:
2024-12-30 23:32:09 UTC
From:
To:
Hi Niels,

Niels Thykier <niels@thykier.net> writes:

Sounds reasonable.  I tried searching using apt-file and the results are
below:

,----
| $ apt-file -x search "(changelog|CHANGELOG).org"
| elpa-corfu: /usr/share/doc/elpa-corfu/CHANGELOG.org.gz
| elpa-dap-mode: /usr/share/doc/elpa-dap-mode/CHANGELOG.org.gz
| elpa-dape: /usr/share/doc/elpa-dape/CHANGELOG.org.gz
`----

Which seems too few.  I then searched on Debian codesearch[1], and it
looks like all hits are actual changelogs in org mode, and there are
other packages also manually handling this either through
dh_installchangelogs or through other means.  To be extra careful, I
also searched for the lower case "changelog.org" and the only hit is
from clj-http-clojure[2] which is also in org mode.

Hopefully this can help clear the potential false positive doubts.

[1] https://codesearch.debian.net/search?q=CHANGELOG.org
[2] https://sources.debian.org/src/clj-http-clojure/3.12.3-2/

#1090956#27
Date:
2024-12-30 23:32:09 UTC
From:
To:
Hi Niels,

Niels Thykier <niels@thykier.net> writes:

Sounds reasonable.  I tried searching using apt-file and the results are
below:

,----
| $ apt-file -x search "(changelog|CHANGELOG).org"
| elpa-corfu: /usr/share/doc/elpa-corfu/CHANGELOG.org.gz
| elpa-dap-mode: /usr/share/doc/elpa-dap-mode/CHANGELOG.org.gz
| elpa-dape: /usr/share/doc/elpa-dape/CHANGELOG.org.gz
`----

Which seems too few.  I then searched on Debian codesearch[1], and it
looks like all hits are actual changelogs in org mode, and there are
other packages also manually handling this either through
dh_installchangelogs or through other means.  To be extra careful, I
also searched for the lower case "changelog.org" and the only hit is
from clj-http-clojure[2] which is also in org mode.

Hopefully this can help clear the potential false positive doubts.

[1] https://codesearch.debian.net/search?q=CHANGELOG.org
[2] https://sources.debian.org/src/clj-http-clojure/3.12.3-2/

#1090956#32
Date:
2024-12-31 07:48:57 UTC
From:
To:
Xiyue Deng:

You would need to use apt-file's -Idsc index. Though it is disabled by
default (check with `apt-file list-indices`). Enable with:

```
sudo tee /etc/apt/apt.conf.d/60-local-apt-file.conf <<EOF
Acquire::IndexTargets::deb-src::Contents-dsc::DefaultEnabled "true";
EOF
sudo apt update
```

What I do not like about codesearch for this is that is only finds
mentions of the file (not the file itself). It is not very helpful for
figuring out if changelog.org will shadow an existing changelog
(dh_installchangelogs also looks for HISTORY and NEWS files).


Best regards,
Niels

#1090956#37
Date:
2024-12-31 07:48:57 UTC
From:
To:
Xiyue Deng:

You would need to use apt-file's -Idsc index. Though it is disabled by
default (check with `apt-file list-indices`). Enable with:

```
sudo tee /etc/apt/apt.conf.d/60-local-apt-file.conf <<EOF
Acquire::IndexTargets::deb-src::Contents-dsc::DefaultEnabled "true";
EOF
sudo apt update
```

What I do not like about codesearch for this is that is only finds
mentions of the file (not the file itself). It is not very helpful for
figuring out if changelog.org will shadow an existing changelog
(dh_installchangelogs also looks for HISTORY and NEWS files).


Best regards,
Niels

#1090956#42
Date:
2024-12-31 08:24:09 UTC
From:
To:
Niels Thykier <niels@thykier.net> writes:

Ah didn't know about this.  This is another search after setting up the
new configuration:

,----
| $ apt-file search -Idsc -i changelog.org
| avy: /.pc/fix-documentation.diff/doc/Changelog.org
| avy: /doc/Changelog.org
| clj-http-clojure: /changelog.org
| clj-http-clojure: /changelog.org_archive
| consult-el: /CHANGELOG.org
| dap-mode: /CHANGELOG.org
| emacs-corfu: /CHANGELOG.org
| emacs-dape: /CHANGELOG.org
| emacs-ivy: /doc/Changelog.org
| emacs-jabber: /CHANGELOG.org
| emacs-lsp-ui: /CHANGELOG.org
| embark: /CHANGELOG.org
| f-el: /CHANGELOG.org
| gnuplot-mode: /CHANGELOG.org
| hydra-el: /doc/Changelog.org
| lsp-mode: /CHANGELOG.org
| marginalia: /CHANGELOG.org
| mescc-tools: /CHANGELOG.org
| modus-themes: /CHANGELOG.org
| pimd: /ChangeLog.org
| python-pbcore: /CHANGELOG.org
| restart-emacs: /Changelog.org
| treemacs: /Changelog.org
| vertico: /CHANGELOG.org
`----

The packages clj-http-clojure, mescc-tools, pimd, python-pbcore are not
maintained by the Emacsen team, but the changelog files are also in org
mode (clj-http-clojure[1], mescc-tools[2], pimd[3], python-pbcore[4].)
PTAL.

Ack.  Indeed.

[1] https://salsa.debian.org/clojure-team/clj-http-clojure/-/blob/debian/main/changelog.org?ref_type=heads&plain=1
[2] https://salsa.debian.org/debian/mescc-tools/-/blob/debian/latest/CHANGELOG.org?ref_type=heads&plain=1
[3] https://github.com/bobek/pkg-pimd/blob/debian/sid/ChangeLog.org?plain=1
[4] https://salsa.debian.org/med-team/python-pbcore/-/blob/master/CHANGELOG.org?ref_type=heads&plain=1

#1090956#47
Date:
2024-12-31 08:24:09 UTC
From:
To:
Niels Thykier <niels@thykier.net> writes:

Ah didn't know about this.  This is another search after setting up the
new configuration:

,----
| $ apt-file search -Idsc -i changelog.org
| avy: /.pc/fix-documentation.diff/doc/Changelog.org
| avy: /doc/Changelog.org
| clj-http-clojure: /changelog.org
| clj-http-clojure: /changelog.org_archive
| consult-el: /CHANGELOG.org
| dap-mode: /CHANGELOG.org
| emacs-corfu: /CHANGELOG.org
| emacs-dape: /CHANGELOG.org
| emacs-ivy: /doc/Changelog.org
| emacs-jabber: /CHANGELOG.org
| emacs-lsp-ui: /CHANGELOG.org
| embark: /CHANGELOG.org
| f-el: /CHANGELOG.org
| gnuplot-mode: /CHANGELOG.org
| hydra-el: /doc/Changelog.org
| lsp-mode: /CHANGELOG.org
| marginalia: /CHANGELOG.org
| mescc-tools: /CHANGELOG.org
| modus-themes: /CHANGELOG.org
| pimd: /ChangeLog.org
| python-pbcore: /CHANGELOG.org
| restart-emacs: /Changelog.org
| treemacs: /Changelog.org
| vertico: /CHANGELOG.org
`----

The packages clj-http-clojure, mescc-tools, pimd, python-pbcore are not
maintained by the Emacsen team, but the changelog files are also in org
mode (clj-http-clojure[1], mescc-tools[2], pimd[3], python-pbcore[4].)
PTAL.

Ack.  Indeed.

[1] https://salsa.debian.org/clojure-team/clj-http-clojure/-/blob/debian/main/changelog.org?ref_type=heads&plain=1
[2] https://salsa.debian.org/debian/mescc-tools/-/blob/debian/latest/CHANGELOG.org?ref_type=heads&plain=1
[3] https://github.com/bobek/pkg-pimd/blob/debian/sid/ChangeLog.org?plain=1
[4] https://salsa.debian.org/med-team/python-pbcore/-/blob/master/CHANGELOG.org?ref_type=heads&plain=1

#1090956#50
Date:
2025-01-02 07:15:28 UTC
From:
To:
Hello,

Bug #1090956 in debhelper reported by you has been fixed in the
Git repository and is awaiting an upload. You can see the commit
message below and you can check the diff of the fix at:

https://salsa.debian.org/debian/debhelper/-/commit/07b486e8850b60f32ea3af764ecdd47d13e6d9a4
* CHANGELOG.org is a changelog in Org mode format, which is becoming
more popular in many ELisp packages.
------------------------------------------------------------------------

(this message was generated automatically)
-- 
Greetings

https://bugs.debian.org/1090956