6.3.7.2 生成Man Page

出于用户的需求，除了完整的Texinfo手册以外，还提供了从那些手册中提取的man页。这些man页使用contrib/texi2pod.pl和pod2man，从Texinfo手册中生成。（g++, cp/g++.1的man页，只是包含了一个对gcc.1的‘.so’引用，但所有其它man页是从Texinfo手册生成的。）

因为许多系统可能没有安装生成man页所需的工具，所以它们只有当configure脚本检测到新近安装了足够的工具时才会被生成，并且Makefile允许在生成man页失败时，而不会终止构建。Man页也包含在发行版本中。它们在源目录下生成。

Texinfo文件中起始于‘@c man’的Magic注释，用来控制Texinfo文件中哪些部分放到man页中。texi2pod.pl只支持Texinfo的一个子集，并且当生成新的man页时，可能需要增加对Texinfo特征的更多支持。为了提高man页输出，在doc/include/gcc-common.texi中提供了一些texi2pod.pl可以理解的特定的Texinfo宏：

@gcctabopt

选项表，以‘@table @gcctabopt’形式使用，用于‘@code’的打印输出效果比‘@option’的好，但是对于man页，却想要不同的效果的情况。

@gccoptlist

用于手册中的选项列表。

@gol

用在‘@gccoptlist’中每行的结尾。这可以避免由于不同的Texinfo格式化对‘@gccoptlist’宏的不同处理所带来的问题。

FIXME: 更加详细的描述texi2pod.pl输入语言和magic注释。