[Github-comments] [geany/geany] toggle comments - rename menu item and document magic behaviour (#1027)

[Matthew Brush]

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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.geany.org/pipermail/github-comments/attachments/20160505/86cbbe80/attachment.html>