浅谈Manpage

在linux中会有man git,则显示相应git的帮助文档,这类帮助文档通过一些tag来书写,本文对其用法进行简要概述

man文件的后缀为1,运行man xx.1即运行该man

man git -w 查看该help doc的源文件位置

.SH tag

.TH title

取消特殊含义

.B bold

.RS x indent x

.RE end of RS

这一组联用可以多次缩进,

以上就能完成大部分的man page操作

下面给出一个示例

2 .TH CVC-MODULE 1 "29 July 2015" "cvc-module 1.0" "CVC Tool Manual"
3 .SH NAME
4 cvc-module - manage modules of system
5 .SH SYNOPSIS
6 .nf
7 fBcvc-modulefR [--add]
8 [--update]
9 [--delete]
10 [--show]
11 [--help]
12 .fi
13 .SH DESCRIPTION
14 This fIcvc-modulefR allows ReleaseManager to manage modules (including
15 add, update, delete modules). Then you can use fIcvc-cifR to checkin
16 files into new modules
17 .SH OPTIONS
18 .PP
19 .B --add
20 .RS 4
21 ReleaseManager can add new modules into system&.
22
23 .B --module
24 .RS 4
25 Specify module name you want to add&.
26 .RE

原文地址:https://www.cnblogs.com/Raymond-Yang/p/4699781.html