Description of problem: In KDE4 'Documentation' packages were placed in a top level 'Documentation' menu. In plasma5 the same packages are now placed under Tools->System Tools For example the Gnuradio documentation package which has this in the .desktop file: Categories=System;Documentation;X-Mageia-CrossDesktop; 'System' is only there to satisfy desktop-file-validate. In my opinion xdg is totally broken as it is simply impossible to sanely categorize lots of specialist packages, but that is another issue. Guessing at package to blame. Version-Release number of selected component (if applicable): How reproducible: Steps to Reproduce: 1. 2. 3.
Assignee: bugsquad => kdeCC: (none) => marja11
CC: (none) => mageiaKeywords: (none) => Junior_job
This is still present in Mga6 and cauldron in plasma5. How is anyone supposed to find Documentation packages under Tools-> System Tools Can anyone suggest a better xdg Category than: Categories=System;Documentation;X-Mageia-CrossDesktop; ... that also passed desktop-file-validate? This was perfectly fine in KDE4 and appeared under the 'Documentation' top level category.
(In reply to Barry Jackson from comment #1) > This is still present in Mga6 and cauldron in plasma5. > How is anyone supposed to find Documentation packages under Tools-> System > Tools > > Can anyone suggest a better xdg Category than: > > Categories=System;Documentation;X-Mageia-CrossDesktop; > > ... that also passed desktop-file-validate? > > This was perfectly fine in KDE4 and appeared under the 'Documentation' top > level category. The problem seems to be that the top level category Documentation is not displayed. Checked also in cauldron LXQt and Enlightment: in these environment, they are displayed in top level Other, which is not wanted, neither.
CC: (none) => yves.brungard_mageia
Yuri created this report upstream: https://bugs.kde.org/show_bug.cgi?id=395580
(In reply to papoteur from comment #3) > Yuri created this report upstream: > https://bugs.kde.org/show_bug.cgi?id=395580 I was wrong and Barry was right. The top-level "Documentation" item exists in fact (it is created by /usr/share/desktop-directories/mandriva-documentation.directory). To check this you can fire up the KDE menu editor. It is just not shown because xdg "black magic" somehow puts our documentation where it is written in the title of this bug report... So the fix to the desktop file is right but the problem is in the method of how the menu is built itself. Categories=System;Documentation; -> Tools->System tools Categories=Office;Documentation; -> Office Categories=Utility;Documentation; -> Tools It seems that there is no way to put it in "Documentation" regardless of its existence. :'(
CC: (none) => yurchor
Might be a try to use X-MandrivaLinux-MoreApplications-Documentation as category. Also FWIW the main menu structure is defined in /etc/xdg/menus/applications.menu, it's not some "black magic". For KF5, /etc/xdg/menus/plasma-applications.menu is also used but it's the same for documentation. Just tried and changed /usr/share/applications/gnuradio-doc.desktop to Categories=System;Documentation;X-MandrivaLinux-MoreApplications-Documentation;X-Mageia-CrossDesktop; and directly afterwards it is also displayed in the toplevel Documentation folder. But overall this seems pretty hacky to me, maybe this should be discussed on dev ml, because other packages should also be aware of this as most documentation packages .desktop files should be adapted to that Or we change our main menu structure so that System;Documentation does not end up in Tools->System tools (which I believe is wrong for documentation).
CC: (none) => doktor5000
[copied from the dev- mailing list] According to https://wiki.mageia.org/en/Packaging_guidelines#Desktop_files, the X-MandrivaLinux-* categories are deprecated and should no longer be used. In /etc/xdg/menus/applications.menu, the top level Documentation category includes are <Include> <And> <Category>X-MandrivaLinux-MoreApplications-Documentation</Category> <Category>Documentation</Category> <Not> <Category>LXQt</Category> </Not> </And> </Include> so only applications that have the deprecated X-MandrivaLinux-MoreApplications-Documentation tag as well as the Documentation tag will be included. In /etc/xdg/menus/xfce-applications.menu however, the top level Documentation category includes are <Include> <Category>X-MandrivaLinux-MoreApplications-Documentation</Category> <Category>Documentation</Category> </Include> so any application that has either of those tags will be included, which is why the MCC documentation appears in the top level Documentation menu in Xfce. Currently the MCC documentation doesn't appear in any menu in DEs other than Xfce because it doesn't include a registered main category. We can at least fix that by changing Categories: Documentation; to Categories: System;Documentation; If it is desired that all documentation appears in a top level Documentation menu, /etc/xdg/menus/applications.menu should be changed, along with any other DE-specific menu specifications.
CC: (none) => mageia
Users who have experienced this problem are encouraged to upgrade to the latest update of their distribution, and if this issue turns out to still be reproducible in the latest update, please reopen this bug with additional information. Closing as OLD.
Status: NEW => RESOLVEDResolution: (none) => OLD
This is still not fixed in Mga10 Cauldron, reopening.
Resolution: OLD => (none)Status: RESOLVED => REOPENED
From which package come this documentation? and how is called the desktop entry which is used?
CC: (none) => geiger.david68210
On cauldron now gnuradio-doc desktop application look to: Categories=Development;HamRadio;Science;X-Mageia-CrossDesktop; No categorie 'Documentation' is used!
And certainly not a plasma issue for this desktop entry not shown in the right place!
(In reply to David GEIGER from comment #10) > On cauldron now gnuradio-doc desktop application look to: > > Categories=Development;HamRadio;Science;X-Mageia-CrossDesktop; > > No categorie 'Documentation' is used! No, I have moved it as stated in the revision log. There was no point leaving it as it was due to this bug which I also referenced in the log. Now the documentation package appears next to the gnuradio-companion package in the Development menu where it can actually be found by users. In cauldron there is no 'Documentation' section shown at all even when suggestions above are used in edited .desktop files. In #6 Martin says that: "We can at least fix that by changing Categories: Documentation; to Categories: System;Documentation;" However, that is what I already had in the gnuradio doc package, which at one time worked but no longer does.
I notice in Mga9 that the mcc documentation uses: X-MageiaGeneral;Documentation; which works fine. Using that for gnuradio-doc in Mga9 plasma also puts it under Documentation. I will test in Cauldron later.
Yes this works in Cauldron however it appears to not be strictly correct: $ desktop-file-validate mageia-doc-mcc.desktop mageia-doc-mcc.desktop: hint: value "X-MageiaGeneral;Documentation;" for key "Categories" in group "Desktop Entry" does not contain a registered main category; application might only show up in a "catch-all" section of the application menu Where are these 'registered main categories' registered? If "X-MageiaGeneral;Documentation;" is considered acceptable then I can move the gnuradio-doc.desktop there, however I have always tried to satisfy 'desktop-file-validate' in the past. I agree with Florian in #5 something should be done about "X-MandrivaLinux-MoreApplications-Documentation". No idea what though.