The `toggle comments` menu item has a magical operation not hinted at by its name. It does not actually "toggle comments" but in fact comments uncommented lines with its own magic marker (by default "~ ") and will only uncomment lines with its marker. It does *not* by default toggle normal comments.
This can be useful to comment/uncomment sections of code, but without documentation and with a name that does not hint of the possibilities its hard to discover.
Suggestions better than "Magic Toggle Comments" welcome :)
--- You are receiving this because you are subscribed to this thread. Reply to this email directly or view it on GitHub: https://github.com/geany/geany/issues/1027
The way it works now is really the least magical thing it could do and it actually does toggle comments, it just doesn't specify _which_ comments it toggles. I suggest adding a tooltip to the menu item with a short description of how it only toggles its own special comments (if it doesn't already have one, if it does, it doesn't work here).
BTW Geany in my `en_CA` locale says "Toggle Line Commentation" for that menu item, which is maybe even slightly more confusing due to the two meanings of 'line' in this context; 'single-line-comment-token' vs 'comment-the-current-caret-line-action', the latter being only partially accurate since it comments multiple lines if they're selected. Though just using the feature once shows exactly what it does, so probably not a big deal.
IMO the discoverability is more hampered by being in a nested sub-menu than the slightly ambiguous naming.
--- You are receiving this because you are subscribed to this thread. Reply to this email directly or view it on GitHub: https://github.com/geany/geany/issues/1027#issuecomment-217319034
Maybe "Toggle Comment Code" to hint its for commenting code blocks.
The tooltip idea is a good one.
*Everything* can't be in a top level menu, so I guess some things are always gonna be hidden in sub-sub-sub menus.
--- You are receiving this because you are subscribed to this thread. Reply to this email directly or view it on GitHub: https://github.com/geany/geany/issues/1027#issuecomment-217326106
github-comments@lists.geany.org