Date: Thu, 3 Sep 1998 04:34:37 -0700 (PDT) From: yohta@bres.tsukuba.ac.jp To: freebsd-gnats-submit@FreeBSD.ORG Subject: docs/7819: nroff macro problem(miss reformated) in dig(1) Message-ID: <199809031134.EAA03550@hub.freebsd.org>
index | next in thread | raw e-mail
>Number: 7819
>Category: docs
>Synopsis: nroff macro problem(miss reformated) in dig(1)
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Thu Sep 3 04:40:00 PDT 1998
>Last-Modified:
>Originator: Yoshihiko OHTA
>Organization:
University of Tsukuba
>Release: FreeBSD 2.2.6-RELEASE i386
>Environment:
FreeBSD rishiri.bsys.tsukuba.ac.jp 2.2.6-RELEASE FreeBSD 2.2.6-RELEASE #2: Sun Jun 7 05:14:14 JST 1998 root@rishiri.bsys.tsukuba.ac.jp:/usr/src/sys/compile/FMVTP i386
>Description:
I am nbow translating 3.0-19980727-SNAP manual page.
I find some typo or something in man page of dig(1)
CSV Id is "dig.1,v 8.3 1998/03/21 01:01:23 halley Exp"
1) '.sp' macro is still used in line 102
This should may be .Pp
2) '.Pa' macro is loss period in line 625
This shoud be like:
- file to use in place of Pa /etc/resolv.conf
+ file to use in place of
+ .Pa /etc/resolv.conf
3) .Po and .Pc set (Parenthesis open/close) seems broken or something wrong in line 131-135
document reformated into below:
> /etc/resolv.conf standard resolver (LOCALRESis specific to
> the dig resolver and is not referenced by the). If the
/etc/resolv.conf is previous line. and next line begins with `(' and
end with `)', but last two words (standart resolver) was misplaced.
it shuoud be (LOCALRES is ... by the standard resolver).
The workaround is a) decrease words in parenthesis, b) write `(' and
`)' by hand(not using .Po and .Pc), or c) debug nroff macro.
>How-To-Repeat:
% man dig
>Fix:
--- man1/dig.1~ Thu Aug 27 21:58:44 1998
+++ man1/dig.1 Thu Sep 3 20:32:10 1998
@@ -99,7 +99,7 @@
Internet address. If this optional field is omitted,
.Ic dig
will attempt to use the default name server for your machine.
-.sp 1
+.Pp
.Em Note:
If a domain name is specified, this will be resolved
using the domain name system resolver (i.e., BIND). If your
@@ -128,11 +128,10 @@
to name a file which is to
be used instead of
.Pa /etc/resolv.conf
-.Po Ns Ev LOCALRES
+.Ns Ev (LOCALRES
is specific to the
.Ic dig
-resolver and is not referenced by the standard resolver
-.Pc .
+resolver and is not referenced by the standard resolver).
If the
.Ev LOCALRES
variable is not set or the specified file
@@ -622,7 +621,8 @@
.Sh ENVIRONMENT
.Bl -tag -width "LOCALRES " -compact
.It Ev LOCALRES
-file to use in place of Pa /etc/resolv.conf
+file to use in place of
+.Pa /etc/resolv.conf
.It Ev LOCALDEF
default environment file
.El
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199809031134.EAA03550>