MDOC.SAMPLES

NAME (名字)

SYNOPSIS (总览)

DESCRIPTION (描述)

从 整个的 UNIX 手册页 上 来看, 每个 手册项 可以 简单的 理解为 一个 man page, 不用 注意 它的 实际长度, 也没有 性别歧视 意图. (译注: 可能是双关语, man page...男人页)  

开始 GETTING STARTED

1. TROFF 特性

   "使用宏"

   "参数中传递空白符"

   "尾部的空白符"

   "转义特殊字符"

2. 手册页的结构分析

   "手册页的模板"

3. 标题宏
4. 手册宏域和基本正文宏域的介绍

   "名称背后 ..."

   "基本语法"

5. 手册宏域

   "地址"

   "作者名字"

   "参数"

   "配置声明 (仅用于手册第四部分)"

   "命令修饰"

   "已定义的变量"

   "Errno's (仅用于手册第二部分)"

   "环境变量"

   "函数参数"

   "函数声明"

   "标志 (Flags)"

   "函数 (库例程)"

   "函数类型"

   "交互命令"

   "名称"

   "选项"

   "路径"

   "变量"

   "参照"

6. 基本正文宏域

   "AT&T 宏"

   "BSD 宏"

   "FreeBSD 宏"

   "UNIX 宏"

   "嵌入/引用宏 (Enclosure/Quoting)"

   "尖括弧引用/嵌入"

   "方括弧引用/嵌入"

   "双引号引用/嵌入宏"

   "圆括弧引用/嵌入"

   "单引号引用/嵌入"

   "前缀宏"

   "No-[或正文宏]

   "消除空白宏"

   "手册节对照"

   "参考和引用"

   "返回值 (仅用于手册页第二和第三部分)"

   "Trade Names (缩略和类型名称)"

   "参数扩展"

7. 页结构宏域

   "小节首部"

   "段落和空行"

   "保持 (Keeps)"

   "显示"

   "字体模式 (加重, 原文和 Symbolic)"

   "列表和栏"

8. 预定义串
9. 诊断
10. 用 GROFF, TROFF 和 NROFF 格式化
11. 臭虫 BUGS

TROFF 特性

宏的用法 Macro Usage

一般说来, troff(1) 宏 最多 接受 九个参数, 忽略掉 其余的. 大多数 在 -mdoc 里的 宏 支持 九个参数, 某些场合 可以 续加 参数, 或扩展到 下一行. (见 Sx 扩展 Extensions ) . 有些宏 能够 处理 引号 引起来的 参数 (见 下面的 Sx 在参数中传递空格符 ) .

大多数 -mdoc 的 基本正文宏域 和 手册宏域 的宏 拥有 一种特性, 表现在 把 参数列表 当成 可调用的宏 分析 (解释) 这意味着 如果 参数列表里的参数 是 普通正文宏域 或 手册宏域 里的 宏, 并且 是 可调用宏, 那么 处理的时候 会 执行 或 调用. 这种情况下的 参数, 即 宏名, 不需要 用 `.' (句点符) 引导. 这种风格 使 很多 宏 嵌套 在 一起; 例如 这个 选项宏 `.[,] ' 可能 调用 标志和参数宏, `- ' 和 `file ... ' 用来 说明 一个 带参数的 选项:

[-s bytes ]

来自 .[-s bytes ]

为了 防止 把 两个字符的字符串 解释成 宏名, 在这个 字符串 前面 加上 `\&'

转义序列:

[-s bytes ]

来自 .[\&-s \&bytes ]

这里的 字符串 `- ' 和 `file ... ' 没有 被解释成 宏. 在 这篇文档 和 相应的 快速参考手册 mdoc(7) 中, 参数列表 按 可调用参数 分析 的 宏 称为 已分析, 可以 从 参数列表 调用 的 宏 称为 可调用. 这里 用的 术语 '分析' 可能是个 技术失误, 几乎 所有的 -mdoc 宏 都 被分析, 既 用它 指 可调用宏, 又 指 有 调用 其他宏的 能力, 显得 很笨拙.  

在参数中传递空格符 Passing Space Characters in an Argument

有 两个方法 传递 嵌有空格符 的 参数. 补充一点 不幸的是, 在 AT&T troff 中, 那个 最容易的方法, 就是 作为 单个 参数 传递 两个引号之间的 字符串和空格符, 非常 消耗 时间 和 内存空间. 虽然 它 对 groff 并不费事, 但是 为了 可移植性, 这种 做法 只限于 下列 有迫切需要 的 宏:

配置声明 (手册第四部分

Sx 概要 SYNOPSIS )

列表开始 (指定宽度的)

加重文字

Fn 函数 (手册第二, 四部分)

列表项

原文

Symbolic text

%B

书题

%J

期刊名

%O

参考选注

%R

报告题目(在参考文件中)

%T

在书籍或期刊中的题目

一种 传递 含空格符字符串 的 方法 是 用 `\
 ' 硬编码 或 不可填充空格符, 也就是 在 空格符 前 加上 转义符 `\' 这个 方法 适用于 任何宏, 但 有个 副效应, 它 干扰了 对 长行 的 调整. Troff 把 这种 硬编码的 空格符 看作 可显示字符, 因此 无法 在需要的时候 把 字符串 分段 或 换行. 这种 方法 适用于 字符串 不会 到达 行边界 时, 例如:

Fn fetch char *str

来自 `.Fn fetch ' char\ *str

Fn fetch char *str

也可以来自 `.Fn fetch ' \*qchar *str\*q

如果 忽略 `\' 或 引号, `.Fn 宏 ' 会认为 有 三个参数, 结果 成为:

Fn fetch char *str

如果 想知道 参数列表 到达 行边界 时 出现什么, 参看 Sx BUGS 小节.

尾部的空白符 Trailing Blank Space Characters

转义特殊字符 Escaping Special Characters

手册页结构分析 THE ANATOMY OF A MAN PAGE

手册页的模板 A manual page template

.\" 所有的手册页都要求有下面的内容
.Dd 月 日, 年Month day, year
.Os 操作系统 [版本/发行号] 
.Dt 文档标题 [手册节号][卷] 
.Sh 名称 NAME
.Nm 名称 name
.Nd 对名称的简单描述 one line description of name
.Sh 总览 SYNOPSIS
.Sh 描述 DESCRIPTION
.\" 后面的内容取消注释后可以用在你需要的任何地方.
.\" 紧接着的这条命令用于手册第二和第三部分, 函数的返回值.
.\" .Sh 返回值 RETURN VALUES
.\" 下面的命令用于手册第1, 6, 7, 8部分.
.\" .Sh 环境 ENVIRONMENT
.\" .Sh 文件 FILES
.\" .Sh 示例 EXAMPLES
.\" 下面的命令用于手册第1, 6, 7, 8部分
.\"     (在shell下的命令返回值和标准错误类型的诊断)
.\" .Sh 诊断 DIAGNOSTICS
.\" 下面的命令用于手册第二和第三部分中的错误和信号处理.
.\" .Sh 错误 ERRORS
.\" .Sh 另见 SEE ALSO
.\" .Sh 遵循 CONFORMING TO
.\" .Sh 历史 HISTORY
.\" .Sh 作者 AUTHORS
.\" .Sh BUGS

模板中 的 第一个部分 是 (., ., . ) 宏; 文档日期, 手册或其内容 针对的 操作系统, 手册页的标题 ((大写) ) 和 该手册页 所属的节 (部分号). 这些宏 确认和标识了 这个手册页. 在 后面的 Sx 标题宏 TITLE MACROS 将 继续 讨论.

这个 模板中 的 其余部分 是 小节首部 (section header) (. 

;

标题宏 TITLE MACROS

.

文档标题 是 手册页的 主题, 由于 troff 的 限制, 必须 大写 手册节号 (部分号) 介于 1, ..., 8, 如果 指明了 手册节号, 可以 忽略 卷标. 卷标 用 下列 标识的 一个 或 任意个:

AMD    UNIX 历史遗留的手册文档 Ancestral Manual Documents

SMM      UNIX 系统管理员手册 System Manager's Manual

URMUNIX 参考手册 Reference Manual

PRMUNIX 程序员手册 Programmer's Manual

缺省的卷标
URM 代表 手册区 1, 6, and 7; SMM 代表 手册区 8; PRM 代表 手册区 2, 3, 4, and 5.

.操作系统 发行号#

操作系统 的 名字 可能 是 缩写, 像 BSD 或 FreeBSD 或 ATT 发行号 应该 是 系统 专用的 标准发行术语, 像 4.3, 4.3+Tahoe, V.3, V.4. 识别不出的 参数 就 照原样 显示在 页脚. 例如, 典型的页脚 可能是:

.BSD 4.3

或

.FreeBSD 2.2

或者 象 订制的产品

.CS Department

作为 伯克利的缺省设置, 不带 参数 的 `.定义为 ' BSD (指定在文件 /usr/share/tmac/mdoc/doc-common 中). 你 应该 把缺省值 设成 本机. 注意, 如果 不设置 `.宏, ' 页面的左下角 会 很难看.

.月 日, 年 (month day, year)

日期 应当 写的 正规点:

January 25, 1989

手册宏域 和 基本正文宏域的介绍

名称背后 What's in a name...

第一种 情况 下, troff(1) 宏 本身 就是 一种 命令; troff 命令 的 基本语法 是:

.Va argument1 argument2 ... argument9

这里的 `.是 ' 宏命令 或 宏请求, 紧随其后 的 是 待处理的参数. 第二种 情况 下, 使用 内容宏 描述 一条 UNIX 命令 要 复杂 些; 一个 典型的 Sx 总览 SYNOPSIS 命令行 显示 如下:

filter [-flag ] infile outfile

这里的 filter 是 命令名称, 方括弧内 的 -flag 是一个 标志 参数, 作为 可选参数 放在 代表 选项 的 方括弧内. 在 -mdoc 术语 中, infile 和 outfile 称为 参数 产生 上述效果 的 宏 是 这样的:

.Nm filter
.Op Fl flag
.Ar infile outfile

第三种 情况 讨论 命令 及其语法, 包括 它们的例子, 可能 还有 更多细节. 上面的例子里, 可以把 infile 和 outfile 理解为 操作参数 operands 或 文件参数 file arguments 有些 命令行参数 罗列的 十分 长:

make

[-eiknqrstv ] [-D variable ] [-d flags ] [-f makefile ] -words [-I directory ] [-j max_jobs ] [variable=value ] -words [target ... ]

这里 你 可能 讨论 make 命令 和 它的参数 makefile 作为 一个 标志的参数, -f 或者 讨论 一个 可选的文件操作对象 target 在 具体的上下文 中, 这种细节 能够 防止 混淆. 然而 -mdoc 宏包中 没有为 标志的参数 准备 宏. 作为 替代 是 `file ... ' 参数宏, 用于 描述 操作对象 或 文件参数 如 target 以及 标志的参数 如 variable 上面的 make 命令行 是 这样 产生的:

.Nm make
.Op Fl eiknqrstv
.Op Fl D Ar variable
.Op Fl d Ar flags
.Op Fl f Ar makefile
.Op Fl I Ar directory
.Op Fl j Ar max_jobs
.Op Ar variable=value
.Bk -words
.Op Ar target ...
.Ek

在 Sx Keeps 小节中 将会 解释 `.和 ' `.宏. '  

基本语法 General Syntax

.sptr, ptr),

结果是:

sptr, ptr),

标点符号 没有 被识别 出来, 全都按 原文字体 输出. 如果 标点符号 前面用 空格符 隔开:

.sptr , ptr ) ,

结果是:

sptr , ptr

标点符号 被 识别出来 了, 缺省的字体 也 有别于 原文文字的字体.

用 `\&' 转义符 可以 去掉 标点字符 的 特殊意义. Troff 作为 宏语言 有一定 的 限制, 当 表达的字串 中 含有 数学, 逻辑 或 引用 符号时 将 难于 处理:

{+,-,/,*,%,<,>,<=,>=,=,==,&,`,',"}

问题是 troff 会 认为 它 应该 执行或运算 这些 符号 代表的操作. 要 防止 这一点 可以 用 `\&' 转义 这些 字符. 典型语法 在 下面 显示的 第一个 内容宏 中 可以见到, `. '  

手册域 MANUAL DOMAIN

地址宏 Address Macro

Usage: .address ...

.addr1

addr1

.addr1

addr1

.addr1 , file2

addr1 , file2

.f1 , f2 , f3:

f1 , f2 , f3

.addr ) ),

addr ) )

不带参数 调用 `.是个 ' 错误. `.可以被 ' (其他宏) 调用和分析.  

作者名称 Author Name

Usage: .An author_name ...

.An Joe Author

An Joe Author

.An Joe Author,

An Joe Author ,

.An Joe Author Aq nobody@FreeBSD.ORG

An Joe Author Aq nobody@FreeBSD.ORG

.An Joe Author ) ),

An Joe Author ) ) ,

`.An 宏可以被 ' (其他宏) 分析和调用, 不带参数调用 `.An 是个错误. '  

参数宏 Argument Macro

Usage: .argument ...

.file ...

file ...

.file1

file1

.file1

file1

.file1 file2

file1 file2

.f1 f2 f3:

f1 f2 f3

.file ) ),

file ) )

如果不带参数调用 `.file ... ' 宏, 缺省为 `file ... ' `.file ... ' 宏可以被 (其他宏) 分析和调用.  

配置定义 (手册第四部分) Configuration Declaration

device le0 at scode?

来自: `.device ' le0 at scode? .

命令修饰 Command Modifier

已定义的变量 Defined Variables

Usage: .defined_variable ...

.MAXHOSTNAMELEN

MAXHOSTNAMELEN

.TIOCGPGRP )

TIOCGPGRP

不带参数调用 `.是个错误. ' `.宏可以被 ' (其他宏) 分析和调用.  

Errno's (仅供手册第二部分)

Usage: .Er ERRNOTYPE ...

.Er ENOENT

Er ENOENT

.Er ENOENT );

Er ENOENT ) ;

.Bq Er ENOTDIR

Bq Er ENOTDIR

不带参数调用 `.Er 宏是个错误. ' `.Er 宏可以被 ' (其他宏) 分析和调用.  

环境变量 Environment Variables

Usage: .argument ...

.DISPLAY

DISPLAY

.PATH

PATH

.PRINTER ) ),

PRINTER ) )

不带参数调用 `.宏是个错误. ' `.宏可以被 ' (其他宏) 分析和调用.  

函数参数 Function Argument

Usage: .Fa function_argument ...

.Fa d_namlen ) ),

Fa d_namlen ) ) ,

.Fa iov_len

Fa iov_len

不带参数调用 `.Fa 宏是个错误. ' `.Fa 宏可以被 ' (其他) 宏分析和调用.  

函数声明 Function Declaration

Usage: .Fd include_file (or defined variable)

在 Sx 总览 SYNOPSIS 小节, 如果 已经 说明了 某个 函数, 并且 没有 出现 省略号, 则 `.Fd 宏请求 ' 能够 产生 一个 断行. 在 函数 和 函数声明 之间, 垂直方向上 产生 一定的 空白.  

标志 Flags

Usage: .-argument ...

.-

-

.-cfv

-cfv

.-cfv

-cfv

.-s v t

-s v t

.--,

--

.-xyz ),

-xyz )

如果 `.- ' 宏 不带 任何 参数, 将 只产生 一个 短横线, 代表 stdin/stdout. 注意 如果 把 一个 短横线 做为 `.- ' 的参数, 结果 会 得到 两个短横线. `.- ' 宏可以被 (其他宏) 分析和调用.  

函数(库函数) Functions (library routines)

Usage: .Fn [type] function [[type] parameters ... 

.Fn getchar

Fn getchar

.Fn strlen ) ,

Fn strlen ) ,

.Fn \*qint align\*q \*qconst * char *sptrs\*q

Fn int align const * char *sptrs ,

不带参数调用 `.Fn 是一个错误. ' `.Fn 宏可以被 ' (其他宏) 分析和调用, 注意 任何 对 其他宏 的 调用 应该在 `.Fn 宏调用 ' 的 结尾处 给出 标记 (反括弧).

对于 八个 参数 以上的 函数 (尽管少见), 可以 用 宏 `.Fo (function ' open) 和 `.Fc (function ' close) 配合 `.Fa (function ' argument) 宏 的 使用, 突破 参数 过多 的 限制, 例如:

.Fo "int res_mkquery"
.Fa "int op"
.Fa "char *dname"
.Fa "int class"
.Fa "int type"
.Fa "char *data"
.Fa "int datalen"
.Fa "struct rrec *newrr"
.Fa "char *buf"
.Fa "int buflen"
.Fc

产生:

Fo int res_mkquery Fa int op Fa char *dname Fa int class Fa int type Fa char *data Fa int datalen Fa struct rrec *newrr Fa char *buf Fa int buflen Fc

宏 `.Fo 和 ' `.Fc 可以被 ' (其他宏) 分析和调用. 在 Sx 总览 SYNOPSIS 小节, 函数 总是 位于 行的开始 处. 如果 在 Sx 总览 SYNOPSIS 小节 有 一个以上的 函数声明, 而且 函数类型 没有 说明, 则 会产生 一个 断行. 在 函数 和 函数 的 垂直方向 上 产生 一定的 空白. 此时 `.Fn 宏 ' 不按 troff 的 行长 检查 单词 边界, 有可能 难看的 从 单词中间 断开. 以后 会 解决 这个 问题.  

函数类型 Function Type

Usage: .Ft type ...

.Ft struct stat

Ft struct stat

`.Ft 宏不能被其他宏调用. '  

交互命令 Interactive Commands

Usage: .argument ...

.:wq

:wq

.do while {...}

do while {...}

.setenv , unsetenv

setenv , unsetenv

不带参数调用 `.是个错误. ' `.宏可以被 ' (其他宏) 分析和调用.  

名称宏 Name Macro

Usage: .argument ...

.mdoc.sample

mdoc.sample

.\-mdoc

-mdoc

.foo ) ),

foo ) )

.man mdoc.samples

man mdoc.samples

`.man mdoc.samples ' 宏可以被 (其他宏) 分析和调用.  

选项 Options

Usage: .[options ... ]

.[[

.[-k ]

] ]

[-k ]

.[-k ) . ]

[-k ]

.[-k kookfile ]

[-k kookfile ]

.[-k kookfile , ]

[-k kookfile ]

.[objfil [corfil ] ]

[objfil [corfil ] ]

.[-c objfil [corfil , ] ]

[-c objfil [corfil ] ]

.[word1 word2]

[word1 word2]

应用 `.] ' 和 `.[宏: '

.Oo
.Op Fl k Ar kilobytes
.Op Fl i Ar interval
.Op Fl c Ar count
.Oc

产生: [[-k kilobytes ] [-i interval ] [-c count ] ]

宏 `.[,] ' `.] ' 和 `.[可以被 ' (其他宏) 分析和调用.  

路径名 Pathnames

Usage: .pathname

./usr/share

/usr/share

./tmp/fooXXXXX )

/tmp/fooXXXXX )

`.宏可以被 ' (其他宏) 分析和调用.  

变量 Variables

Usage: .variable ...

.count

count

.settimer

settimer

.int *prt ):

int *prt )

.char s ] ) ),

char s ] ) )

不带参数调用 `.宏是个错误. ' `.宏可以被 ' (其他宏) 分析和调用.  

手册页参照 Manual Page Cross References

Usage: .man_page[1,...,8]

.mdoc

mdoc

.mdoc

mdoc,

.mdoc(7)

mdoc(7)

.mdoc(7)))

mdoc(7))),

`.宏可以被 ' (其他宏) 分析和调用. 不带参数调用 `.宏是个错误. '  

基本正文宏域 GENERAL TEXT DOMAIN

AT&T 宏

Usage: .At [v6 | v7 | 32v | V.1 | V.4] ... 

.At

AT&T System

.AT&T System v6 .

AT&T System v6 .

`.AT&T System ' 宏 不能 被 (其他宏) 分析, 也 不能 被 (其他宏) 调用. 该宏 最多 接受 两个 参数.  

BSD 宏

Usage: .BSD [Version/release] ...

.Bx

BSD

.BSD 4.3 .

BSD 4.3

`.BSD 宏可以被 ' (其他宏) 分析和调用.  

FreeBSD 宏

Usage: .Fx Version.release ... 

.Fx 2.2 .

Fx 2.2 .

`.Fx 宏 ' 不能 被 (其他宏) 分析, 也 不能 被 (其他宏) 调用. 该宏 最多 接受 两个 参数.  

UNIX 宏

Usage: .UNIX

.Ux

UNIX

`.UNIX ' 宏可以被 (其他宏) 分析和调用.  

嵌入和引用宏 Enclosure and Quoting Macros

Quote         Close   Open   Function        Result .Aq    .Ac     .Ao     Angle Bracket Enclosure<string>
.Bq     .Bc     .Bo     Bracket Enclosure       [string]
.Dq     .Dc     .Do     Double Quote    ``string''
        .Ec     .Eo     Enclose String (in XX)  XXstringXX
.Pq     .Pc     .Po     Parenthesis Enclosure   (string)
.Ql                     Quoted Literal  `st' or string
.Qq     .Qc     .Qo     Straight Double Quote   "string"
.Sq     .Sc     .So     Single Quote    `string'

除了 下面的 不规则宏, 所有的 引用宏 可以被 (其他宏) 分析和调用. 所有的 引用宏 能够 正确 处理 标点符号, 只要 一次 一个字符, 中间 用 空格 隔开. 引用宏 检查 开始和结束 符号, 以决定 把 它 放在 引用串的 前面还是后面. 这样 就 有了 一定的 嵌套能力.

.Ec , .Eo 这些宏 的 第一个参数 是 各自的 开始和结束串.

.`原文引用宏'

的 表现在 troff 中和 nroff 不一样. 如果用 nroff 格式化, 引用的原文 始终 被引用. 如果用 troff 格式化, 只有 宽度 小于 三个定宽字符 的 项 才被 引用. This is to make short strings more visible where the font change to literal (constant width) is less noticeable. 当 字体 变成 原文(定宽) 时, 短串显得更容易被看到.

.前缀宏不能被 (其他宏) 调用, 但是可以被分析.

.( Fa name2

变成 ( Fa name2

这个 `.(无空格) ' 宏 执行 类似的 后缀 功能.

引用举例:

.Aq Aq

.Aq ctype.h ),

Aq Ar ctype.h ) ,

.Bq Bq

.Bq Greek , French .

Bq Em Greek , French .

.````

.``string abc .''

'' ''

``string abc''

.``'^[A-Z]'''

``'^[A-Z]'''

.`man'

mdoc `man' mdoc

.Qq Qq

.Qq string ) ,

Qq string ) ,

.Qq string ),

Qq string Ns ),

.``

.`string'

' '

`string'

作为 嵌套引用宏的 典型范例, 参见 `.[选项宏.] ' 它们 都 来自 上面 列出的 基本 引用宏. `. ' 和 `. ' 扩展的 参数列表宏 同样 来自 相同的 基本例程, 并且, 在 最坏的情况 下, 是 -mdoc 宏 用法的 很好范例.  

No-[或正文宏 or Normal Text Macro]

无空格宏 Space Macro

.[-I directory ]

产生 [-I directory ]

注意: `.宏 ' 在 消除空格后 总会 调用 `.宏, ' 除非 还有 其他 宏名 跟在 后面. `.宏可以被 ' (其他宏) 分析和调用.  

手册页对照参考 Section Cross References

.Sx FILES

Sx FILES

参考和引言 References and Citations

.Rs

参考开始. 它 导致 一次 断行, 并且 开始 收集 参考资料, 直到 遇到 参考结束宏.

.Re

参考结束. 则 打印出 参考信息.

.%A

参考资料 的 作者名字, 一次一个.

.%B

书名.

.%C

城市/地点.

.%D

日期.

.%J

期刊名.

.%N

发行号.

.%O

可选信息.

.%P

页码.

.%R

报告名.

.%T

文章题目.

.%V

卷.

用 `%' 符号 开始的 宏 不能被 (其他宏) 调用, 只能 被 trade name macro 分析, 结果 返回给 调用者 (此时 结果 不太好 预测). 其目的 是 允许 trade name 能够 很好的 打印在 troffNs/NsXrditroff 的 输出端.  

返回值 Return Values

Usage: .Rv [-std function]

`.Rv -std ' atexit 将输出 下列文字:

.Rv -std atexit

这个 -std 选项 仅用于 手册页的 第二和第三部分.  

Trade Names (或缩略和类型名)

Usage: .symbol ...

.DEC

DEC

.ASCII

ASCII

`.宏可以被 ' (其他宏) 分析和调用.  

扩展参数 Extended Arguments

这里有 `. ' 宏的一个示例, 用 空格模式宏 把 空格 去掉:

.Sm off
.It Xo Sy I Ar operation
.No \en Ar count No \en
.Xc
.Sm on

产生

I operation \n count \n

还有一个:

.Sm off
.It Cm S No / Ar old_pattern Xo
.No / Ar new_pattern
.No / Op Cm g
.Xc
.Sm on

产生

S / old_pattern / new_pattern / [g ]

另一个示例用 `. ' 和 引用宏: 测试一个变量的值.

.It Xo
.Ic .ifndef
.Oo \&! Oc Ns Ar variable
.Op Ar operator variable ...
.Xc

产生

.ifndef [! variable ] [operator variable ... ]

上面 所有的例子 都在 `. ' (list-item) 宏 的 参数列表 中 使用了 `. ' 宏. 扩展宏 不经常 使用, 一般用来 扩展 list-item 宏 的 参数列表. 这也 不幸的 是 扩展宏 最苛刻的 地方. 前两个例子里 空格 被去掉; 第三个 例子中, 希望 能 输出 部分 空格, 而不是 全部. 在 这种情况下 用 这些宏, 要 确保 `. ' 和 `.

.Sh PAGE STRUCTURE DOMAIN