<p>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 <em>which</em> 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).</p>

<p>BTW Geany in my <code>en_CA</code> 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.</p>

<p>IMO the discoverability is more hampered by being in a nested sub-menu than the slightly ambiguous naming.</p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly or <a href="https://github.com/geany/geany/issues/1027#issuecomment-217319034">view it on GitHub</a><img alt="" height="1" src="https://github.com/notifications/beacon/ABDrJ_iXURm6UWkx-AjpebcAINh_m6rHks5p-o4jgaJpZM4IX7gl.gif" width="1" /></p>
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="action" itemscope itemtype="http://schema.org/ViewAction">
  <link itemprop="url" href="https://github.com/geany/geany/issues/1027#issuecomment-217319034"></link>
  <meta itemprop="name" content="View Issue"></meta>
</div>
<meta itemprop="description" content="View this Issue on GitHub"></meta>
</div>