wmmenugen(1)

💖 wmmenugen 💖

okay bestie, so wmmenugen is a Window Maker PropList menu generator and honestly? she's iconic for it. it's a General Commands Manual situation, and we're gonna go through the whole thing together, no skips, no skimming, periodt. 🎀

✨ SYNOPSIS ✨

wmmenugen [options...]  -parser=<name> fspec [fspec...]  [-parser=<name> fspec [fspec...]...]

that's the whole vibe right there. -parser=<name> tells her how to read your stuff, and then you just keep feeding her fspecs. and you can absolutely do the -parser=<name> fspec [fspec...] thing again and again in one go, back to back, like stacking bracelets. 💅

🌸 DESCRIPTION 🌸

so here's the tea: wmmenugen generates a menu in the PropList format for Window Maker, using the input file fspec as her source material. ✨

and here's the lil plot twist that lowkey slays: if fspec is a directory instead of a file, then wmmenugen will read all the files present in the hierarchy of this directory. she's thorough like that. she does not do surface level. she goes deep. 🦋

👑 OPTIONS 👑

• --help, -h — prints a help message with the list of options. she's literally telling you how to use her. listen to her. 🙈
• -parser — specify the format of the file to be parsed. this is you telling her what she's looking at. communication is key bestie 💖
• --version — prints the version of Window Maker from which the program comes. she's telling you where she came from. ancestry check. 🌈

🧚 PARSERS 🧚

wmmenugen supports these file formats for input files, so pick your fighter:

• wmconfig — the format of the menu generation tool for X of the same name. yes, same name, no that's not a typo, that's just how it is. 😌
• xdg — the format of the menu specification as defined by the FreeDesktop standard, currently at version 1.1. she keeps up with the standards, obviously. ⭐

💀 RETURN VALUE 💀

the exit status from the wmmenugen command provides information for the caller, and it's giving very much "she will tell you exactly what happened":

• 0 — when the PropList menu was successfully generated on stdout. ate and left no crumbs 🔥
• 1 — when a fspec caused a problem (non readable file, ...). something was off with your file, bestie 😭
• 2 — the arguments of the command line where not recognised. she did not understand what you were saying. miscommunication era 🙈
• 3 — the program met an unexpected menu structure; you probably want to look at the section BUGS below. ⚠️ scroll down, it's important

🍓 BUGS 🍓

okay so this is the part where you gotta pay attention. 🫶

if you get the exit status 3 with the unclear error message about unprocessed levels on the stack, you encountered a limitation of wmmenugen. it's not you, it's her, but also, help her help you. 💜

it would be a good idea to prepare an archive with the files incriminated and submit them to the mailing list (wmaker-dev@googlegroups.com) with you command line, so the team can work on improving the behaviour of the program on this case. give the devs the receipts, they will fix the vibes. ✨

🔥 SEE ALSO 🔥

• wmgenmenu(1), the tool to generate a default menu. her sibling. her counterpart. her girl 💖
• the Wmconfig program can be found at: <http://www.arrishq.net/index.html>
• the xdg specification can be found at: <http://standards.freedesktop.org/menu-spec/menu-spec-1.1.html>

🎀 AUTHOR 🎀

wmmenugen is a part of Window Maker. It was written by Tamas TEVESZ. 👑

This manpage was written by Rodolfo García Peñas (kix) for the Debian GNU/Linux system (but may be used by others). 🌸

and that's the whole page bestie, every last crumb of it, no notes. this lil manual came from the General Commands Manual, and the version/date at the bottom said 16 May 2015 — so yes, she's a vintage queen and she still serves. 💅✨ mwah, go generate some menus 🦋💖