From owner-man-jp-reviewer@jp.FreeBSD.org Fri Oct 22 01:15:41 2004
Received: (from daemon@localhost)
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) id i9LGFfN63143;
	Fri, 22 Oct 2004 01:15:41 +0900 (JST)
	(envelope-from owner-man-jp-reviewer@jp.FreeBSD.org)
Received: from t-mta7.odn.ne.jp (mfep7.odn.ne.jp [143.90.131.185])
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) with ESMTP/inet id i9LGFe863092
	for <man-jp-reviewer@jp.FreeBSD.org>; Fri, 22 Oct 2004 01:15:41 +0900 (JST)
	(envelope-from n-kogane@syd.odn.ne.jp)
Received: from kces1.koganemaru.co.jp ([61.201.152.169])
          by t-mta7.odn.ne.jp with ESMTP
          id <20041021161540566.WGZJ.426371.t-mta7.odn.ne.jp@mta7.odn.ne.jp>
          for <man-jp-reviewer@jp.FreeBSD.org>;
          Fri, 22 Oct 2004 01:15:40 +0900
Received: (from kogane@localhost)
	by kces1.koganemaru.co.jp (8.8.8/3.6W) id BAA01070;
	Fri, 22 Oct 2004 01:15:59 +0900 (JST)
From: Nobuyuki Koganemaru <n-kogane@syd.odn.ne.jp>
Message-Id: <200410211615.BAA01070@kces1.koganemaru.co.jp>
X-Authentication-Warning: kces1.koganemaru.co.jp: kogane set sender to n-kogane using -f
To: man-jp-reviewer@jp.FreeBSD.org
In-Reply-To: <20041021.140116.78717443.hrs@eos.ocn.ne.jp>
Reply-To: man-jp-reviewer@jp.FreeBSD.org
Precedence: list
Date: Fri, 22 Oct 2004 01:15:59 +0900
X-Sequence: man-jp-reviewer 4703
Subject: [man-jp-reviewer 4703] Re: groff_trace.7
Sender: owner-man-jp-reviewer@jp.FreeBSD.org
X-Originator: n-kogane@syd.odn.ne.jp
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+041021

$B>.6b4]$G$9!#(B

>From: Hiroki Sato <hrs@FreeBSD.org>
>Date: Thu, 21 Oct 2004 14:01:16 +0900
>
>$B:4F#!wEl5~M}2JBg3X$G$9!#(B
>
>Nobuyuki Koganemaru <n-kogane@syd.odn.ne.jp> wrote
>  in <200410161247.VAA00567@kces1.koganemaru.co.jp>:
>
>nk> 4.10 $B$H(B 5.3-BETA7 $B$H$[$H$s$I:9J,$,$J$$(B groff_trace.7 $B$rK]Lu$7$?$N$G$9$,!"(B
>nk> $B%W%m%H%3%k$NF0;l$O2?$HLu$;$P$h$$$N$G$7$g$&!)$$$^$$$A$o$+$j$^$;$s!#(B
>nk> $B$I$&Lu$7$?$i$h$$$G$9$+!)(B
>
> $BIaDL$OF0;l$H$7$F;H$o$J$$$b$N$G$9$,!"$"$k<o$N5,B'$N@)8f2<$K$"$k(B
> $B$H$$$&2r<a$G$$$$$H;W$$$^$9!#(B

$B$"$j$,$H$&$4$6$$$^$9!#$J$k$Y$/86J8$K6a$/Lu$7$?$$$N$G!"<!$N$h$&$K=$@5$7$F(B
$B$_$^$7$?!#(B

---- $B$3$3$+$i(B ----
--- groff_trace.7.orig	Sun Oct  3 04:47:27 2004
+++ groff_trace.7	Fri Oct 22 01:13:55 2004
@@ -1,8 +1,9 @@
+.\" $FreeBSD$
 .
 .TH GROFF_TRACE 7 "11 October 2002" "Groff Version 1.19"
-.SH NAME
-groff_trace \- groff macro package trace.tmac
-.SH SYNOPSIS
+.SH $BL>>N(B
+groff_trace \- groff $B%^%/%m%Q%C%1!<%8(B trace.tmac
+.SH $B=q<0(B
 .\" The .SH was moved to this place to make `apropos' happy.
 .
 .
@@ -306,76 +307,79 @@
 .
 .
 .P
-Elements in brackets denote optional arguments, and the ellipsis means
-that there can be any number of arguments of this kind.
+$B3Q3g8L(B ($B%V%i%1%C%H(B) $BCf$NMWAG$O%*%W%7%g%s$N0z?t$r0UL#$7$^$9!#(B
+$B$^$?!">JN,(B (...) $B$O$3$N<o$N0z?t$,$$$/$D$b$"$j$($k$3$H$r0UL#$7$^$9!#(B
+.\" any number of = $B!A$,$$$/$i$b!"$I$C$5$j!"$$$/$D$G$b!"$$$/$i$G$b(B
 .
 .
 .\" --------------------------------------------------------------------
-.SH DESCRIPTION
+.SH $B2r@b(B
 .\" --------------------------------------------------------------------
 .
-The
-.I trace
-macro package of
 .BR groff (1)
-can be a valuable tool for debugging documents written in the roff
-formatting language.
+$B$N(B
+.I trace
+($B%H%l!<%9(B) $B%^%/%m%Q%C%1!<%8$O!"(Broff $B%U%)!<%^%C%H8@8l$G=q$+$l$?J8=q(B
+$B$r%G%P%C%0$9$k$?$a$N2ACM$N$"$k%D!<%k$H$J$j$^$9!#(B
 .
-A call stack trace is protocolled on standard error, that means, a
-diagnostic message is emitted on entering and exiting of a macro call.
+.\" $B8F$S=P$7%9%?%C%/%H%l!<%9$OI8=`%(%i!<$G%W%m%H%3%k(B ($B;XNa(B) $B$5$l$^$9!#MW$9$k$K!"(B
+$B8F$S=P$7%9%?%C%/%H%l!<%9$O!"I8=`%(%i!<$K=PNO$5$l$^$9!#MW$9$k$K!"(B
+.\" $B%^%/%m$N8F$S=P$7$NF~8}$H=P8}$G?GCG%a%C%;!<%8$,H/9T$5$l$k$H$$$&$3$H$G$9!#(B
+$B%^%/%m$N8F$S=P$7$N3+;OE@$H=*N;E@$G?GCG%a%C%;!<%8$,I=<($5$l$k$H$$$&$3$H$G$9!#(B
 .
-This greatly eases to track down an error in some macro.
+$B$3$l$O!"$"$k<o$N%^%/%m$K$*$$$F%(%i!<$NDI@W$KBg$$$KLrN)$A$^$9!#(B
+.\" track down = $B!A$N@W$rFM$-;_$a$k!"DI$$5M$a$k!"DI@W$7$FJa$i$($k(B
 .
 .
 .P
-This tracing process is activated by specifying the groff or troff
-command line option
-.BR "-m\~trace" .
-This works also with the
+$B$3$N%H%l!<%9%W%m%;%9$O!"(Bgroff $B$+(B troff $B%3%^%s%I%i%$%s%*%W%7%g%s(B
+.BR "-m\~trace"
+$B$N;XDj$K$h$j3h@-2=$5$l$^$9!#(B
+$B$3$l$O$5$i$K(B
 .BR groffer (1)
-viewer program.
+$B%S%e!<%"(B ($B1\Mw(B) $B%W%m%0%i%`$GF/$-$^$9!#(B
 .
-A finer control can be obtained by including the macro file within the
-document by the groff macro call
-.BR ".mso\~trace.tmac" .
-Only macros that are defined after this line are traced.
+$B$h$j:Y$+$$@)8f$O!"(Bgroff $B%^%/%m8F$S=P$7(B
+.BR ".mso\~trace.tmac"
+$B$K$h$C$FJ8=qFb$N%^%/%m%U%!%$%k$r4^$a$k$3$H$K$h$jF@$k$3$H$,$G$-$^$9!#(B
+$B$3$N9T$N8e$GDj5A$5$l$k%^%/%m$@$1$,%H%l!<%9$5$l$^$9!#(B
 .
 .
 .P
-If some other macro package should be traced as well it must be specified
-after
+$B$"$kB>$N%^%/%m%Q%C%1!<%8$,F1MM$K%H%l!<%9$5$l$k>l9g!"(B
+$B%3%^%s%I%i%$%s>e$N(B
 .BR "-m\~trace"
-on the command line.
+$B$N8e$G;XDj$5$l$J$1$l$P$J$j$^$;$s!#(B
 .
 .
 .P
-The macro file
+$B$=$l$,%f!<%6$K$h$C$F8F$S=P$5$l$k%^%/%m$r$J$K$b4^$s$G$$$J$$$N$G!"(B
+$B%^%/%m%U%!%$%k(B
 .B trace.tmac
-is unusual because it does not contain any macros to be called by a
-user.
+$B$OIaDL$G$O$"$j$^$;$s!#(B
 .
-Instead, the existing macro definition and appending facilities are
-modified such that they display diagnostic messages.
+$BBe$o$j$K!"4{B8$N%^%/%mDj5A$HDI2C5!G=$O(B
+$B$=$l$i$,?GCG%a%C%;!<%8$rI=<($9$k$h$&$K!"(B
+$B=$@5$5$l$^$9!#(B
 .
 .
 .\" --------------------------------------------------------------------
-.SH EXAMPLES
+.SH $B;HMQNc(B
 .\" --------------------------------------------------------------------
 .
 .P
-In the following examples, a roff fragment is fed into groff via
-standard input.
+$B<!$NNc$K$*$$$F!"(Broff $B%U%i%0%a%s%H$OI8=`F~NO$K$h$C$F(B groff $B$KAw$j9~$^$l$^$9!#(B
+.\" fed into = $BAw$j9~$`(B
 .
-As we are only interested in the diagnostic messages (standard error)
-on the terminal, the normal formatted output (standard output) is
-redirected into the nirvana device
-.IR /dev/null .
-The resulting diagnostic messages are displayed directly below the
-corresponding example.
+$BC<Kv>e$N?GCG%a%C%;!<%8(B ($BI8=`%(%i!<(B) $B$K6=L#$r;}$C$F$$$k$@$1$J$N$G!"(B
+$B@5>o$J%U%)!<%^%C%H$5$l$?=PNO(B ($BI8=`=PNO(B) $B$O%K%k%P!<%J%G%P%$%9(B
+.IR /dev/null
+$B$K=PNO@hJQ99$5$l$^$9!#(B
+$B7k2L$N?GCG%a%C%;!<%8$O!"2<5-$NBP1~$9$kNc$KD>@\I=<($5$l$^$9!#(B
 .
 .
 .\" --------------------------------------------------------------------
-.SS "Command line option"
+.SS "$B%3%^%s%I%i%$%s%*%W%7%g%s(B"
 .
 .P
 .Shell_cmd "echo '."
@@ -393,12 +397,12 @@
 ./Example
 .
 .P
-The entry and the exit of each macro call is displayed on the terminal
-(standard output) \[em] together with the arguments (if any).
+$B%(%s%H%j$H8D!9$N%^%/%m$N8F$S=P$7$N=P8}$OC<Kv(B ($BI8=`=PNO(B)
+$B$KI=<($5$l$^$9(B \[em] ($B$b$7$"$l$P(B) $B0z?t$H0l=o$K!#(B
 .
 .
 .\" --------------------------------------------------------------------
-.SS "Nested macro calls"
+.SS "$BF~$l;R$N%^%/%m8F$S=P$7(B"
 .
 .P
 .Shell_cmd "echo '."
@@ -418,13 +422,14 @@
 ./Example
 .
 .P
-This shows that macro calls can be nested.
+$B$3$l$O%^%/%m8F$S=P$7$rF~$l;R$K$G$-$k$3$H$r<($7$^$9!#(B
 .
-This powerful feature can help to tack down quite complex call stacks.
+$B$3$N6/NO$JFCD'$O!"$+$J$jJ#;($J8F$S=P$7%9%?%C%/$rDI@W$9$k$3$H$r;Y1g$7$^$9!#(B
+.\" $B86J8(B: to tack down $B$O(B to track down $B$N8m$j(B
 .
 .
 .\" --------------------------------------------------------------------
-.SS "Activating with .mso"
+.SS ".mso $B$N3h@-2=(B"
 .
 .Shell_cmd "echo '."
 .Shell_cmd+ ".de before"
@@ -443,102 +448,108 @@
 ./Example
 .
 .P
-Here, the tracing is activated within the document, not by a command
-line option.
+$B$3$3$G!"%H%l!<%9$O%3%^%s%I%i%$%s%*%W%7%g%s$K$h$C$F$G$O$J$/(B
+$BJ8=qFb$G3h@-2=$5$l$^$9!#(B
 .
-As tracing was not active when macro
+$B%^%/%m(B
 .I before
-was defined, no call of this macro is protocolled; on the other hand,
-the macro
+\." $B$,Dj5A$5$l$?;~!"%H%l!<%9$,3h@-$K$J$C$F$$$J$$$N$G!"(B
+$B$,Dj5A$5$l$?;~!"%H%l!<%9$,M-8z$K$J$C$F$$$J$$$N$G!"(B
+.\" $B$3$N%^%/%m$N8F$S=P$7$O%W%m%H%3%k(B ($B;XNa(B) $B$5$l$^$;$s!#(B
+$B$3$N%^%/%m$N8F$S=P$7$O%H%l!<%9$5$l$^$;$s!#(B
+$BB>J}$G!"%^%/%m(B
 .I after
-is fully protocolled.
+.\" $B$O40A4$K%W%m%H%3%k(B ($B;XNa(B) $B$5$l$^$9!#(B
+$B$O40A4$K%H%l!<%9$5$l$^$9!#(B
 .
 .
 .\" --------------------------------------------------------------------
-.SH FILES
+.SH $B4XO"%U%!%$%k(B
 .\" --------------------------------------------------------------------
 .
-The
 .I trace
-macros are kept in the file
+$B%^%/%m$O!"(B
+.IR "tmac $B%G%#%l%/%H%j(B"
+$B$K$"$k%U%!%$%k(B
 .B trace.tmac
-located in the
-.IR "tmac directory" ;
-see
+$B$NCf$G0];}$5$l$^$9!#(B
+$B>\:Y$K4X$7$F$O!"(B
 .BR groff_tmac (5)
-for details.
+$B$r;2>H$7$F$/$@$5$$!#(B
 .
 .
 .\" --------------------------------------------------------------------
-.SH ENVIRONMENT
+.SH $B4D6-JQ?t(B
 .\" --------------------------------------------------------------------
 .
 .TP
 .Env_var $GROFF_TMAC_PATH
-A colon-separated list of additional tmac directories in which to
-search for macro files; see
+$B%^%/%m%U%!%$%k$rC5:w$9$kDI2C$N(B tmac $B%G%#%l%/%H%j$N(B
+$B%3%m%s$GJ,N%$5$l$?%j%9%H!#(B
+$B>\:Y$K4X$7$F$O!"(B
 .BR groff_tmac (5)
-for details.
+$B$r;2>H$7$F$/$@$5$$!#(B
 .
 .
 .\" --------------------------------------------------------------------
-.SH AUTHOR
+.SH $B:n<T(B
 .\" --------------------------------------------------------------------
 .
 Copyright (C) 2002 Free Software Foundation, Inc.
 .
 .P
-This document is distributed under the terms of the FDL (GNU Free
-Documentation License) version 1.1 or later.
+$B$3$NJ8=q$O!"(BFDL (GNU Free Documentation License) $B%P!<%8%g%s(B 1.1 $B0J9_(B
+$B$N>r9`$K=>$C$FG[I[$5$l$^$9!#(B
 .
-You should have received a copy of the FDL on your system, it is also
-available on-line at the
-.URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site" .
+$BMxMQ<T$N%7%9%F%`$N(B FDL $B$N%3%T!<$rF~<j$9$k$Y$-$G$9!#$=$l$O(B
+.URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site"
+$B$G%*%s%i%$%s$G$bF~<j2DG=$G$9!#(B
 .
 .P
-This document is part of
-.IR groff ,
-the GNU roff distribution.
+$B$3$NJ8=q$O(B
+.IR groff
+$B!"(BGNU roff $BG[I[$N0lIt$G$9!#(B
 .
-It was written by
-.MTO bwarken@mayn.de "Bernd Warken".
+$B$=$l$O(B
+.MTO bwarken@mayn.de "Bernd Warken"
+$B$K$h$C$F=q$+$l$^$7$?!#(B
 .
 .
 .\" --------------------------------------------------------------------
-.SH "SEE ALSO"
+.SH "$B4XO"9`L\(B"
 .\" --------------------------------------------------------------------
 .
 .TP
 .BR groff (1)
-An overview of the groff system.
+groff $B%7%9%F%`$N354Q!#(B
 .
 .
 .TP
 .BR troff (1)
-For details on option
-.BR -m .
+$B%*%W%7%g%s(B
+.BR -m
+$B$K$N>\:Y$D$$$F!#(B
 .
 .
 .TP
 .BR groffer (1)
-A viewer program for all kinds of roff documents.
+$B$9$Y$F$N<oN`$N(B roff $BJ8=q$N$?$a$N%S%e!<%"(B ($B1\Mw(B) $B%W%m%0%i%`!#(B
 .
 .
 .TP
 .BR groff_tmac (5)
-A general description of groff macro packages.
+groff $B%^%/%m%Q%C%1!<%8$N0lHLE*$J@bL@!#(B
 .
 .
 .TP
 .BR groff (7)
-A short reference for the groff formatting language.
+groff $B%U%)!<%^%C%H8@8l$N$?$a$NC;$$;2>H!#(B
 .
 .
 .P
-A complete reference for all parts of the groff system is found in the
-groff
+groff $B%7%9%F%`$N$9$Y$F$NItJ,$N$?$a$N40A4$J;2>H$O(B groff
 .BR info (1)
-file.
+$B%U%!%$%k$G8+$D$1$i$l$^$9!#(B
 .
 .
 .\" Local Variables:
---- $B$3$3$^$G(B ----

--
($BM-(B)$B>.6b4]%3%s%T%e!<%?%(%s%8%K%"%j%s%0%5!<%S%9(B ($BJ!2,8)BgLn>k;T(B)
	$B>.6b4](B $B?.9,(B (Nobuyuki Koganemaru)
E-Mail: n-kogane@syd.odn.ne.jp
E-Mail: kogane@jp.FreeBSD.org
E-Mail: kogane@koganemaru.co.jp
URL: http://www.koganemaru.co.jp
