[Chinese-commits] [manpages-zh] 26/131: fix a2p, cal, col, gcc, host
Boyuan Yang
hosiet-guest at moszumanska.debian.org
Tue Dec 13 19:59:36 UTC 2016
This is an automated email from the git hooks/post-receive script.
hosiet-guest pushed a commit to branch master
in repository manpages-zh.
commit d662773a16529b4ca210f96ea691222d191c277f
Author: LI Daobing <lidaobing at gmail.com>
Date: Fri Feb 22 23:50:45 2008 +0800
fix a2p, cal, col, gcc, host
---
src/man1/a2p.1 | 8 +-
src/man1/cal.1 | 29 ++++----
src/man1/col.1 | 78 +++++++++++---------
src/man1/gcc.1 | 11 ---
src/man1/host.1 | 221 +++++++++++++++++++++++++++++++-------------------------
5 files changed, 185 insertions(+), 162 deletions(-)
diff --git a/src/man1/a2p.1 b/src/man1/a2p.1
index 0d7d63f..9f63523 100644
--- a/src/man1/a2p.1
+++ b/src/man1/a2p.1
@@ -108,11 +108,9 @@ a2p \- Awk 到 Perl 翻译器
.IP "\fB\-n<fieldlist>\fR" 5
如果输入不分解为一个数组，你需要指定输入的各字段的名称。
假如要翻译一个用于处理密码文件的awk脚本，你应当这样:
-.PP
-.Vb 1
-\& a2p -7 -nlogin.password.uid.gid.gcos.shell.home
-.Ve
-.Sp
+
+a2p -7 -nlogin.password.uid.gid.gcos.shell.home
+
任何定界符都可以用来分隔字段名。
.IP "\fB\-<number>\fR" 5
使得a2p总是假设输入包含那么多字段。
diff --git a/src/man1/cal.1 b/src/man1/cal.1
index 2f9f89d..bda6c2f 100644
--- a/src/man1/cal.1
+++ b/src/man1/cal.1
@@ -37,31 +37,34 @@
.\"
.TH CAL 1 "June 6, 1993"
.SH NAME
-.Nm cal
-显示一个日历
+cal \- 显示一个日历
.SH 总览
-.Nm cal
-.Op Fl mjy
-.Op Ar 月份 Op Ar 年份
+.B cal
+[
+.B -mjy
+]
+[
+.IR 月份
+]
+[
+.IR 年份
+]
.SH 描述
-.Nm Cal
显示一个简单的日历..
如果没有指定参数, 则显示当前月份.
选项如下所列:
-.Bl -tag -width Ds
-.It Fl m
+.IP -m
显示星期一作为一周的第一天..
(缺省为星期日.)
-.It Fl j
+.IP -j
显示儒略历的(Julian)日期 (以 1 为基的天数, 从 1 月 1 日开始计数) .
-.It Fl y
+.IP -y
显示当前年份的日历..
-.El
.PP
一个单一的参数指定要显示的年份 (1 \- 9999) ;
注意年份必须被完全地指定:
-.Dq Li cal 89
-.Em 不会
+.B cal 89
+.IR 不会
显示1989年的日历.
两个参数表示月份 (1 \- 12) 和年份.
如果没有指定参数, 则显示当前月份的日历.
diff --git a/src/man1/col.1 b/src/man1/col.1
index a9c0f1c..fca3536 100644
--- a/src/man1/col.1
+++ b/src/man1/col.1
@@ -36,84 +36,94 @@
.\"
.TH col 1 1991年6月17日 "COL 1"
.SH NAME(名称)
-.Nm col
-过滤掉输入中的反向换行符
+col \- 过滤掉输入中的反向换行符
.SH SYNOPSIS(总览)
-.Nm col
-.Op Fl bfx
-.Op Fl l Ar num
+.B col
+[
+.B -bfx
+]
+[
+.B -l
+.IR num
+]
.SH DESCRIPTION(描述)
-.Nm Col
+.B col
过滤掉反向(以及半反向)换行符(LF: line feed or NL: new line),
这样输出按正常顺序，即只包括正向和半正向换行符,
而且在可能的地方使用tab替换白空格.这对
-.Xr nroff 1
+nroff(1)
和
-.Xr tbl 1
+tbl(1)
的输出处理很有用处.
.PP
-.Nm col
+.B col
从标准输出读入,并写出到标准输出上.
.PP
选项如下:
-.Bl -tag -width "-lnum"
-.It Fl b
+.TP
+-b
不输出任何退格符,在每列的位置上只打印最后写的那个字符.
-.It Fl f
+.TP
+-f
允许正向半换行符(``fine''模式).
通常,处于半行分界线上的字符打印在下一行.
-.It Fl x
+.TP
+-x
输出多个空格以替换tab.
-.It Fl l Ns Ar num
+.TP
+-l num
在内存中至少缓冲
-.Ar num
+.IR num
行.
默认情况下,缓冲128行.
.El
.PP
-.Nm col
+.B col
所能理解的用于回车操作的控制序列以及它们的十进制值都列在下面的表中:
.PP
.Bl -tag -width "carriage return" -compact
-.It ESC\-7
+.IP ESC\-7
反向换行符(escape后接7)
-.It ESC\-8
+.IP ESC\-8
反向半换行符(escape后接8)
-.It ESC\-9
+.IP ESC\-9
正向半换行符(escape后接9)
-.It backspace
+.IP backspace
反向移动一列(8);在第一列则忽略.
-.It carriage return
+.TP
+carriage return
(13)
-.It newline
+.IP newline
正向换行符(10);同时执行回车(carriage return)操作
-.It shift in
+.TP
+shift in
转到正常字符集(15)
-.It shift out
+.TP
+shift out
转到备选的字符集(14)
-.It space
+.IP space
正向移动一列(32)
-.It tab
+.IP tab
正向移动到下一个tab(9)
-.It vertical tab
+.TP
+vertical tab
反向换行符(11)
-.El
.PP
丢弃所有不被承认的控制字符和escape序列.
.PP
当读取字符时,
-.Nm Col
+.B col
保持着与字符集的联系,而且在输出时确保字符集是正确的.
.PP
如果输入设备试图回复到最近被刷新的行,
-.Nm col
+.B col
会显示一条警告消息.
.SH SEE ALSO(另见)
-.Xr expand 1 ,
-.Xr nroff 1 ,
-.Xr tbl 1
+.BR expand (1)
+.BR nroff (1)
+.BR tbl (1)
.SH HISTORY(历史)
-.Nm col
+.B col
命令出现于AT&T UNIX版本6.
.SH "[中文版维护人]"
.B riser <boomer at ccidnet.com>
diff --git a/src/man1/gcc.1 b/src/man1/gcc.1
index 88fa7b3..3a6eba5 100644
--- a/src/man1/gcc.1
+++ b/src/man1/gcc.1
@@ -3,17 +3,6 @@
.\"
.\" project 工程
.\"
-.\" Set up \*(lq, \*(rq if -man hasn't already set it up.
-.if @@\*(lq@ \{\
-. ds lq "
-. if t .ds lq ``
-. if !@@\(lq@ .ds lq "\(lq
-.\}
-.if @@\*(rq@ \{\
-. ds rq "
-. if t .ds rq ''
-. if !@@\(rq@ .ds rq "\(rq
-.\}
.de Id
.ds Rv \\$3
.ds Dt \\$4
diff --git a/src/man1/host.1 b/src/man1/host.1
index e2c9b8b..fba94dd 100644
--- a/src/man1/host.1
+++ b/src/man1/host.1
@@ -52,27 +52,43 @@
.\" --Copyright--
.TH HOST 1 "1994年12月15日" BSD 4
.SH NAME (名字)
-.Nm host
-使用域名服务器查询主机名字
+.B host \- 使用域名服务器查询主机名字
.SH SYNOPSIS (总览)
-.Nm host
-.Op Fl l
-.Op Fl v
-.Op Fl w
-.Op Fl r
-.Op Fl d
-.Op Fl t Ar querytype
-.Op Fl a
-.Ar host
-.Op Ar server
+.B host
+[
+.B -l
+]
+[
+.B -v
+]
+[
+.B -w
+]
+[
+.B -r
+]
+[
+.B -d
+]
+[
+.B -t
+.IR querytype
+]
+[
+.B -a
+]
+.IR host
+[
+.IR server
+]
.SH DESCRIPTION (描述)
-.Ic Host
+.B Host
查询 Internet 主机 的 信息. 它 通过 一组 分布在 国家间的 互连服务器 获取
这些 信息. 缺省情况下, host 只是 简单的 做 主机名字 和 Internet 地址 的 转换.
然而 通过
-.Dq Fl t
+.B -t
或
-.Dq Fl a
+.B -a
选项, 它 可以 用来 查找 由 域名服务器 维护的 某个主机 的 全部信息.
.PP
参数 可以是 主机名称, 也可以是 数字地址. 此程序 首先 把它 当做 主机的
@@ -81,21 +97,21 @@
例如 topaz.rutgers.edu. 除非 名字 以句点 结尾, 否则 本地域名 将 自动 添加在
后面. 因此, Rutgers 的 用户 可以 输入
.PP
-.D1 Ic host topaz
+host topaz
.PP
它 实际上 查找 "topaz.rutgers.edu".
如果 尝试 失败, 就用 原来输入的 名字 再试一次 (这里就是 "topaz").
邮件 和 其他 网络工具 用了 同样的 策略.
添加在 名字 后面 的 后缀 来自 调用
-.Xr hostname 1
+.B hostname(1)
的 结果, 使用了 第一个点 后面的 全部 数据.
(另见 下面
-.Sx 定制查询主机名字
+.IR 定制查询主机名字
的 描述. )
.PP
第一个参数 是 你 打算查询的 主机名称.
如果 是 数字地址, 就 执行
-.Dq 反向查询 (inverse query)
+\(lq 反向查询 (inverse query) \(rq
也就是说, 域名系统 查看 一系列 独立的 数据库, 把 数字地址 转换成 名字.
.PP
第二个 参数 是 可选的. 它 允许你 指定查询 某个 特定的 服务器. 如果 没有 使用
@@ -103,163 +119,170 @@
.PP
如果 指定了 名字, 你 可以见到 三个 不同种类的 输出. 这里是 它们的 例子:
.PP
-.D1 Ic % host sun4
-.Dl sun4.rutgers.edu is a nickname for ATHOS.RUTGERS.EDU
-.Dl ATHOS.RUTGERS.EDU has address 128.6.5.46
-.Dl ATHOS.RUTGERS.EDU has address 128.6.4.4
-.Dl ATHOS.RUTGERS.EDU mail is handled by ARAMIS.RUTGERS.EDU
+% host sun4
+.br
+sun4.rutgers.edu is a nickname for ATHOS.RUTGERS.EDU
+.br
+ATHOS.RUTGERS.EDU has address 128.6.5.46
+.br
+ATHOS.RUTGERS.EDU has address 128.6.4.4
+.br
+ATHOS.RUTGERS.EDU mail is handled by ARAMIS.RUTGERS.EDU
.PP
-用户 键入的命令 是
-.Dq Ic host sun4 .
-第一行 表明
-.Dq Li sun4.rutgers.edu
-实际上 是 别名. 正式名字 是
-.Dq Li ATHOS.RUTGERS.EDU .
+用户 键入的命令 是 \(lq
+.B host sun4
+\(rq 第一行 表明 \(lq sun4.rutgers.edu \(rq
+实际上 是 别名. 正式名字 是 \(lq ATHOS.RUTGERS.EDU \(rq
接下来 两行 显示 地址. 如果 系统 有 多个 网络接口, host 就 分别 显示 每个
接口 的 地址. 最后一行 表明
-.Li ATHOS.RUTGERS.EDU
+ATHOS.RUTGERS.EDU
不接收 属于它的 邮件, 邮件 由
-.Li ARAMIS.RUTGERS.EDU
+ARAMIS.RUTGERS.EDU
处理. 由于 某些系统 拥有 多个 处理邮件的 系统, 可能 会有 多行 这样的显示.
从 技术角度 看, 我们 认为 每个 能够 接收邮件 的 系统 应该有 这样的项. 如果
系统 接收 它自己的 邮件, 应该 有一项 提及 该系统 自身; 例如:
.PP
-.D1 Li XXX mail is handled by XXX
+Li XXX mail is handled by XXX
.PP
然而, 很多 能够 接收 自己邮件 的 系统 不愿意 提及 这个事实. 如果 系统 有一项
-.Dq Li mail is handled by ,
+.br
+Li mail is handled by ,
+.br
但是 没有 地址, 这 表明 它 不是 Internet 的 一部分, 而是 在 网络上 转发
邮件 的 系统. Usenet, Bitnet 和 许多 其他网络 都有 类似项.
.SH 选项
在 主机名字 前面 能够 使用 很多 选项. 大多数 选项 只对 维护 域名数据库 有意义.
-.Bl -tag -width Fl
+.TP
+.B \-w
.It Fl w
这一项 导致
-.Ic host
+.B host
永久 等待 应答. 正常情况下, 大约 一分钟后 产生 超时.
-.It Fl v
+.TP
+.B \-v
以 "繁琐" 格式 输出, 它是 正式的 主域文件格式, 在 手册页
-.Xr named 8
+named(8)
中 有描述. 没有 这个选项 时, 基本术语 的 输出 仍然 遵循 这个 格式,
-但是 试图 对 普通用户 显示的 更智能些. 如果 不使用
-.Dq Fl v ,
+但是 试图 对 普通用户 显示的 更智能些. 如果 不使用 \-v ,
所有的 "a", "mx", 和 "cname" 项目 显示成 相应的 "has address",
"mail is handled by" 和 "is a nickname for", 而且 不显示 TTL 和类型.
-.It Fl r
+.TP
+.B \-r
查询时 关闭 递归. 这 意味着 名字服务器 只返回 它 自身 数据库 的 数据.
不向 其他服务器 询问 更多 信息.
-.It Fl d
+.TP
+.B \-d
打开 调试功能. 显示 网络应答细节.
+.TP
+\fB-t\fP \fIquerytype\fP
.It Fl t Ar querytype
允许 指定
-.Ar querytype
+.IR querytype
来 查询 某个信息. 手册页
-.Xr named 8
+named(8)
中 定义了 这些 参数. 目前支持的 类型有:
-.Dq Cm a ,
-.Dq Cm ns ,
-.Dq Cm md ,
-.Dq Cm mf ,
-.Dq Cm cname ,
-.Dq Cm soa ,
-.Dq Cm mb ,
-.Dq Cm mg ,
-.Dq Cm mr ,
-.Dq Cm null ,
-.Dq Cm wks ,
-.Dq Cm ptr ,
-.Dq Cm hinfo ,
-.Dq Cm minfo ,
-.Dq Cm mx ,
-.Dq Cm uinfo ,
-.Dq Cm uid ,
-.Dq Cm gid ,
-.Dq Cm unspec .
+a ,
+ns ,
+md ,
+mf ,
+cname ,
+soa ,
+mb ,
+mg ,
+mr ,
+null ,
+wks ,
+ptr ,
+hinfo ,
+minfo ,
+mx ,
+uinfo ,
+uid ,
+gid ,
+unspec .
另外, 通配符 (可以 写成
-.Dq Cm any
+any
或
-.Dq Cm *
+*
) 可以 指定 上面的 任意(全部) 类型. 类型 必须是 小写字符.
注意 缺省 搜索顺序 首先是
-.Dq Cm a ,
+a ,
然后是
-.Dq Cm mx ,
+mx ,
除非 打开了 -v 选项, 使 缺省值 只是
-.Dq Cm a .
-.Dq Fl t
+a .
+\-t
选项 在过滤
-.Ic host
+.IR host
返回的信息 时 非常有用. 更多的 内容 参见 下面
-.Dq Fl l
+\-l
选项 的 说明.
-.It Fl a
-.Dq 全部 ;
+.TP
+.B -a
+全部 ;
等同于
-.Dq Fl v Fl t Cm any .
-.It Fl l
+\-v \-t any
+.TP
+.B -l
列出 全部域项; 例如:
-.PP
-.D1 Ic host -l rutgers.edu
-.PP
+
+host -l rutgers.edu
+
将 列出 rutgers.edu 域 中 所有的 主机.
-.Dq Fl t
+
+\-t
选项 可以 按需 过滤 收到的信息. 缺省值 是 地址信息, 包括 PTR 和 NS
记录.
.PP
-.D1 Ic host -l -v -t any rutgers.edu
+host -l -v -t any rutgers.edu
.PP
命令 以 正式主域文件格式 下载 rutgers.edu 的 全部 区域(zone) 数据.
(然而 由于 某些 复杂原因, SOA 记录 显示了 两次.)
.PP
-.Sy 注意:
-.Dq Fl l
+.B 注意:
+-l
执行 全部的 区域 传输, 然后 过滤出 要求的 信息. 所以 万不得已
才用 这个 命令.
.SH 定制查询主机名字
一般说来, 如果 用户 给出的 名字 中 不含 任何 句点, host 就把 缺省域名
添加在 它的末尾. 缺省域名 能够 定义 在
-.Pa /etc/resolv.conf
+.IR /etc/resolv.conf
中, 但是 通常 从 本机名字 的 第一个 句点 后面 提取.
用户 可以 通过 环境变量
-.Ev LOCALDOMAIN
+.B LOCALDOMAIN
指定 不同的 缺省域名.
另外, 用户 可以 自定义 主机名字 的 缩写. 缩写 存放在 某个文件 中,
一行 一项, 格式是 一个 缩写名字, 一个 空格, 然后是 完整的 主机名.
这个 名字文件 必须 用
-.Ev HOSTALIASES
+.B HOSTALIASES
环境变量 指出.
.SH 环境变量
-.Bl \-tag \-width "/etc/resolv.conf " \-compress
-.It Ev HOSTALIASES
+.IP HOSTALIASES
名字文件, 含有
-.Pq Ar 主机别名 , 主机全名
+.IR (主机别名 , 主机全名)
对.
-.El
.SH 文件
-.Bl -tag -width "/etc/resolv.conf " -compress
-.It Pa /etc/resolv.conf
-另见
-.Xr resolver 5 .
+.IP /etc/resolv.conf
.SH 另见
-.Xr named 8 ,
-.Xr resolver 5 .
+.BR named (8),
+.BR resolver (5)
.SH BUGS
当你 输入的 名字 不属于 本地域 时, 将会 出现 不希望 的 现象.
请记住 除非 输入的名字 以 点 结尾, 否则 本地域名 总会 附加在 它 后面,
失败后 才使用 原来的 名字.
.PP
-.Dq Fl l
+\-l
选项 只 联系 指定域 中 的 第一个 名字服务器. 如果 这个 服务器 宕机,
你 应该 手工 指定 一个 服务器. 例如, 要 获取 foo.edu 的清单, 可以 用
.PP
-.D1 Ic host -t ns foo.edu
+host -t ns foo.edu
.PP
获得 foo.edu 的 全部 名字服务器, 然后 用
.PP
-.D1 Ic host -l foo.edu xxx
+host -l foo.edu xxx
.PP
试验 每一个
-.Dq Ic xxx
+xxx
名字服务器, 直到 碰上 能用的.
.SH "[中文版维护人]"
徐明 <xuming at users.sourceforge.net>
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/chinese/manpages-zh.git
More information about the Chinese-commits
mailing list