- Ruby: rdoc
- JavaScript: jsdoc
RDoc
# Gets a circle's area
#
# @example
#
# area(3)
# #=> 28.27
#
# @param [Number] r The radius of the ricle
# @return [true] If so
#
# == Definition lists
#
# list:: hi.
# +foo+:: parameterized
#
# == Definition lists
# [foo] also
# [bar] like this
http://rdoc.rubyforge.org/RDoc/Markup.html
Jsdoc
/**
* Ads numbers
*
* @this {Circle}
* @param {Number} r The radius