Subject: menu: READMEs mention /usr/share/menu/default, which doesn't exist, as documentation

From: наб <[email-masked]>
Date: Thu, 22 Dec 2022 22:41:00 +0100

Package: menu
Version: 2.1.49
Severity: normal

Dear Maintainer,

-- >8 --
$ cat usr/share/menu/README
...
The files should have the name of the package that's installing it,
and may contain as many lines (menu entries) as is necessary.

For examples, please look in /usr/share/menu/default
...
-- >8 --
but
-- >8 --
$ find -name default
-- >8 --
so?

For reference, other documentation seems to indicate that /u/s/m/d
is where menu files go:
-- >8 --
$ find -type f -exec zgrep /usr/share/menu/default {} +
./usr/share/menu/README:For examples, please look in /usr/share/menu/default
./usr/share/man/man5/menufile.5.gz:.B /usr/share/menu/default/*
./usr/share/man/man5/menufile.5.gz:.I /usr/share/menu/default/*
./usr/share/man/man1/update-menus.1.gz:.I /usr/share/menu/default/*
./usr/share/man/fr/man5/menufile.5.gz:.B /usr/share/menu/default/*
./usr/share/man/fr/man5/menufile.5.gz:.I /usr/share/menu/default/*
./usr/share/man/fr/man1/update-menus.1.gz:.I /usr/share/menu/default/*
./usr/share/info/menu.info.gz:'/usr/lib/menu', '/usr/share/menu' and '/usr/share/menu/default', and
./usr/share/info/menu.info.gz:'/usr/lib/menu', '/usr/share/menu', '/usr/share/menu/default'.  (if a
./usr/share/doc/menu/menu.txt.gz:     `/usr/lib/menu', `/usr/share/menu' and `/usr/share/menu/default', and
./usr/share/doc/menu/menu.txt.gz:     `/usr/share/menu/default'.  (if a user runs `update-menus', it will
./usr/share/doc/menu/menu.sgml.gz:<file>/usr/share/menu/default</file>, and stores the menu entries of all
./usr/share/doc/menu/menu.sgml.gz:<file>/usr/share/menu</>, <file>/usr/share/menu/default</>.
./usr/share/doc/menu/html/ch7.html:<code>/usr/share/menu</code>, <code>/usr/share/menu/default</code>.  (if a user
./usr/share/doc/menu/html/ch2.html:<code>/usr/share/menu/default</code>, and stores the menu entries of all
./usr/share/doc/menu/changelog.gz:  * Move default entries to /usr/share/menu/default.
./usr/share/doc/menu/changelog.gz:  * Update documentation to reflect /usr/share/menu/default changes.
grep: ./usr/bin/update-menus: binary file matches
./etc/menu/README:and /usr/share/menu/default.
-- >8 --

However:
-- >8 --
$ zgrep usr/share/menu/default Contents-all.gz Contents-amd64.gz
-- >8 --
so?

idk

Best,
наб

-- System Information:
Debian Release: bookworm/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: x32 (x86_64)
Foreign Architectures: amd64, i386

Kernel: Linux 6.0.0-6-amd64 (SMP w/2 CPU threads; PREEMPT)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages menu depends on:
ii  libc6       2.36-6
ii  libgcc-s1   12.2.0-10
ii  libstdc++6  12.2.0-10

menu recommends no packages.

Versions of packages menu suggests:
pn  gksu | kde-cli-tools | ktsuss  <none>
pn  menu-l10n                      <none>