Scroll to navigation

HELP2MAN(1) 用户命令 HELP2MAN(1)

名称

help2man - 输出一份简单的手册页

描述

`help2man' 根据 `--help' 和 `--version' 输出生成手册页面。

用法:help2man [选项]... 可执行程序

名称段落的描述
手册页章节号 (1, 6, 8)
手册名 (用户命令, ...)
程序来源 (FSF, Debian, ...)
选择语区 (默认 "C")
从 `FILE' 包含材料
从 `FILE' 包含材料若其存在
输出到 `FILE'
Texinfo 手册名
不输出到 Texinfo 手册的指示
从程序名中忽略 `lt-' 前缀
打印此帮助并退出
打印版本号并退出

可执行程序应接纳 `--help' 和 `--version' 选项并输出到标准输出,尽管你也可以这样指定替代:

帮助选项字串
版本选项字串
版本字串
解析输出时包含标准错误

包含文件

附加材料可以通过 --include--opt-include 选项加入生成的输出。格式很简单


[章节]
文字


/正则表达式/
文字

逐字 *roff 文字块将在给定的 [章节] (大小写不敏感)开始处,或在匹配 /正则表达式/ 的段后加入。

正则表达式模式使用 Perl 正则表达式语法指定,并可以跟随如下修饰符: i, sm (参见 perlre(1) ).

第一节前的行,或由 `-' 开始的模式,将被认为是选项。 其他的都将被安静地忽略,可被用作注释、RCS 关键字等。

章节输出(包含的)顺序为:


名称
摘要
描述
选项
其它
环境
文件
示例
作者
报告程序臭虫
版权
参见

在包含文件中的任何 [名称][摘要] 章节都将替换自动生成的内容。如果有必要的话,你还是可以用 --name 覆盖前者。

其他章节会自动附加到以上自动生成章节之上,或按照它们在包含文件中出现的顺序包含于 其他 (以上)章节内。

文字在章节中的位置可分别用分别用以下方式来指明: [<章节], [=章节] 或 [>章节] ,分别将附加文字置于默认文字之前、替代默认文字和置于其后。

可用性

本发行的最新版本可以在此处在线找到:


ftp://ftp.gnu.org/gnu/help2man/

作者

作者 Brendan O'Dea <bod@debian.org>

报告程序臭虫

报告错误给 <bug-help2man@gnu.org>.

版权所有 (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2020, 2021 自由软件基金会。 本软件为自由软件;参见源码以获取分发条件。本软件不含任何保证,甚至不含对于适销性和对某一 特定用途的适用性的保证。

参见

help2man 的完整文档以 Texinfo 手册的形式维护。若 infohelp2man 程序在你处已安装妥当,运行命令

info help2man

应可提供完整文档。

2021 三月 GNU help2man 1.48.2