名 称
help2man - 输 出 一 份 简 单 的 手 册 页
描 述
’help2man’
根 据 ’--help’ 和
’--version’ 输 出 生 成
手 册 页 面 。 用
法 : help2man [选 项 ]... 可
执 行 程 序
-n, --name=STRING 名 称
段 落 的 描 述
-s, --section=SECTION 手 册
页 章 节 号 (1, 6, 8)
-m, --manual=TEXT 手 册
名 (用 户 命 令 , ...)
-S, --source=TEXT 程 序
来 源 (FSF, Debian, ...)
-L, --locale=STRING 选 择
语 区 (默 认 "C")
-i, --include=FILE 从
’FILE’ 包 含 材 料
-I, --opt-include=FILE 从
’FILE’ 包 含 材 料
若 其 存 在
-o, --output=FILE 输 出
到 ’FILE’
-p, --info-page=TEXT
Texinfo 手 册 名
-N, --no-info
不 输 出 到 Texinfo 手
册 的 指 示
-l, --libtool 从 程 序 名
中 忽 略 ’lt-’ 前
缀
--help 打 印 此 帮 助 并 退 出 |
--version 打
印 版 本 号 并 退
出 可 执 行 程 序
应 接 纳 ’--help’ 和
’--version’ 选 项 并 输
出 到 标 准 输 出
, 尽 管 你 也 可
以 这 样 指 定 替
代 :
-h, --help-option=STRING 帮 助
选 项 字 串
-v, --version-option=STRING 版
本 选 项 字 串
--version-string=STRING 版 本
字 串
--no-discard-stderr 解 析 输 出
时 包 含 标 准 错
误
包 含 文 件
附 加 材 料 可 以 通 过 --include 和 --opt-include 选 项 加 入 生 成 的 输 出 。 格 式 很 简 单
[章 节 ] 文 字
/正 则 表 达 式 / 文 字 逐 字 *roff 文 字 块 将 在 给 定 的 [章 节 ] ( 大 小 写 不 敏 感 ) 开 始 处 , 或 在 匹 配 /正 则 表 达 式 / 的 段 后 加 入 。 正 则 表 达 式 模 式 使 用 Perl 正 则 表 达 式 语 法 指 定 , 并 可 以 跟 随 如 下 修 饰 符 : i, s 或 m ( 参 见 perlre(1) ) . 第 一 节 前 的 行 , 或 由 ’-’ 开 始 的 模 式 , 将 被 认 为 是 选 项 。 其 他 的 都 将 被 安 静 地 忽 略 , 可 被 用 作 注 释 、 RCS 关 键 字 等 。 章 节 输 出 ( 包 含 的 ) 顺 序 为 : 名 称 摘 要 描 述 选 项 其 它 环 境 文 件 示 例 作 者 报 告 程 序 臭 虫 版 权 参 见 在 包 含 文 件 中 的 任 何 [名 称 ] 或 [摘 要 ] 章 节 都 将 替 换 自 动 生 成 的 内 容 。 如 果 有 必 要 的 话 , 你 还 是 可 以 用 --name 覆 盖 前 者 。 其 他 章 节 会 自 动 附 加 到 以 上 自 动 生 成 章 节 之 上 , 或 按 照 它 们 在 包 含 文 件 中 出 现 的 顺 序 包 含 于 其 他 ( 以 上 ) 章 节 内 。 文 字 在 章 节 中 的 位 置 可 分 别 用 分 别 用 以 下 方 式 来 指 明 : [<章 节 ], [=章 节 ] 或 [>章 节 ] , 分 别 将 附 加 文 字 置 于 默 认 文 字 之 前 、 替 代 默 认 文 字 和 置 于 其 后 。
可 用 性
本 发 行 的 最 新 版 本 可 以 在 此 处 在 线 找 到 :
ftp://ftp.gnu.org/gnu/help2man/
作 者
作 者 Brendan O’Dea <bod [AT] debian.org>
报 告 程 序 臭 虫
报 告 错 误 给 <bug-help2man [AT] gnu.org>. 版 权 所 有 (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2020, 2021, 2022 自 由 软 件 基 金 会 。 本 软 件 为 自 由 软 件 ; 参 见 源 码 以 获 取 分 发 条 件 。 本 软 件 不 含 任 何 保 证 , 甚 至 不 含 对 于 适 销 性 和 对 某 一 特 定 用 途 的 适 用 性 的 保 证 。
参 见
help2man 的 完 整 文 档 以 Texinfo 手 册 的 形 式 维 护 。 若 info 和 help2man 程 序 在 你 处 已 安 装 妥 当 , 运 行 命 令
info help2man 应 可 提 供 完 整 文 档 。