Flash builder has a good implementation of this under Source -> add ASDoc comment and its the one feature i really miss.

e.g.

/**

• Merge any address info stored in an array into a string
• @param str The source string
• @param parts An array containing address info
• @param index The starting index for the array slice
• @return the merged parts.

• */
  private function jointUrlParts(str : String, parts : Array, index : int) : String {
  }