What's the right way to reference a parameter in Doxygen?

Question

I have the following Doxygen documentation for a function:

/**
  @brief Does interesting things

  @param[in]  pfirst The first parameter: a barrel full of monke         


        

Answer 1

use the "#" symbol in front of the parameter you want to reference:

#pfirst must have been previously passed through BarrelFiller()

(in the doxygen manual)