Как добавить существующие комментарии к RDoc в Ruby?

RDoc использует SimpleMarkup, поэтому довольно просто создавать списки и т. д. С помощью *, - или числа. Он также рассматривает строки, которые имеют отступ в том же номере столбца, как часть того же абзаца, пока не появится пустая строка, обозначающая новый абзац. У вас есть несколько примеров комментариев, которые вы хотите добавить в RDoc, чтобы мы могли показать вам, как их делать, а затем вы могли бы экстраполировать это на остальные ваши комментарии?

Несколько вещей, которые меня укусили:

• :main: - RDoc использует только последний оцененный; Лучше всего убедиться, что в вашем проекте только один, и вы также не используете аргумент командной строки --main.
• то же, что и предыдущий, но для :title:
• :section: работает не очень хорошо