Package: fluxbox
Version: 1.3.5-2+b2
Severity: minor
Tags: patch

Dear Maintainer,

The fluxbox-menu.5 manpage refers several times to two nonexistent configuration files. Equivalent files
do exist in a different location with different names:

  - '/usr/share/fluxbox/menu' should be '/etc/X11/fluxbox/fluxbox-menu'
- '/usr/share/fluxbox/windowmenu' should be '/etc/X11/fluxbox/window.menu'

I don't know if the manpage is wrong or if files are being installed in the wrong place.

Less critical, there is a near duplicate sentence in the DESCRIPTION section of the manpage:

The first is the root menu, which normally appears when you right-click on the desktop.

The first is the ROOT MENU (Or right-click menu), is usually bound to a right-click on the desktop, though this binding can be changed in the ‘keys’ file (fluxbox-keys(5)). This same syntax is used for the CustomMenu command, also mentioned in fluxbox-keys(5).

I suggest the first sentence be removed.

Below I'm pasting a patch with my suggested changes.

============================= fluxbox-menu.5 manpage patch begins =============================================
34c34
< /usr/share/fluxbox/menu
---
/etc/X11/fluxbox/fluxbox-menu
48,49d47
< The first is the root menu, which normally appears when you right\-click on the desktop\&.
< .sp
52c50
< Fluxbox installs a default root menu file in \fB/usr/share/fluxbox/menu\fR\&. You can also use fluxbox \-i to confirm this location\&. Of course this system\-wide menu can be customized for all users at once, but it is also possible to create an individual menu file for each user\&. By convention, users create a menu file in \fB~/\&.fluxbox/menu\fR\&. Once you\(cqve created your own menu file, you\(cqll want to make sure that you properly declare this location in your \(oqinit\(cq file so that fluxbox knows where to look\&. See \fBRESOURCES\fR, below for details\&.
---
Fluxbox installs a default root menu file in \fB/etc/X11/fluxbox/fluxbox-menu\fR\&. You can also use fluxbox \-i to confirm this location\&. Of course this system\-wide menu can be customized for all users at once, but it is also possible to create an individual menu file for each user\&. By convention, users create a menu file in \fB~/\&.fluxbox/menu\fR\&. Once you\(cqve created your own menu file, you\(cqll want to make sure that you properly declare this location in your \(oqinit\(cq file so that fluxbox knows where to look\&. See \fBRESOURCES\fR, below for details\&.
54c52
< The second type is the \fBWINDOW MENU\fR, which defines the contents of the menu which appears when you right\-click on a window\(cqs titlebar or iconbar\&. This opens a menu file as defined by \fB~/\&.fluxbox/windowmenu\fR\&. If this file does not exist, fluxbox will copy in the default from \fB/usr/share/fluxbox/windowmenu\fR\&.
---
The second type is the \fBWINDOW MENU\fR, which defines the contents of the menu which appears when you right\-click on a window\(cqs titlebar or iconbar\&. This opens a menu file as defined by \fB~/\&.fluxbox/windowmenu\fR\&. If this file does not exist, fluxbox will copy in the default from \fB/etc/X11/fluxbox/window.menu\fR\&.
357c355
< \fB/usr/share/fluxbox/menu\fR
---
\fB/etc/X11/fluxbox/fluxbox-menu\fR
367c365
< \fB/usr/share/fluxbox/menu\fR
---
\fB/etc/X11/fluxbox/window.menu\fR
============================= fluxbox-menu.5 manpage patch ends =============================================

I hope this helps. Thank you for your efforts to provide an excellent operating system.

pell (Eric Pellegrin)


-- System Information:
Debian Release: 11.0
  APT prefers stable-security
  APT policy: (500, 'stable-security'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.10.0-8-amd64 (SMP w/1 CPU thread)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages fluxbox depends on:
ii  libc6                2.31-13
ii  libfontconfig1       2.13.1-4.2
ii  libfreetype6         2.10.4+dfsg-1
ii  libfribidi0          1.0.8-2
ii  libgcc-s1 [libgcc1]  10.2.1-6
ii  libgcc1              1:6.3.0-18+deb9u1
ii  libice6              2:1.0.10-1
ii  libimlib2            1.7.1-2
ii  libsm6               2:1.2.3-1
ii  libstdc++6           10.2.1-6
ii  libx11-6             2:1.7.2-1
ii  libxext6             2:1.3.3-1.1
ii  libxft2              2.3.2-2
ii  libxinerama1         2:1.1.4-2
ii  libxpm4              1:3.5.12-1
ii  libxrandr2           2:1.5.1-1
ii  libxrender1          1:0.9.10-1
ii  menu                 2.1.48

Versions of packages fluxbox recommends:
ii  feh              3.6.3-1
ii  xfonts-terminus  4.48-3

Versions of packages fluxbox suggests:
pn  fbautostart  <none>
pn  fbdesk       <none>
pn  fbpager      <none>

-- no debconf information

Reply via email to