#994070 Subject: reportbug: fluxbox-menu.5 manpage refers to nonexistent configuration files

Package:
fluxbox
Source:
fluxbox
Description:
Highly configurable and low resource X11 Window manager
Submitter:
Date:
2021-09-11 04:12:03 UTC
Severity:
minor
Tags:
#994070#5
Date:
2021-09-11 04:08:50 UTC
From:
To:
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
---
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\&.
---
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\&.
---
357c355
< \fB/usr/share/fluxbox/menu\fR
---
367c365
< \fB/usr/share/fluxbox/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)