Bug#1016877: org-mode-doc: The info documentation doesn't override the version shipped with emacs

[Diane Trout <diane@ghic.org>]

Package: org-mode-doc
Version: 9.5.2-1
Severity: normal
X-Debbugs-Cc: none, Diane Trout <diane@ghic.org>

Dear Maintainer,

I was trying to read the info documentation provided by the org-mode-doc
package which matched the version of org mode I was using (9.5.2) but by
default was actually getting the org documentation shipped with emacs
version 9.3.

After digging for a while into how the Info-directory-list variable was
defined, the default looked like the following, and with the 9.5
documentation found in "/usr/share/info".

("/usr/share/emacs/site-lisp/elpa/debian-el-37" "/usr/share/info/emacs"
"/usr/share/info/" "/usr/share/info/")

I tried figure out how to adjust the construction of the
Info-directory-list to put a "/usr/share/info" before the flavor
directory "/usr/share/info/emacs" but couldn't figure it out.

But then I tried to figure out why there was the debian-el-37 directory on
the Info-directory-list path.

What I found is if the info dir file is present in one of the
automatically loaded package directories that directory will be
pre-pended to the Info-directory-list path.

Somehow adding a dir file to
/usr/share/emacs/site-lisp/elpa/org-9.5.2/ causes info to find the newer
version. I'd copied the dir file and a decompressed version of
org.info.gz into /usr/share/info/emacs/site-lisp/elpa/org-9.5.2 

Though debian-el might be a better example to follow where the info file
and its dir file are added to the elpa-src directory.

Thanks,
Diane

-- System Information:
Debian Release: bookworm/sid
  APT prefers testing-debug
  APT policy: (500, 'testing-debug'), (500, 'stable-security'), (500, 'oldstable-debug'), (500, 'testing'), (500, 'stable'), (110, 'unstable'), (100, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 5.18.0-3-amd64 (SMP w/4 CPU threads; PREEMPT)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE=en_US:en
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

org-mode-doc depends on no packages.

org-mode-doc recommends no packages.

Versions of packages org-mode-doc suggests:
ii  elpa-org [org-mode]  9.5.2+dfsh-4

-- no debconf information