我喜欢通过 help2man 和 txt2man 使用“--help”输出生成手册页。Ruby 的 RDoc 系统非常方便,但我似乎无法完全按照我想要的方式配置 RDoc::usage。这是一个示例脚本:
#!/usr/bin/env ruby
#
# === Name
#
# foobar - Example command for StackOverflow question
#
# === Synopsis
#
# Usage: foobar [--help]
#
# === Options
#
# --help This help message
require 'rdoc/usage'
RDoc::usage('name', 'synopsis', 'options')
脚本的输出如下所示:
Name
foobar - Example command for StackOverflow question
Synopsis
Usage: foobar [--help]
Options
--help This help message
但我真的很想为我的使用输出抑制“名称”和“概要”标题,但仍将它们标记为输出到手册页的部分。
使用 ':section:' 标记适用于 RDoc::Rdoc,但不适用于 RDoc::usage。是否有一种明显的方法可以在不打印标题的情况下标记 usage.rb 部分?