title: Marking-up argument names in comments of functions
body: <p>One of the most common dilemmas I have when commenting code is how to mark-up argument names. I'll explain what I mean:</p>
  
  <pre><code>def foo(vector, widht, n=0):
    """ Transmogrify vector to fit into width. No more than n 
        elements will be transmogrified at a time
    """
  </code></pre>
  
  <p>Now, my problem with this is that the argument names <code>vector</code>, <code>width</code> and <code>n</code> are not distinguished in that comment in any way, and can be confused for simple text. Some other options:</p>
  
  <blockquote>
    <p>Transmogrify 'vector' to fit into
    'width'. No more than 'n'</p>
  </blockquote>
  
  <p>Or maybe:</p>
  
  <blockquote>
    <p>Transmogrify -vector- to fit into
    -width-. No more than -n-</p>
  </blockquote>
  
  <p>Or even:</p>
  
  <blockquote>
    <p>Transmogrify :vector: to fit into
    :width:. No more than :n:</p>
  </blockquote>
  
  <p>You get the point. Some tools like Doxygen impose this, but what if I don't use a tool ? Is this language dependent ? </p>
  
  <p>What do <strong>you</strong> prefer to use ?</p>