diff --git a/ja_JP.eucJP/man/man1/Makefile b/ja_JP.eucJP/man/man1/Makefile index 495c0d0856..28c2ab8d64 100644 --- a/ja_JP.eucJP/man/man1/Makefile +++ b/ja_JP.eucJP/man/man1/Makefile @@ -1,466 +1,474 @@ MAN1 = a2p.1\ addftinfo.1\ addr2line.1\ + afmtodit.1\ apply.1\ apropos.1\ ar.1\ as.1\ at.1\ basename.1\ bc.1\ bdes.1\ biff.1\ brandelf.1\ builtin.1\ c89.1\ calendar.1\ cap_mkdb.1\ cat.1\ catman.1\ cccp.1\ cdcontrol.1\ checknr.1\ chflags.1\ chgrp.1\ chio.1\ chkey.1\ chmod.1\ chpass.1\ ci.1\ ckdist.1\ cksum.1\ cmp.1\ co.1\ col.1\ colcrt.1\ colldef.1\ colrm.1\ column.1\ comm.1\ compile_et.1\ compress.1\ cp.1\ cpio.1\ crontab.1\ crunchgen.1\ crunchide.1\ ctags.1\ ctm.1\ ctm_rmail.1\ cu.1\ cursor.1\ cut.1\ cvs.1\ date.1\ dc.1\ dd.1\ df.1\ dialog.1\ diff.1\ diff3.1\ dig.1\ dnskeygen.1\ dnsquery.1\ domainname.1\ doscmd.1\ dtmfdecode.1\ du.1\ echo.1\ ed.1\ ee.1\ enigma.1\ eqn.1\ expand.1\ expr.1\ f77.1\ false.1\ fdformat.1\ fdwrite.1\ fetch.1\ file.1\ file2c.1\ find.1\ finger.1\ fmt.1\ fold.1\ fontedit.1\ from.1\ fstat.1\ fsync.1\ ftp.1\ g711conv.1\ gasp.1\ gawk.1\ gcc.1\ gcore.1\ gdb.1\ gdbserver.1\ gencat.1\ getNAME.1\ getopt.1\ gperf.1\ gprof.1\ grep.1\ + grn.1\ grodvi.1\ groff.1\ grog.1\ grohtml.1\ + grolbp.1\ grolj4.1\ grops.1\ grotty.1\ groups.1\ gzexe.1\ gzip.1\ h2ph.1\ head.1\ hexdump.1\ host.1\ hostname.1\ + hpftodit.1\ id.1\ ident.1\ indent.1\ indxbib.1\ info.1\ install-info.1\ install.1\ intro.1\ ipcrm.1\ ipcs.1\ ipftest.1\ ipnat.1\ ipresend.1\ ipsend.1\ iptest.1\ join.1\ jot.1\ kbdcontrol.1\ kbdmap.1\ kcon.1\ kdump.1\ kenv.1\ key.1\ keyinfo.1\ keyinit.1\ keylogin.1\ keylogout.1\ kill.1\ killall.1\ ktrace.1\ lam.1\ last.1\ lastcomm.1\ ld.1\ ldd.1\ leave.1\ less.1\ lesskey.1\ lex.1\ limits.1\ lint.1\ lkbib.1\ ln.1\ loadfont.1\ locate.1\ lock.1\ lockf.1\ logger.1\ login.1\ logname.1\ look.1\ lookbib.1\ lorder.1\ lp.1\ lpq.1\ lpr.1\ lprm.1\ lptest.1\ ls.1\ lsvfs.1\ m4.1\ mail.1\ mailq.1\ make.1\ makeinfo.1\ makewhatis.1\ man.1\ manpath.1\ mcon.1\ md5.1\ merge.1\ mesg.1\ minigzip.1\ mk_cmds.1\ mkdep.1\ mkdir.1\ mkfifo.1\ mklocale.1\ mkstr.1\ mktemp.1\ mptable.1\ msgs.1\ mt.1\ mv.1\ ncal.1\ ncplist.1\ ncplogin.1\ ncplogout.1\ neqn.1\ netstat.1\ newaliases.1\ nfsstat.1\ nice.1\ nm.1\ nohup.1\ nroff.1\ objcopy.1\ objdump.1\ objformat.1\ od.1\ opieinfo.1\ opiekey.1\ opiepasswd.1\ pagesize.1\ passwd.1\ paste.1\ patch.1\ pawd.1\ pax.1\ perl.1\ pfbtops.1\ pic.1\ pim6stat.1\ pkg_add.1\ pkg_create.1\ pkg_delete.1\ pkg_info.1\ + pkg_sign.1\ + pkg_update.1\ pkg_version.1\ pr.1\ printenv.1\ printf.1\ ps.1\ psroff.1\ pwd.1\ quota.1\ ranlib.1\ rcp.1\ rcs.1\ rcsclean.1\ rcsdiff.1\ rcsfreeze.1\ rcsintro.1\ rcsmerge.1\ rdist.1\ + realpath.1\ refer.1\ rev.1\ rlog.1\ rlogin.1\ rm.1\ rmdir.1\ rpcgen.1\ rs.1\ rsh.1\ rtld.1\ rtprio.1\ rup.1\ ruptime.1\ rusers.1\ rwall.1\ rwho.1\ s2p.1\ sasc.1\ scon.1\ script.1\ sdiff.1\ sed.1\ send-pr.1\ sgsc.1\ sh.1\ shar.1\ size.1\ skey.1\ sleep.1\ sockstat.1\ soelim.1\ sort.1\ split.1\ startslip.1\ strings.1\ strip.1\ stty.1\ su.1\ symorder.1\ systat.1\ tail.1\ talk.1\ tar.1\ tbl.1\ tcopy.1\ tcpdump.1\ tcpslice.1\ tcsh.1\ tee.1\ telnet.1\ test.1\ texindex.1\ tfmtodit.1\ tftp.1\ time.1\ tip.1\ top.1\ touch.1\ tput.1\ tr.1\ troff.1\ true.1\ truncate.1\ truss.1\ tset.1\ tsort.1\ tty.1\ ul.1\ uname.1\ unifdef.1\ uniq.1\ units.1\ unvis.1\ uptime.1\ users.1\ uuconv.1\ uucp.1\ uuencode.1\ uulog.1\ uuname.1\ uupick.1\ uustat.1\ uuto.1\ uux.1\ vacation.1\ vgrind.1\ vi.1\ vidcontrol.1\ vis.1\ vt220keys.1\ vttest.1\ w.1\ wall.1\ wc.1\ what.1\ whereis.1\ which.1\ who.1\ whoami.1\ whois.1\ window.1\ write.1\ xargs.1\ xstr.1\ xten.1\ yacc.1\ yes.1\ ypcat.1\ ypmatch.1\ ypwhich.1\ yyfix.1\ zdiff.1\ zforce.1\ zmore.1\ znew.1 MLINKS= builtin.1 alias.1 builtin.1 alloc.1 builtin.1 bg.1 builtin.1 bindkey.1 \ builtin.1 break.1 builtin.1 breaksw.1 builtin.1 builtins.1 \ builtin.1 case.1 builtin.1 cd.1 builtin.1 chdir.1 builtin.1 command.1 \ builtin.1 complete.1 \ builtin.1 continue.1 builtin.1 default.1 \ builtin.1 dirs.1 builtin.1 do.1 builtin.1 done.1 \ builtin.1 echotc.1 builtin.1 elif.1 builtin.1 else.1 \ builtin.1 end.1 builtin.1 endif.1 builtin.1 endsw.1 \ builtin.1 esac.1 builtin.1 eval.1 builtin.1 exec.1 \ builtin.1 exit.1 builtin.1 export.1 builtin.1 fc.1 \ builtin.1 fg.1 builtin.1 fi.1 builtin.1 filetest.1 builtin.1 for.1 \ builtin.1 foreach.1 builtin.1 getopts.1 builtin.1 glob.1 \ builtin.1 goto.1 builtin.1 hash.1 builtin.1 hashstat.1 \ builtin.1 history.1 builtin.1 hup.1 builtin.1 if.1 builtin.1 jobid.1 \ builtin.1 jobs.1 builtin.1 limit.1 builtin.1 log.1 builtin.1 logout.1 \ builtin.1 ls-F.1 \ builtin.1 notify.1 builtin.1 onintr.1 builtin.1 popd.1 \ builtin.1 pushd.1 builtin.1 read.1 builtin.1 readonly.1 \ builtin.1 rehash.1 \ builtin.1 repeat.1 builtin.1 sched.1 builtin.1 set.1 \ builtin.1 setenv.1 builtin.1 settc.1 builtin.1 setty.1 \ builtin.1 setvar.1 builtin.1 shift.1 builtin.1 source.1 \ builtin.1 stop.1 builtin.1 suspend.1 builtin.1 switch.1 \ builtin.1 telltc.1 builtin.1 then.1 builtin.1 trap.1 builtin.1 type.1 \ builtin.1 ulimit.1 builtin.1 umask.1 builtin.1 unalias.1 \ builtin.1 uncomplete.1 \ builtin.1 unhash.1 builtin.1 unlimit.1 builtin.1 unset.1 \ builtin.1 unsetenv.1 builtin.1 until.1 builtin.1 wait.1 \ builtin.1 where.1 \ builtin.1 while.1 MLINKS+=ed.1 red.1 MLINKS+=test.1 '[.1' MLINKS+=gawk.1 awk.1 MLINKS+=gcc.1 cc.1 MLINKS+=gcc.1 c++.1 MLINKS+=gcc.1 g++.1 MLINKS+=gcc.1 CC.1 MLINKS+=cccp.1 cpp.1 MLINKS+=grep.1 egrep.1 MLINKS+=grep.1 fgrep.1 MLINKS+=grep.1 zgrep.1 MLINKS+=grep.1 zegrep.1 MLINKS+=grep.1 zfgrep.1 MLINKS+=gzip.1 gunzip.1 MLINKS+=gzip.1 zcat.1 MLINKS+=gzip.1 gzcat.1 MLINKS+=zdiff.1 zcmp.1 MLINKS+=apropos.1 whatis.1 MLINKS+=send-pr.1 sendbug.1 MLINKS+=at.1 batch.1 MLINKS+=at.1 atq.1 MLINKS+=at.1 atrm.1 MLINKS+=basename.1 dirname.1 MLINKS+=chpass.1 chfn.1 MLINKS+=chpass.1 chsh.1 MLINKS+=chpass.1 ypchpass.1 MLINKS+=chpass.1 ypchfn.1 MLINKS+=chpass.1 ypchsh.1 MLINKS+=compress.1 uncompress.1 MLINKS+=ee.1 ree.1 MLINKS+=expand.1 unexpand.1 MLINKS+=ftp.1 pftp.1 MLINKS+=ftp.1 gate-ftp.1 MLINKS+=hexdump.1 hd.1 MLINKS+=intro.1 introduction.1 MLINKS+=less.1 more.1 MLINKS+=lex.1 flex.1 MLINKS+=lex.1 flex++.1 MLINKS+=lex.1 lex++.1 MLINKS+=mail.1 Mail.1 MLINKS+=passwd.1 yppasswd.1 MLINKS+=printenv.1 env.1 MLINKS+=rtld.1 ld-elf.so.1 MLINKS+=tput.1 clear.1 MLINKS+=tset.1 reset.1 MLINKS+=vi.1 ex.1 MLINKS+=vi.1 view.1 MLINKS+=vi.1 nex.1 MLINKS+=vi.1 nview.1 MLINKS+=vi.1 nvi.1 MLINKS+=yacc.1 byacc.1 MLINKS+=ctm_rmail.1 ctm_smail.1 MLINKS+=ctm_rmail.1 ctm_dequeue.1 MLINKS+=kbdmap.1 vidfont.1 MLINKS+=rtprio.1 idprio.1 MLINKS+=cksum.1 sum.1 MLINKS+=ktrace.1 trace.1 MLINKS+=uuencode.1 uudecode.1 MLINKS+=ncal.1 cal.1 MLINKS+=enigma.1 crypt.1 MLINKS+=ln.1 link.1 MLINKS+=rm.1 unlink.1 MLINKS+=opiekey.1 otp-md4.1 MLINKS+=opiekey.1 otp-md5.1 MLINKS+=tcsh.1 csh.1 MLINKS+=ee.1 edit.1 +MLINKS+=pkg_sign.1 pkg_check.1 .include "bsd.prog.mk" diff --git a/ja_JP.eucJP/man/man1/afmtodit.1 b/ja_JP.eucJP/man/man1/afmtodit.1 new file mode 100644 index 0000000000..81534f3c5e --- /dev/null +++ b/ja_JP.eucJP/man/man1/afmtodit.1 @@ -0,0 +1,226 @@ +.ig \"-*- nroff -*- +.\" jpman %Id: afmtodit.1,v 1.4 2001/03/08 14:57:49 mistral Stab % +Copyright (C) 1989-2000 Free Software Foundation, Inc. + +Permission is granted to make and distribute verbatim copies of +this manual provided the copyright notice and this permission notice +are preserved on all copies. + +Permission is granted to copy and distribute modified versions of this +manual under the conditions for verbatim copying, provided that the +entire resulting derived work is distributed under the terms of a +permission notice identical to this one. + +Permission is granted to copy and distribute translations of this +manual into another language, under the above conditions for modified +versions, except that this permission notice may be included in +translations approved by the Free Software Foundation instead of in +the original English. +.. +.\" Like TP, but if specified indent is more than half +.\" the current line-length - indent, use the default indent. +.de Tp +.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP +.el .TP "\\$1" +.. +.\" WORD: left italic correction 左イタリック補正 +.\" WORD: bounding box: バウンディングボックス [grops.1,psbb.1] +.TH AFMTODIT 1 "7 December 2000" "Groff Version 1.16.1" +.SH 名称 +afmtodit \- groff \-Tps で用いるフォントファイルを作成する +.SH 書式 +.nr a \n(.j +.ad l +.nr i \n(.i +.in +\w'\fBafmtodit 'u +.ti \niu +.B afmtodit +.de OP +.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]" +.el .RB "[\ " "\\$1" "\ ]" +.. +.OP \-ns +.OP \-d desc_file +.OP \-e enc_file +.OP \-i n +.OP \-a n +.I afm_file +.I map_file +.I font +.br +.ad \na +.SH 解説 +.B afmtodit +は、groff および +.B grops +で用いるフォントファイルを作成します。 +.B afmtodit +は perl で記述されていますので、これを使用するには perl +バージョン 3 がインストールされている必要があります。 +.I afm_file +は、フォント作成に用いる AFM (Adobe Font Metric) ファイルです。 +.I map_file +は、groff 上の文字名と PostScript 上の文字名の対応を定義するファイルです。 +このファイルの各行は、下記のフォーマットから成ります。 +.IP +.I +ps_char groff_char +.LP +ここで、 +.I ps_char +はその文字の PostScript 上の名前、 +.I groff_char +はその文字の groff 上の名前 (つまり、groff フォントファイルで使用される名前) +です。 +.I map_file +内には同じ +.I ps_char +が 2 回以上使用されていてもかまいません。しかし、 +同じ +.I groff_char +を 2 回以上使用することはできません。 +.I font +は、このフォントの groff 上の名前です。 +もし、 +.I map_file +で定義されていない PostScript 文字が +このフォントのエンコード方式に含まれていた場合、 +.B afmtodit +はその文字を名前のない文字として groff フォントファイルに出力します。 +名前のない文字を +.B troff +上で扱うには、エスケープシーケンス +.B \eN +を使用します。 +groff フォントファイルは +.I font +という名前のファイルに出力されます。 +.LP +そのフォントに対するダウンロード可能なフォントがある場合、ファイル +.B /usr/share/groff_font/devps/download +に列挙可能です。 +.BR grops (1) +を参照してください。 +.LP +.B \-i +オプションが指定されていた場合、 +.B afmtodit +は各文字についてイタリック補正 (italic correction)、 +左イタリック補正 (left italic correction) および +添字補正 (subscript correction) を自動生成します +(これら補正パラメータの意味については、 +.BR groff_font (5) +を参照してください)。 +これらのパラメータは、各文字ごとに +.I afm_file +に下記の行を追加することにより設定されます。 +.IP +.BI italicCorrection\ ps_char\ n +.br +.BI leftItalicCorrection\ ps_char\ n +.br +.BI subscriptCorrection\ ps_char\ n +.LP +ここで、 +.I ps_char +はその文字の PostScript 上の名前、 +.I n +はパラメータの値 (1/1000 em 単位) です。 +これらのパラメータは、通常はイタリックフォント +(または斜体) でのみ必要とされます。 +.SH オプション +.TP +.B \-n +このフォントには +.B ligatures +コマンド (合字) を出力しません。 +等幅フォント使用時に指定してください。 +.TP +.B \-s +特殊なフォントであることを指定します。フォントファイルに +.B special +コマンドを追加します。 +.TP +.BI \-d desc_file +デバイス記述ファイルをデフォルトの +.B DESC +ではなく、 +.I desc_file +に指定します。 +.TP +.BI \-e enc_file +PostScript フォントが、 +.I enc_file +内に記述されているエンコード方式で再エンコードされるべきことを指定します。 +.I enc_file +のフォーマットは +.BR grops (1) +を参照してください。 +.TP +.BI \-a n +フォントファイル内で、 +.I n +を傾斜パラメータとして使用します。 +このパラメータは groff がアクセント記号の位置を決定するのに使用され、 +デフォルトの値は、 +.I afm_file +の中で指定される ItalicAngle 値に -1 を掛けた値です。 +しかし、実際のイタリックフォントではもっと小さな値の方が +望ましいことがあります。 +もし、イタリックフォントに付くアクセント記号が +正しい位置から離れすぎていると感じた場合、 +.B \-a +オプションを使用して、より小さな傾斜パラメータを与えてください。 +.TP +.BI \-i n +各文字のイタリック補正を生成します。 +文字幅とイタリック補正の和が、 +.I n +/1000 em と +「文字のバウンディングボックスの右端が文字の原点からどれだけ右にあるか」 +の和に等しくなるように、イタリック補正が生成されます。 +負のイタリック補正になってしまう生成結果の場合、 +その値の代りに 0 がイタリック補正として使用されます。 +.IP +同様に、各文字の添字補正も生成します。 +そのフォントの傾斜パラメータの正接 (tangent) に +そのフォントの x の高さの 4/5 を掛けた値が、添字補正になります。 +添字補正がイタリック補正より大きな値になってしまう生成結果の場合、 +その値の代りにイタリック補正の値が添字補正として使用されます。 +.IP +同様に、各文字の左イタリック補正も生成します。 +左イタリック補正は、 +.I n +/1000 em と +「文字のバウンディングボックスの左端が文字の原点からどれだけ左にあるか」 +の和に等しくなるように、生成されます。 +左イタリック補正は、負値になる場合があります。 +.IP +このパラメータは、通常はイタリックフォント (または斜体) +でのみ必要とされます。groff と共に配布されるフォントファイルは、 +イタリックフォントに +.B \-i50 +オプションを使用して生成されています。 +.SH 関連ファイル +.Tp \w'\fB/usr/share/groff_font/devps/download'u+2n +.B /usr/share/groff_font/devps/DESC +デバイス記述ファイル +.TP +.BI /usr/share/groff_font/devps/ F +フォント +.I F +のフォント記述ファイル +.TP +.B /usr/share/groff_font/devps/download +ダウンロード可能なフォントの一覧 +.TP +.B /usr/share/groff_font/devps/text.enc +テキストフォントで使用されるエンコード方式 +.TP +.B /usr/share/groff_font/devps/generate/textmap +標準の対応表 +.SH 関連項目 +.BR groff (1), +.BR grops (1), +.BR groff_font (5), +.BR perl (1) diff --git a/ja_JP.eucJP/man/man1/grn.1 b/ja_JP.eucJP/man/man1/grn.1 new file mode 100644 index 0000000000..da6a4dff90 --- /dev/null +++ b/ja_JP.eucJP/man/man1/grn.1 @@ -0,0 +1,659 @@ +.ig \"-*- nroff -*- +Copyright (C) 2000 Free Software Foundation, Inc. + +Permission is granted to make and distribute verbatim copies of +this manual provided the copyright notice and this permission notice +are preserved on all copies. + +Permission is granted to copy and distribute modified versions of this +manual under the conditions for verbatim copying, provided that the +entire resulting derived work is distributed under the terms of a +permission notice identical to this one. + +Permission is granted to copy and distribute translations of this +manual into another language, under the above conditions for modified +versions, except that this permission notice may be included in +translations approved by the Free Software Foundation instead of in +the original English. +.. +.\" jpman %Id: grn.1,v 1.2 2001/03/12 15:49:22 yt-kage Stab % +.de TQ +.br +.ns +.TP \\$1 +.. +.\" Like TP, but if specified indent is more than half +.\" the current line-length - indent, use the default indent. +.de Tp +.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP +.el .TP "\\$1" +.. +.\" WORD: stipple font スティプルフォント +.\" WORD: dotted line 点線 +.\" WORD: dashed line 破線 +.\" WORD: dot-dashed line 1 点鎖線 +.TH GRN 1 "7 December 2000" "Groff Version 1.16.1" +.SH 名称 +grn \- gremlin ファイル用 groff プリプロセッサ +.SH 書式 +.BR grn +[ +.B \-Cv +] +[ +.BI \-T dev +] +[ +.BI \-M dir +] +[ +.BI \-F dir +] +[ +.IR file\.\.\. +] +.PP +コマンドラインオプションとパラメータの間にはホワイトスペースを入れる +ことができます。 +.SH 解説 +.I grn +は、 +.I groff +の入力中に +.I gremlin +図を入れるためのプリプロセッサです。 +.I grn +は、 +.B .GS +と +.BR .GE +の間にはさまれた入力行のみを処理し、標準出力に書き出します。 +処理される行には +.I grn +コマンド (後述) が含まれていなくてはなりません。 +これらのコマンドは、 +.I gremlin +ファイルを要求し、そのファイル中の図を変換し +.I troff +の入力ストリームに置きます。 +.B .GS +リクエストは、続けて C, L, R をとることができ、 +.I gremlin +図全体を中央寄せ、左寄せ、あるいは右寄せにすることができます +(デフォルトは中央寄せです)。 +.I file +が指定されていない場合は、標準入力が読み込まれます。 +図の最後では、ページ位置は +.I gremlin +図の下になります。 +.I grn +エントリが +.BR .GE +ではなく +.B .GF +で終わっている場合は、ページ位置は図の左上になります。 +.PP +現在のところ、\-me マクロパッケージだけが +.BR .GS , +.BR .GE , +および +.BR .GF +をサポートしていることに注意してください。 +.PP +次のコマンドラインオプションを理解します: +.TP +.BI \-T dev +プリンタ +.IR dev +用の出力を用意します。 +デフォルトのデバイスは +.BR ps +です。受け付け可能なデバイスについては +.BR groff (1) +を参照してください。 +.TP +.BI \-M dir +ライブラリディレクトリを +.IR dir +に設定します。 +カレントディレクトリに +.I gremlin +ファイルがなかった場合は、ファイル名の前に +.I dir +をつけ、再度ファイルを読み込もうとします。 +ライブラリディレクトリのデフォルトは +.BR /usr/share/tmac +です。 +.TP +.BI \-F dir +.I dir +中からサブディレクトリ +.BI dev name +.RI ( name +はデバイス名です) を探し、通常の +.BR /usr/share/groff_font +の前に読み込まれる +.B DESC +ファイルを探します。 +.TP +.B \-C +たとえ空白や改行以外の文字が後に続いていても +.B .GS +および +.B .GE +(それぞれに対して +.BR .GF ) +を認識します。 +.\".TP +.\".B \-s +.\"This switch causes the picture to be traversed twice: +.\"The first time, only the interiors of filled polygons (as borderless +.\"polygons) are printed. +.\"The second time, the outline is printed as a series of line segments. +.\"This way, postprocessors that overwrite rather than merge picture elements +.\"(such as Postscript) can still have text and graphics on a shaded +.\"background. +.TP +.B \-v +バージョン番号を表示します。 +.SH grn コマンド +.B .GS +と +.B .GE +にはさまれた入力行はそれぞれ 1 つずつ +.I grn +コマンドを持っています。 +コマンドは、ホワイトスペースで区切られた 1 つあるいは 2 つの文字列で +できています。最初の文字列はコマンドであり、2 番目の文字列は +オペランドです。 +コマンドは大文字小文字どちらでも良く、省略して 1 文字にすることも +できます。 +.PP +図の環境に影響を与えるコマンド (これらは +.BR default +の前にリストされています。後述を参照してください) は、現在の図に対して +のみ効果を持ちます。 +次の図が始まると、環境は再度デフォルトに初期化されます。 +コマンドは次のとおりです: +.TP +.BI 1\ N +.TQ +.BI 2\ N +.TQ +.BI 3\ N +.TQ +.BI 4\ N +.IR gremlin +のテキストサイズ番号 1 (2, 3, あるいは 4) を +.I N +ポイントに設定します。 +デフォルトは 12 (16, 24, および 36) です。 +.TP +.BI roman\ f +.TQ +.BI italics\ f +.TQ +.BI bold\ f +.TQ +.BI special\ f +ローマン体 (イタリック体、ボールド体、あるいは特殊文字) の +フォントを +.IR troff +フォント +.I f +(フォント名あるいは番号) に設定します。 +デフォルトは R (I, B, および S) です。 +.TP +.BI l\ f +.TQ +.BI stipple\ f +スティプル (stipple) フォントを +.IR troff +のスティプルフォント +.I f +(フォント名あるいは番号) +に設定します。 +コマンド +.B stipple +は、`st' までになら省略できます +( +.BR special +との混乱を避けるためです)。 +スティプルフォントにはデフォルトは +.I ありません +(デフォルトコマンドで設定されていない限りは)。そして、 +スティプルフォントを指定しないままポリゴンを含んだ +.I gremlin +図を取り込むのは不正になります。 +.TP +.BI x\ N +.TQ +.BI scale\ N +(デフォルトの拡大処理に加えて) gremlin 図を +.IR N +倍に拡大します。ここで N は 0 より大きな浮動小数値です。 +コマンド +.B scale +は、`sc' までになら省略できます。 +.TP +.BI narrow\ N +.TQ +.BI medium\ N +.TQ +.BI thick\ N +細線 (中間の太さの線、および太線) の太さを +0.15 ポイント (この値は、コンパイル時に変更できます) の +.I N +倍に設定します。 +デフォルトは 1.0 (3.0, 5.0) です。これは、0.15 ポイント +(0.45 ポイントおよび 0.75 ポイント) に対応しています。 +太さを表す値が 0 のときは、使用できる中で最も小さな値を +選択します。 +負の値をとると、線の太さが現在のポイントサイズに比例したものに +なります。 +.TP +.BI pointscale\ +テキストを図に合うようにスケーリングします。 +gremlin テキストは、通常、図のスケールファクタによらず、 +コマンド +.BR 1 ,\ 2 ,\ 3 ,\ あるいは\ 4 +で指定されるポイントサイズで表示されます。 +.B pointscale +を設定すると、ポイントサイズが図に合わせて変更されます +(もちろん、 +.IR troff +の制限内で)。 +.I off +以外のオペランドは何であっても +テキストのスケーリングを有効にします。 +.TP +.B default +現在の図の環境をデフォルトに戻します。 +このオプションは、 +.I troff +入力ファイルの先頭でグローバルパラメータを設定するメカニズムとして +使われることを意図していますが、デフォルトの設定に戻したいときには +いつでも使うことができます。 +.TP +.BI width\ N +図を強制的に幅 +.I N +インチにします。 +このオプションは、同じ図中に存在する他のスケールファクタを +上書きします。 +.RB ` width +.IR 0 ' +とすると、無視されます。 +.TP +.BI height\ N +他のスケールファクタを上書きして、図を強制的に高さ +.I N +インチにします。 +`width' と `height' 両方が指定されているときには、より値の小さい定数が +図のスケールを決定します。 +.B height +および +.B width +コマンドは +.B default +コマンドを使って保存はされません。 +しかしながら、このオプションが設定されている場合には +ポイントサイズのスケーリングに影響を与えます。 +.TP +.BI file\ name +カレントディレクトリ (あるいはライブラリディレクトリ。前述の +.B \-M +オプションを参照してください) に置かれた +.I gremlin +ファイル +.I name +から図を取得します。 +.B file +コマンドが 2 つ与えられた場合、2 つめのコマンドが最初のコマンドを +上書きします。 +.I name +が存在していない場合は、エラーメッセージが報告され、 +.B .GE +行から処理が再開されます。 +.SH groff に関しての注意 +.I grn +はプリプロセッサですので、現在のインデントやポイントサイズ、 +余白や番号レジスタなどについては分かりません。 +そのため、 +.B .GS +リクエストと +.B .GE +リクエストの間には +.I troff +への入力を置くことができません。 +しかしながら、 +.I gremlin +テキストは現在 +.IR troff +で処理されます。そのため、 +.I gremlin +テキスト行にある +.I troff +への入力行はどれも正しいものになります (ただし、 +行頭に `.' ディレクティブを置くことは禁止されています)。 +そのため、 +.I gremlin +ファイル中に +定義済みのデリミタ (例えば +.IR $$ ) +で括った +.I eqn +表記を埋め込むことによって、 +.I gremlin +図の中に等式を書くことができます。 +.PP +.I grn +を他のプリプロセッサと一緒に使う場合、 +.IR tbl +が仕事をしすぎないように +.IR grn , +.IR pic , +および +.I ideal +よりも前に +.I tbl +を呼び出すのが最も良いやり方です。 +.I eqn +は必ず最後に起動させる必要があります。 +.PP +図はエンティティとみなされますが、 +ページの末尾を越えてしまった場合、 +.I troff +は図を分割しようとしてしまいます。 +\-me マクロ中で図を `keeps' 中に置くことで +適切な位置決めができるようになります。 +.PP +.I grn +は +.IR troff +の番号レジスタ +.B g1 +から +.B g9 +までを使い、そして +.B .GS +リクエストを処理する前にレジスタ +.B g1 +および +.B g2 +に +.I gremlin +図の幅および高さ (デバイス単位) を設定します +(これらのマクロを書き直したいと思っている人たちのために +そうしています)。 +.SH gremlin ファイル形式 +.I gremlin +ファイル形式には 2 つの異なった形式があります。 +.I AED +グラフィック端末用バージョンからのオリジナルの形式と +.I SUN +および +.I X11 +バージョンの形式です。 +負の座標を用いた参照点を容認する +.IR SUN / X11 +バージョンの拡張機能は、 +.I AED +バージョンとは互換性が +.B ありません +。 +.I gremlin +ファイルに負の座標が含まれていない限りは、どちらの形式のファイルも +.I gremlin +あるいは +.IR grn +で読み込むことができます。 +他に +.IR SUN / X11 +フォーマットが異なる点は、図のオブジェクトに対して番号を +使うのではなく、名前 (例えば、POLYGON, CURVE) を使うことです。 +同じ図を表すファイルを、それぞれの形式について 表 1 に示します。 +.sp +.DS +.TS +center, tab(@); +l lw(0.1i) l. +sungremlinfile@@gremlinfile +0 240.00 128.00@@0 240.00 128.00 +CENTCENT@@2 +240.00 128.00@@240.00 128.00 +185.00 120.00@@185.00 120.00 +240.00 120.00@@240.00 120.00 +296.00 120.00@@296.00 120.00 +*@@-1.00 -1.00 +2 3@@2 3 +10 A Triangle@@10 A Triangle +POLYGON@@6 +224.00 416.00@@224.00 416.00 +96.00 160.00@@96.00 160.00 +384.00 160.00@@384.00 160.00 +*@@-1.00 -1.00 +5 1@@5 1 +0@@0 +-1@@-1 +.T& +css. +.sp +表 1. ファイル例 +.TE +.DE +.sp +.IP \(bu +それぞれの +.I gremlin +ファイルの 1 行目は、 +文字列 +.B gremlinfile +.RI ( AED +バージョン) あるいは +.B sungremlinfile +.RI ( SUN / X11 バージョン) +のどちらかです。 +.IP \(bu +ファイルの 2 行目には点の位置を決めるための方向、 +.B x +および +.B y +の値が含まれており、各値は空白で区切られています。 +.B 0 +あるいは +.BR 1 +をとる方向は、 +.IR SUN / X11 +バージョンでは無視されます。 +.B 0 +は、 +.I gremlin +図が水平方向の形式で表示されることを意味しています +(描画領域の幅が実際の図の高さよりも広くとられ、 +上部にメニューがつきます)。 +.B 1 +は、 +.I gremlin +図が垂直方向の形式で表示されることを意味しています +(描画領域の高さが実際の図の幅よりも高くとられ、 +左側にメニューがつきます)。 +.B x +および +.B y +は浮動小数値であり、このファイルが他のファイルに読み込まれる +際に利用される位置を与えます。 +この行の要素は、それほど重要なものではありません。 ``1 0.00 +0.00'' という値を推奨します。 +.IP \(bu +このファイルの残りの部分は 0 個あるいは 1 個以上の要素を +記述したものになっています。 +最後の要素を記述した後には、文字列 ``-1'' を持った行がきます。 +.SH 要素の記述 +.IP \(bu +各要素の最初の行には、要素タイプを与える 10 進数 +.RI ( AED +バージョンの場合) あるいは要素の ASCII 文字での名称 +.RI ( SUN / X11 +バージョンの場合) +が 1 つ +含まれています。 +表 2 を参照してください。 +.sp +.DS +.TS +center, tab(@); +css +ccc +nll. +\fIgremlin\fP ファイルフォーマット \(mi オブジェクトタイプの仕様 +.sp +\fIAED\fP 番号@\fISUN\fP/\fIX11\fP 名称@解説 +0@BOTLEFT@左下揃えのテキスト +1@BOTRIGHT@右下揃えのテキスト +2@CENTCENT@中央揃えのテキスト +3@VECTOR@ベクトル +4@ARC@円弧 +5@CURVE@曲線 +6@POLYGON@ポリゴン +10@TOPLEFT@左上揃えのテキスト +11@TOPCENT@中央上揃えのテキスト +12@TOPRIGHT@右上揃えのテキスト +13@CENTLEFT@左中央揃えのテキスト +14@CENTRIGHT@右中央揃えのテキスト +15@BOTCENT@中央下揃えのテキスト +.T& +css. +.sp +表 2. +\fIgremlin\fP ファイルにおける要素タイプの仕様 +.TE +.DE +.sp +.IP \(bu +オブジェクトタイプの後には、可変数の行がきます。 +各行は、オブジェクトの要素を表示するのに使われる点を指定します。 +各行には、x 座標および y 座標が浮動小数値で入っており、 +それぞれは空白文字で区切られています。 +点のリストは、文字列 ``-1.0 -1.0'' を含んだ行 +.RI ( AED +バージョンの場合) あるいはアスタリスク ``*'' 1 個 +.RI ( SUN / X11 +バージョンの場合) で終わります。 +.IP \(bu +点の後には、10 進数 2 個を含んだ行がきます。これは、 +要素に対するブラシとサイズを与えます。 +ブラシは、オブジェクトが描かれる際のスタイルを決定します。 +ベクトル、円弧、および曲線については、ブラシの値として +正しいものが 6 個あります: +.sp +.DS +.TS +center, tab(@); +ncw(0.1i)l. +1 \(mi@@細い点線 +2 \(mi@@細い一点鎖線 +3 \(mi@@太い直線 +4 \(mi@@細い破線 +5 \(mi@@細い直線 +6 \(mi@@通常の直線 +.TE +.DE +.sp +ポリゴンに対しては、さらに 0 も正しい値となります。 +この値は、境界線の見えないポリゴンを指定するものです。 +テキストに対しては、ブラシは次のフォントを選択します: +.sp +.DS +.TS +center, tab(@); +ncw(0.1i)l. +1 \(mi@@ローマン体 (groff での R フォント) +2 \(mi@@イタリック体 (groff での I フォント) +3 \(mi@@ボールド体 (groff での B フォント) +4 \(mi@@特殊文字 (groff での S フォント) +.TE +.DE +.sp +図を +.IR groff +に通すために +.I grn +を使っている場合は、 +ここでのフォントはただ開始時のフォントになるだけです: +テキスト文字列には、 +``\\fI'' +や +``\\d'' +のような、 (他の多くのものがそうであるように) フォントを +変更する可能性のあるフォーマット用シーケンスを含んでも +構いません。 +テキストでは、サイズフィールドは 1 から 4 までの +10 進数です。 +これは、テキストが書かれるフォントサイズを選択します。 +ポリゴンに対しては、このサイズフィールドはポリゴン内部を +埋めるために使われる点番号と解釈されます。 +この番号は、表示する際にスティプルフォントに置き換える +インデックスとして使われます。 +.IP \(bu +各要素の最終行には、10 進数と文字列が空白文字 1 つで +区切られて入っています。 +10 進数は、文字列中の文字数をカウントしたものです。 +この情報はテキスト要素に対してのみ使われ、 +テキスト文字列が情報の中に含まれています。 +テキスト内部には空白文字が入っていても良いです。 +円弧、曲線、およびベクトルについては、この要素の行には +文字列 ``0'' が入っています。 +.SH 座標についての注意 +.I gremlin +は +.IR AED +用に設計され、その座標系は +.I AED +の座標空間を反映したものになっています。 +ベクトル図に対しては、x 値は 116 から 511 までをとり、 +y 値は 0 から 483 までをとります。 +水平方向の図に対しては、 x 値は 0 から 511 までをとり、 +y 値は 0 から 367 までをとります。 +この範囲に必ずこだわることはありませんが、 +少なくともこの近傍にとどめておけば最良の結果が +得られるでしょう。 +さらに、点のリストは (-1, -1) で終わりますので、 +負の座標を使うことはできません。 +.I gremlin +図は、``%f1.2'' という形式を使って座標を出力します。 +ですので、 +.I grn +コードを変更したい場合には同じ形式を用いるのが +おそらくは良い考えでしょう。 +.SH SUN/X11 バージョンの座標についての注意 +.IR SUN / X11 +バージョンの +.IR gremlin +図では、オブジェクト生成に用いられる座標の範囲に +制限はもうありません。 +しかし、負の座標を持ったファイルでは、 +.IR AED +上で表示させようとすると問題が +.B 発生するでしょう +。 +.SH 関連ファイル +.Tp \w'/usr/share/groff_font/devname/DESC'u+3n +.BI /usr/share/groff_font/dev name /DESC +デバイス +.IR name +用のデバイス定義ファイル +.SH 関連項目 +.BR gremlin (1), +.BR groff (1), +.BR pic (1), +.BR ideal (1) +.SH 歴史 +.PP +David Slattengren と Barry Roitblat がオリジナルの Berkeley 版 +.IR grn +を書きました。 +.PP +Daniel Senderowicz と Werner Lemberg が +.IR groff +用に書き直しました。 diff --git a/ja_JP.eucJP/man/man1/grolbp.1 b/ja_JP.eucJP/man/man1/grolbp.1 new file mode 100644 index 0000000000..ed0c9141d6 --- /dev/null +++ b/ja_JP.eucJP/man/man1/grolbp.1 @@ -0,0 +1,356 @@ +'\" t +.\" The above line should force the use of tbl as a preprocessor +.\" vim: set syntax=nroff : +.\" The above line should set vim into nroff mode +.ig +.\" jpman %Id: grolbp.1,v 1.2 2001/03/08 00:56:42 mistral Stab % +Copyright (C) 1994-2000 Free Software Foundation, Inc. + +Permission is granted to make and distribute verbatim copies of +this manual provided the copyright notice and this permission notice +are preserved on all copies. + +Permission is granted to copy and distribute modified versions of this +manual under the conditions for verbatim copying, provided that the +entire resulting derived work is distributed under the terms of a +permission notice identical to this one. + +Permission is granted to copy and distribute translations of this +manual into another language, under the above conditions for modified +versions, except that this permission notice may be included in +translations approved by the Free Software Foundation instead of in +the original English. + +Modified by Francisco Andres Verdu for the grolbp +program. +.. +.de TQ +.br +.ns +.TP \\$1 +.. +.\" Like TP, but if specified indent is more than half +.\" the current line-length - indent, use the default indent. +.de Tp +.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP +.el .TP "\\$1" +.. +.TH GROLBP 1 "7 December 2000" "Groff Version 1.16.1" +.SH 名称 +grolbp \- Canon CAPSL プリンタ (LBP-4 と LBP-8 シリーズレーザプリンタ) +用 groff ドライバ +.SH 書式 +.nr a \n(.j +.ad l +.nr i \n(.i +.in +\w'\fBgrolbp 'u +.ti \niu +.B grolpb +.de OP +.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]" +.el .RB "[\ " "\\$1" "\ ]" +.. +.OP \-l +.OP \-\-landscape +.OP \-v +.OP \-\-version +.OP \-c n +.OP \-\-copies= numcopies +.OP \-p paper_size +.OP \-\-papersize= paper_size +.OP \-o orientation +.OP \-\-orientation= orientation +.OP \-F dir +.OP \-\-fontdir= dir +.OP \-h +.OP \-\-help +.RI "[\ " files\|.\|.\|. "\ ]" +.br +.ad \na +.SH 解説 +.B grolbp +は +.B groff +のドライバであり、Canon LBP\-4 と LBP\-8 プリンタに適した +CPSL と VDM 形式の出力を生成します。 +.LP +grolj4 との互換性のために +troff のものに加え、描画コマンドとして次のものが利用可能です: +.TP +.BI \eD'R\ dh\ dv ' +現在の位置と、現在の位置 +.RI +( dh , dv ) +とを対角とする罫線 (つまり黒く塗りつぶした矩形) を描きます。 +.SH オプション +1 文字オプションとその引数との間には空白があってもなくても構いませんが、 +長いオプションとその引数との間には空白と、または等号記号 (`=') が +必要なことに注意してください。 +.TP +.BI \-c numcopies +.TQ +.BI \-\-copies= numcopies +各ページを +.I numcopies +回印刷します。 +.TP +.B \-l +.TQ +.B \-\-landscape +landscape にて文書を印刷します。 +.TP +.BI \-p paper_size +.TQ +.BI \-\-papersize= paper_size +用紙サイズを +.IR paper_size +にします。 +.IR paper_size +は +.BR "用紙サイズ" +節で示された有効なサイズ種別である必要があります。 +.TP +.BI \-o orientation +.TQ +.BI \-\-orientation= orientation +文書を +.I orientation +方向に印刷します。 +.I orientation +は `portrait' または `landscape' である必要があります。 +.TP +.B \-v +.TQ +.B \-\-version +バージョン番号を表示します。 +.TP +.BI \-F dir +.TQ +.BI \-\-fontdir= dir +フォントやデバイス記述ファイルを +.IB dir /devlbp +というディレクトリから探すようにします。 +.TP +.B \-h +.TQ +.B \-\-help +簡単なへルプを表示します。 +.SH 書体 +.\" XXX いまいちしっくりこない +ドライバは Dutch, Swiss, Swiss-Narrow スケーラブル書体それぞれに対して、 +Regular, Bold, Italic, Bold-Italic スタイルをサポートしています。 +さらに Courier と 等幅 Elite 書体の +それぞれ 8 と 12 ポイント (Courier 用)、8 と 10 ポイント (Elite 用) +に対して Regular, Bold, Italic スタイルがサポートされています。 +.PP +これらのフォントを使用するためのフォント名を以下の表にまとめます: +.PP +.TS +tab(|) allbox center; +c c c c c +ab c c c c +. +書体 | Regular | Bold | Italic | Bold-Italic +Dutch | TR | TB | TI | TBI +Swiss | HR | HB | HI | HBI +Swiss Narrow | HNR | HNB | HNI | HNBI +Courier | CR | CB | CI | +Elite | ER | EB | EI | +.TE +.PP +.SH 用紙サイズ +用紙サイズは +.B DESC +ファイルまたは +.BR grolbp +に対するコマンド行オプションで指定できます。 +用紙サイズが両方で指定された場合は、コマンド行オプションが +.B DESC +ファイルの内容よりも優先されます (この原則はページの向きにも適用されます)。 +.PP +.B DESC +ファイルで用紙サイズを設定するには、 +.B papersize +.IR desired_papersize , +を含んだ行をそのファイルに記入します。 +.I desired_papersize +は次のうちのいづれかです: +.IP \(bu 4 +認識される用紙サイズのうち 1 つ: `a4', `letter', `legal', `executive' +.IP \(bu 4 +.B カスタム用紙サイズ +.\" XXX subsection +小節で説明するカスタム定義された用紙サイズ +.IP \(bu 4 +上記形式のどれか希望の用紙サイズが 1 行目に書かれているファイルの名前 (例えば +.IR /etc/papersize ) +.PP +複数の有効な papersize 行が +.B DESC +ファイルに書かれて場合には、最初の有効なもののみが使用されます。 +.PP +コマンド行で用紙サイズを設定するには、 +.sp 1 +.in +2m +.BI \-p \ desired_papersize +.in -2m +.sp 1 +または +.sp 1 +.in +2m +.BI \-\-papersize= desired_papersize +.in -2m +.sp 1 +を他の +.B grolbp +オプションに加えます。 +.B desired_papersize +は +.B DESC +ファイルと同じ形式です。 +.PP +用紙サイズには大文字小文字の区別はありません +(すなわち `A4' は `a4' と同じです)。 +.PP +.B DESC +ファイルやコマンド行で用紙サイズが指定されなかった場合には、 +デフォルトサイズの A4 が使用されます。 +.TP +.SH カスタム用紙サイズ +カスタム定義された用紙サイズは +.BI cust length x width +形式で指定します。ここで +.I length +と +.I width +には使用したい用紙寸法のプリンタ単位 (1/300 インチ) が入ります。 +例えば、2 インチ× 4 インチの葉書サイズ用紙に印刷するには、 +.B DESC +ファイルの先頭に +.sp 1 +.in +2m +.B papersize cust600x1200 +.in -2m +.sp 1 +という行を書きます。 +.SH ページ向き +ページサイズと同様、印刷ページの向き +.RB ( portrait +または +.BR landscape ) +は +.B DESC +ファイルまたはコマンド行オプションで指定できます。 +ここでも大文字小文字の区別はありません。 +.PP +.B DESC +ファイルで向きを設定するには、以下の行を書きます: +.sp 1 +.in +2m +.B orientation +.RB [ portrait | landscape ] +.in -2m +.sp 1 +用紙サイズと同じように、 +.B DESC +ファイル中の最初の有効な orientation コマンドのみが使用されます。 +.PP +コマンド行オプションでページ向きを設定するには +.B DESC +ファイルと同じパラメータ +.RB ( portrait +または +.BR landscape ) +を +.B \-o +または +.B \-\-orientation +オプションで指定します。 +また +.B \-l +オプションによる強制的な landscape でのページ印刷も可能です。 +.SH フォントファイル形式 +.BR groff_font (5) +に記述されている通常コマンドに加えて、 +.B grolbp +はプリンタに送るフォント名を指定するコマンド +.I lbpname +を用意しています。 +このコマンドの文法は次のとおりです: +.sp 1 +.in +2m +.B lbpname +.I printer_font_name +.in -2m +.IP \(bu +ビットマップフォントでは +.I printer_font_name +は次の形式です +.sp 1 +.in +2m +.RI N\(la base_fontname \(ra\(la font_style \(ra +.in -2m +.sp 1 +.\" XXX なんかしっくりこない +.I base_fontname +はプリンタのフォントリストに現れる名前から最初の 1 文字を除いた +フォントサイズまで (フォントサイズは含まない) のフォント名です。 +.I font_style +は +.BR R , +.BR I , +.BR B +のうちの 1 文字で、それぞれ Roman, Italic, Bold のフォントスタイルを +示しています。 +.IP +例えば、プリンタの +.I font listing A +がフォント `Nelite12I.ISO_USA' を表示した場合、フォント設定ファイルの +対応する項目は次のものになります +.sp 1 +.in +2m +.B lbpname NeliteI +.in -2m +.IP +ただし (上述した) 利用可能なビットマップフォントのフォント名と +フォントサイズはプログラム中にハードコードされているため、 +新しいビットマップフォントを追加でサポートするには +.B grolbp +を書き換える必要があることに注意してください。 +.IP \(bu +スケーラブルフォントでは、 +.I printer_font_name +はプリンタの +.IR "font listing A" +に表示されるフォント名と同じです。 +.IP +例えば、プリンタの +.I font listing A +に `Swiss-Bold' と表示される、bold スタイルな `Swiss' を選択するのに必要な +.B lbpname +コマンド行は次のようになります +.sp 1 +.in +2m +.B lbpname Swiss-Bold +.in -2m +.sp 1 +.PP +.B lbpname +の引数は大文字小文字が区別されます。 +.SH 関連ファイル +.TP +.B /usr/share/groff_font/devlbp/DESC +デバイス記述ファイルです。 +.TP +.BI /usr/share/groff_font/devlbp/ F +.IR F . +というフォントに対する記述ファイルです。 +.SH 関連項目 +.BR groff (1), +.BR troff (1), +.BR groff_out (5), +.BR groff_font (5), +.BR groff_char (7) +.\" +.\" Local Variables: +.\" mode: nroff +.\" End: diff --git a/ja_JP.eucJP/man/man1/pkg_sign.1 b/ja_JP.eucJP/man/man1/pkg_sign.1 new file mode 100644 index 0000000000..d4eb596006 --- /dev/null +++ b/ja_JP.eucJP/man/man1/pkg_sign.1 @@ -0,0 +1,224 @@ +.\" %FreeBSD: src/usr.sbin/pkg_install/sign/pkg_sign.1,v 1.1.2.3 2001/03/08 02:27:42 jkh Exp % +.\" $OpenBSD: pkg_sign.1,v 1.6 2000/04/15 02:15:20 aaron Exp $ +.\" +.\" Copyright (c) 1999 Marc Espie. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Marc Espie for the OpenBSD +.\" Project. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE OPENBSD PROJECT AND CONTRIBUTORS +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +.\" A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OPENBSD +.\" PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +.\" OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" jpman %Id: pkg_sign.1,v 1.2 2001/03/12 16:40:49 nakano Stab % +.\" +.\"WORD: certificate 証明書 +.\"WORD: verification 検証 +.\" +.Dd September 24, 1999 +.Dt PKG_SIGN 1 +.Os +.Sh 名称 +.Nm pkg_sign , +.Nm pkg_check +.Nd package の署名を扱う +.Sh 書式 +.Nm +.Op Fl sc +.Op Fl t Ar type +.Op Fl u Ar id +.Op Fl k Ar key +.Op Ar +.Nm pkg_check +.Op Fl sc +.Op Fl u Ar id +.Op Fl k Ar cert +.Op Ar +.Sh 解説 +.Nm +は暗号化された署名を gzip ファイル +.Ar file +に埋めこみます。 +.Ar type +には +.Cm pgp +(デフォルト), +.Cm sha1 , +.Cm x509 +が指定できます。 +.Ar type +を +.Cm pgp +にすると、 +pgp 秘密鍵の利用を可能にするための +パスフレーズ入力を促すプロンプトが表示されます。 +パスフレーズを設定していなくても表示されます +(これはいずれにせよ良くない状況ですが)。 +.Ar type +が +.Cm sha1 +の場合は、 +.Ar id +を指定する必要があります。これは package +(訳注: FreeBSD の package system におけるパッケージを指す場合にこう表記します) +の名前として記録され、SHA1 チェックサムとして表示されます。 +.Pp +.Nm pkg_check +は暗号化された署名をチェックします。 +現在は +.Ar type +を無視し、一番上 (topmost) の署名だけをチェックします。 +.\"translator: topmost の意味/訳語は? +.Cm sha1 +に対しては、 +.Nm pkg_check +はファイルのチェックサムを取り、 +結果が +.Pa /var/db/pkg/SHA1 +に記録されているチェックサムのリストにマッチするかどうか確認します。 +.Pp +オプション +.Fl s +および +.Fl c +は「package への署名」モードおよび「署名チェック」モードを強制します。 +.\"nakano: pkg_sign -c = pkg_check, pkg_check -s = pkg_sign, ということ? +.Pp +.Cm pgp +では、 +package への署名や署名チェックに用いる +.Ar id +を +.Fl u +で指定できます。 +.Pp +.Cm x509 +では、 +署名キーまたは検証する証明書 (certificate) を +.Fl k +オプションで指定できます。 +指定しないと、package は以下で記述している +デフォルトのキーで署名 (デフォルトの証明書で検証) されます。 +.Pp +.Ar file +がダッシュひとつ +.Pq Sq Fl +だったり指定されなかった場合は、 +.Nm +は標準入力から読み込みます。 +.Pp +package への署名では gzip 形式の特徴を利用しています。 +これは、 gzip のヘッダには +.Dv EXTRA_FIELD +というフラグを設定でき、余分のデータを +gzip ヘッダと圧縮ファイルの間に保存できる、というものです。 +.Ox +の署名機構では、 +.Sq Li SIGPGP ++ length +や +.Sq CKSHA1 ++ length +のような 8 バイトのマーカーを署名に用いています +(これらのマーカーは伝統的に 8 バイト長となっています)。 +.Sh 診断 +.Nm +および +.Nm pkg_check +は、 +.Ar file +のいずれかになにか問題があると、 0 より大きい終了コードを返します。 +.Nm pkg_check +の場合、これは通常 package が署名されていない、 +あるいは署名が捏造されていることを意味します。 +.Bl -diag +.It "File %s is already signed" +その gzip ファイルには、既に署名が埋めこまれています。 +.Nm +は今のところ複数の署名を扱いません。 +.It "File %s is not a signed gzip file" +この package には署名がありません。 +.It "File %s is not a gzip file" +gzip ヘッダが見つかりませんでした。 +.It "File %s contains an unknown extension" +gzip ファイルの拡張領域が、別の何らかの用途に既に使われていました。 +.It "File %s uses old signatures, no longer supported" +この gzip ファイルは、非常に古い版の +(かなり遅くなる) package 署名を用いています。 +.El +.Sh バグ +.Xr pgp 1 +はあまり設計の良くないプログラムで、 +インターフェースを取るのが難しいです。 +例えば pgp が提供しているといっている +「分離署名機能 (separate signing scheme)」 +は不便極まりないもので、パイプを通しての利用ができません。 +したがって +.Nm pgp_sign +ではこれをなんとかするために、 +pgp 署名の長さを知っていることにして、 +pgp を「シームレス」署名モードで起動し、 +ファイル本体は圧縮しないで署名のみを取出しています。 +.\"translator: kludge it の適切な訳がちょっとわかりませんでした。 +.Pp +チェック動作ではあまり複雑なことはしていません。 +pgp に入力するファイルをその場で再ビルドしています。 +.\"translator: 逆か? -> little less convoluted +.Pp +.Nm pgp +およびチェックサムファイルへのパスは不正利用を妨げるために +ハードコードされています。そのため柔軟性は損なわれています。 +.Sh ファイル +.Bl -tag -width "/usr/local/bin/pgp" -compact +.It Pa file.sign +.Nm +が +.Ar file +からビルドする一時ファイル +.It Pa /usr/local/bin/pgp +.Xr pgp 1 +のデフォルトのパス +.It Pa /var/db/pkgs/SHA1 +記録済みのチェックサム +.It Pa /etc/ssl/pkg.key +デフォルトの package への署名キー +.It Pa /etc/ssl/pkg.crt +デフォルトの package 検証用証明書 +.El +.Sh 関連項目 +.Xr gzip 1 , +.Xr pgp 1 , +.Xr pkg_add 1 , +.Xr sha1 1 +.Sh 作者 +.An -nosplit +.Nm +は +.An Marc Espie +が +.Ox +プロジェクトのために作成しました。 +X.509 署名と +.Fx +サポートは +.An Wes Peters Aq wes@softweyr.com +が追加しました。 + diff --git a/ja_JP.eucJP/man/man1/pkg_update.1 b/ja_JP.eucJP/man/man1/pkg_update.1 new file mode 100644 index 0000000000..dd9518032a --- /dev/null +++ b/ja_JP.eucJP/man/man1/pkg_update.1 @@ -0,0 +1,85 @@ +.\" +.\" Copyright 2000 Paul Richards +.\" +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" %FreeBSD: src/usr.sbin/pkg_install/update/pkg_update.1,v 1.3 2000/12/29 09:03:38 ru Exp % +.\" +.\" jpman %Id: pkg_update.1,v 1.3 2001/03/05 22:01:33 horikawa Stab % +.\" +.Dd December 27, 2000 +.Dt PKG_UPDATE 1 +.Os FreeBSD +.Sh 名称 +.Nm pkg_update +.Nd インストールされている package を更新する +.Sh 書式 +.Nm +.Op Fl nv +.Op Fl r Ar oldpkg +.Ar newpkg.tgz +.Sh 解説 +.Nm +コマンドは既にインストールされている package +(訳注: FreeBSD の package system におけるパッケージを指す場合にこう表記します) +を更新するために用います。 +.Nm +は、置きかえ前のバージョンが持っていた依存関係を、 +新しくインストールされるバージョンに渡す処理も行います。 +通常 +.Nm +は、現在インストールされているすべての package のバージョンを、 +より新しいバージョンで置き換えるために用います。 +あるいは +.Fl r +オプションでバージョンを指定すれば、 +特定の package を古いバージョンに戻すこともできます。 +.Pp +以下のオプションが利用できます: +.Bl -tag -width indent +.It Fl n +動作を表示しますが、実際には実行しません。 +.It Fl r Ar oldpkg +package を指定したバージョンのものに置き換えます。 +通常 +.Nm +はインストールされている package をすべて新しいバージョンに +置き換えようとします。これは常に望ましい動作であるとは限りません。 +なぜなら package によっては、 +複数のバージョンが同時にインストールされていることもありうるからです。 +このオプションを指定すると、 +特定のバージョンに置き換えることができるようになります。 +.It Fl v +詳細な出力を行います。 +.El +.Sh 関連項目 +.Xr pkg_add 1 , +.Xr pkg_create 1 , +.Xr pkg_delete 1 , +.Xr pkg_info 1 , +.Xr pkg_version 1 +.Sh 作者 +.An Paul Richards Aq paul@FreeBSD.org +.Sh バグ +今のところ既知のものはありません。 + diff --git a/ja_JP.eucJP/man/man1/realpath.1 b/ja_JP.eucJP/man/man1/realpath.1 new file mode 100644 index 0000000000..9ec6b676a9 --- /dev/null +++ b/ja_JP.eucJP/man/man1/realpath.1 @@ -0,0 +1,71 @@ +.\" Copyright (c) 1990, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" the Institute of Electrical and Electronics Engineers, Inc. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)pwd.1 8.2 (Berkeley) 4/28/95 +.\" From: src/bin/pwd/pwd.1,v 1.11 2000/11/20 11:39:39 ru Exp +.\" %FreeBSD: src/bin/pwd/realpath.1,v 1.2.2.2 2001/02/22 07:31:17 ru Exp % +.\" jpman %Id: realpath.1,v 1.2 2001/03/08 00:56:57 mistral Stab % +.\" +.Dd November 24, 2000 +.Dt REALPATH 1 +.Os FreeBSD +.Sh 名称 +.Nm realpath +.Nd 物理的なパスを分析して返す +.Sh 書式 +.Nm +.Ar path +.Sh 解説 +.Nm +は +.Ar path +中のすべてのシンボリックリンク、余分な +.Ql / +キャラクタ、 +.Pa /./ +と +.Pa /../ +のリファレンスを +.Xr realpath 3 +関数を用いて分析します。 +.Sh 診断 +.Nm +は成功時には 0 を、エラー発生時には 0 より大きい値を返します。 +.Sh 関連項目 +.Xr realpath 3 +.Sh 歴史 +.Nm +ユーティリティは +.Fx 4.3 +から登場しました。 diff --git a/ja_JP.eucJP/man/man5/Makefile b/ja_JP.eucJP/man/man5/Makefile index 36c06137b2..640b3d800c 100644 --- a/ja_JP.eucJP/man/man5/Makefile +++ b/ja_JP.eucJP/man/man5/Makefile @@ -1,115 +1,118 @@ MAN5 = a.out.5\ acct.5\ aliases.5\ amd.conf.5\ ar.5\ auth.conf.5\ bootparams.5\ bootptab.5\ core.5\ crontab.5\ ctm.5\ cvs.5\ devfs.5\ dhclient.conf.5\ dhclient.leases.5\ dhcp-options.5\ dir.5\ disklabel.5\ disktab.5\ dm.conf.5\ editrc.5\ elf.5\ ethers.5\ exports.5\ fbtab.5\ fdesc.5\ finger.conf.5\ forward.5\ fs.5\ fstab.5\ gettytab.5\ groff_font.5\ groff_out.5\ + groff_tmac.5\ group.5\ hosts.5\ hosts.equiv.5\ hosts.lpd.5\ hosts_access.5\ hosts_options.5\ info.5\ intro.5\ ipf.5\ ipnat.5\ ipsend.5\ isdnd.acct.5\ isdnd.rates.5\ isdnd.rc.5\ kbdmap.5\ kernfs.5\ keycap.5\ link.5\ linprocfs.5\ loader.conf.5\ login.access.5\ login.conf.5\ magic.5\ mailer.conf.5\ + make.conf.5\ modems.5\ motd.5\ named.conf.5\ netgroup.5\ networks.5\ nologin.5\ ntp.conf.5\ ntp.keys.5\ opieaccess.5\ opiekeys.5\ passwd.5\ pbm.5\ pccard.conf.5\ phones.5\ pim6dd.conf.5\ pim6sd.conf.5\ printcap.5\ procfs.5\ protocols.5\ publickey.5\ pw.conf.5\ radius.conf.5\ ranlib.5\ rc.conf.5\ rcsfile.5\ remote.5\ resolver.5\ rpc.5\ rrenumd.conf.5\ rtadvd.conf.5\ services.5\ shells.5\ skey.access.5\ stab.5\ sysctl.conf.5\ syslog.conf.5\ tacplus.conf.5\ term.5\ termcap.5\ terminfo.5\ texinfo.5\ ttys.5\ types.5\ tzfile.5\ usbd.conf.5\ utmp.5\ uuencode.format.5\ vgrindefs.5 MLINKS+=kbdmap.5 keymap.5 MLINKS+=utmp.5 lastlog.5 utmp.5 wtmp.5 MLINKS+=hosts.equiv.5 rhosts.5 MLINKS+=uuencode.format.5 uuencode.5 MLINKS+=resolver.5 resolv.conf.5 MLINKS+=fs.5 inode.5 MLINKS+=dir.5 dirent.5 +MLINKS+=groff_tmac.5 tmac.5 .include "bsd.prog.mk" diff --git a/ja_JP.eucJP/man/man5/groff_tmac.5 b/ja_JP.eucJP/man/man5/groff_tmac.5 new file mode 100644 index 0000000000..2cb35ab7ce --- /dev/null +++ b/ja_JP.eucJP/man/man5/groff_tmac.5 @@ -0,0 +1,458 @@ +.\" -*- nroff -*- +.ig / +.\" jpman %Id: groff_tmac.5,v 1.3 2001/02/21 02:19:35 horikawa Stab % +groff_tmac.5 + +This file is part of groff, the GNU roff type-setting system. + +Copyright (C) 2000 Free Software Foundation, Inc. +written by Bernd Warken + +Last update: 17 May 2000 + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.1 or +any later version published by the Free Software Foundation; with the +Invariant Sections being this .ig-section and AUTHOR, with no +Front-Cover Texts, and with no Back-Cover Texts. + +A copy of the Free Documentation License is included as a file called +FDL in the main directory of the groff source package. +./ +. +.\" -------------------------------------------------------------------- +.\" Setup +.\" -------------------------------------------------------------------- +. +.if n \{\ +. mso tmac.tty-char +. ftr CR R +. ftr CI I +. ftr CB B +.\} +. +.\" text lines in macro definitions or bracketed sections \{...\} +.de text +. if 1 \&\\$*\& +.. +. +.de BIR +. ie (\\n[.$] < 3) \ +. BI \\$@ +. el \{\ +. ds @tmp@ \fB\\$1\fP\fI\\$2\fP +. shift 2 +. text \\*[@tmp@]\fR\\$*\fP +. rm @tmp@ +. \} +.. +. +.de 'char +. ds @tmp@ `\f(CB\\$1\fP' +. shift +. text \\*[@tmp@]\\$* +. rm @tmp@ +.. +. +.de option +. ds @tmp@ \f(CB\\$1\fP +. shift 1 +. text \\*[@tmp@]\\$* +. rm @tmp@ +.. +. +.als shellcommand option +. +.de argument +. ds @tmp@ \f(CI\\$1\fP +. shift 1 +. text \\*[@tmp@]\\$* +. rm @tmp@ +.. +. +.de request +. ds @tmp@ \f(CB\\$1\fP +. shift 1 +. text \\*[@tmp@]\\$* +. rm @tmp@ +.. +.\" WORD: typesetting system 清書システム +.\" WORD: naming 名称付け +.\" WORD: inclusion 取り込み +.\" WORD: convention 約束事 +.\" WORD: delayed command 遅延コマンド +.\" WORD: Filesystem Hierarchy Standard ファイルシステム階層標準 +.\" -------------------------------------------------------------------- +.\" Title +.\"-------------------------------------------------------------------- +.TH GROFF_TMAC 5 "7 December 2000" "Groff Version 1.16.1" +.SH 名称 +groff_tmac \- roff 清書システム内にあるマクロファイル +.\" -------------------------------------------------------------------- +.SH 解説 +.\" -------------------------------------------------------------------- +.BR roff (7) +清書システムは、特殊な用途のドキュメントに適した +マクロパッケージを提供しています。それぞれのマクロパッケージは、 +そのパッケージの +.BR "tmac ファイル" +と呼ばれるファイル中にマクロおよび定義を格納しています。 +tmac という名前は、 +.RB ` T roff +.BR MAC ros' +を縮めたものです。 +.LP +tmac ファイルは、普通の roff ソースドキュメントです。ただし、 +通常このファイルには定義および設定コマンドしか含まれておらず、 +テキストは入っていません。tmac ファイルはすべて +.B tmac +ディレクトリという 1 つあるいは少数のディレクトリ内に +保管されています。 +.\" -------------------------------------------------------------------- +.SH 名称付け +.\"-------------------------------------------------------------------- +古くからある roff システムには、奇妙な名称付けの体系が +ありました。 +マクロパッケージの名称が +.'char m +で始まっている場合には、この文字は省略されました。例えば、 +マニュアルページ用のマクロパッケージ +.I man +は +.I an +と呼ばれ、そのパッケージのマクロファイルは +.IR tmac.an +と呼ばれました。 +.LP +似たような理由で、名称が +.'char m +で始まらないマクロパッケージは、 +.'char m +をつけて表されることがよくありました。例えば、 +.I tmac.doc +に対応するパッケージは、 +.I mdoc +と呼ばれました。なぜなら、このパッケージをアクティブに +するためのコマンドラインは、次のように表されるからです。 +.RS +.LP +.BIR "troff\ \-m" doc +.RE +.LP +現在の +.BR groff(1) +のバージョンでは、パッケージ名に +.'char m +が付こうが付くまいが、この悩ましいマクロパッケージの名称付け体系を +どちらも提供しています。ですので、 +.IR groff +では、 +.I man +マクロパッケージは、次のいずれでも指定可能です。 +.RS +.LP +.BIR "groff\ \-m\ " man +.br +.BIR "groff\ \-m" an +.br +.BIR "groff\ \-m" man +.br +.BIR "groff\ \-m " an +.RE +.LP +システムでどのマクロパッケージが利用可能であるかを判別するのに +最も簡単な方法は、 +.I tmac +ディレクトリ群の中身を調べることです。 +例えば、 +.BI tmac. anything +と呼ばれるファイルは、 +.IR anything +という名前のマクロパッケージを決定しています。 +.LP +.IR groff +では、マクロパッケージの大部分は、 +古くからあるパッケージに対して +.'char m +を先頭に付けた +.BR groff_ (7) +という名前のマニュアルページで説明がされています。 +.\" -------------------------------------------------------------------- +.SH 取り込み +.\"-------------------------------------------------------------------- +ドキュメント中でマクロパッケージを使うための方法はいくつかあります。 +実行時に、groff のオプション +.option \-m \ \c +.argument name +を用いてマクロファイル +.BI tmac. name +内の定義を +.BR 名称付け +のセクションで述べたように利用可能にします。 +.LP +groff リクエスト +.request .so +あるいは +.request .mso +を用いてマクロファイルをドキュメントに取り込むことも可能です。 +.request .so +については、マクロファイルのフルパスでのファイル名を指定しなくては +いけません \(em そのマクロファイルが保存されているディレクトリを +含む必要があります。 +マクロファイルが tmac ディレクトリ群のどれか 1 つに格納されている場合、 +代わりに +.request .mso +を使用するほうが便利です。なぜなら、このリクエストは tmac パスを +探索してファイル名を見つけることまでもしてくれるからです。 +.LP +.request .so +および +.request .mso +リクエストを解決するために、roff プリプロセッサ +.shellcommand soelim +が呼ばれなくてはならないことに注意してください。 +これは、コマンドライン上でパイプラインから直接呼ぶか、または +.shellcommand groff +の +.option \-s +オプションを使うかすればできます。 +.LP +.BR 約束事 +のセクションで述べているように、 +プリプロセッサワード中に文字 +.'char s +を入れても良いです。 +.LP +例えば、マクロファイルが +.I /usr/share/groff/tmac/tmac.macros +に保存されており、 +.IR docu.roff +という名前のドキュメントで使用されているとします。 +.LP +実行時において、このドキュメントに対するフォーマッタ呼び出しは +次のように行います。 +.RS +.LP +.ft CR +.shellcommand "groff\ \-m" +.argument macros +.argument docu.roff +.ft P +.RE +.LP +ドキュメント内に直接マクロファイルを取り込むには、 +.RS +.ft CR +\&\.mso tmac.macros +.ft P +.RE +あるいは +.RS +.ft CR +\&\.so /usr/share/groff/tmac/tmac.macros +.ft P +.RE +を使用します。 +.LP +どちらの場合でも、フォーマッタは +.ft CR +.RS +groff\ \-s docu.roff +.RE +.ft P +を使用して呼び出されます。 +. +.\" -------------------------------------------------------------------- +.SH 約束事 +.\" -------------------------------------------------------------------- +.LP +最近の roff 清書システムの多くでサポートされている約束事があります。 +次に述べられているような +.B プリプロセッサワード +がそれです。 +.LP +ドキュメントの 1 行目がコメントである場合、 +最初の単語 (コメント文字および空白の後) は +.B プリプロセッサ +.BR ワード +で構成されます。 +これはつまり、このワードの文字が、ドキュメントを整形する際に +起動しなくてはならないプリプロセッサコマンドの省略形であると +解釈されるということです。 +ほとんどの場合、プリプロセッサのオプションに対応した文字だけが +認識されます。それは、 +.'char e , +.'char G , +.'char g , +.'char p , +.'char R , +.'char s , +.'char t +です +( +.BR roff (7) +を参照)。 +.LP +さらに、ユーザへの良き忘備録として書いておきますが、 +フォーマッタによっては ( +.BR man (1) +プログラムのように) プリプロセッサワードで指定されたプリプロセッサを +自動的に起動させることまでもできるものがあります。ただし、このことを +あてにしてはいけません。 +.\" -------------------------------------------------------------------- +.SH "マクロファイルを記述する" +.\"-------------------------------------------------------------------- +マクロファイルを記述するのは簡単です。マクロ、文字列、レジスタなどの +セットを設計してください。そしてそれを 1 つのファイルに +保存してください。 +記述したマクロを使用するドキュメントは、 +.B 取り込み +セクションで述べたように +.request .so +リクエストを使ってマクロを取り込みます。 +.LP +tmac の機能を使用するには、マクロファイル +.BI tmac. whatever +を呼び出し、tmac パスのどれかのディレクトリにファイルを置きます。 +.BR 関連ファイル +セクションを参照してください。 +そうすると、ドキュメントは +.B 取り込み +セクションで述べたように +.request .mso +リクエストあるいは +.shellcommand "groff\ \-m" +オプションを使ってマクロファイルを取り込むことができます。 +.LP +もしあなたが書いたマクロが一般用途に使えるかもしれないものなら、 +groff メンテナに連絡を取って、そのマクロが groff の +.I contrib +ソースディレクトリに含まれるようにしてください。 +.LP +マクロを書く際には、いくつか一般的なガイドラインがあれば役に立つ +でしょう。 +.IP \(bu 2m +機能のあるバックスラッシュはすべて 2 重にします。 +.'char \e +-> +.'char \e\e +.IP \(bu 2m +印字可能なバックスラッシュはすべて +.'char \ee +というように書かなくてはなりません。 +.IP \(bu 2m +ドットはすべてエスケープしてください。 +.'char . +-> +.'char \e. +.IP \(bu 2m +テキスト部分には、印字できない文字 +.'char \e& +を広く使用するようにしてください。特に、 +.'char \e +の前や行頭で使用してください。ただし、遅延コマンドの前では +使用しないでください。 +.IP \(bu 2m +文字 +.'char @ +を一時的な変数名に使用してください。 +.IP \(bu 2m +あなたが書いたマクロをテキストおよびグラフィックデバイスに対して +テストしてください。例えば、 +.I latin1 +と +.IR ps +がそうです。 +.\" -------------------------------------------------------------------- +.SH 関連ファイル +.\" -------------------------------------------------------------------- +tmac メカニズムを使用したいマクロ名はすべて +.BIR tmac. name +の書式に従って名付けられなければなりません。 +.LP +マクロファイルは、 +.B tmac +.BR ディレクトリ群 +に保存されています。このディレクトリ群すべてが +.B tmac +.BR パス +を構成しています。 +ファイルシステム階層標準 (FHS) に従い、groff 標準の tmac +ディレクトリは +.IR /usr/share/groff/tmac +です。ローカルにインストールすると、 +.IR /usr/local/share/groff/tmac +を使用します。 +古いシステムでは +.IR /usr/lib +のサブディレクトリを使用します。 +デフォルトの tmac パスとは別に、ドキュメントで使用される tmac パスは +いつでもシェルの環境変数で設定できます。 +.BR 環境変数 +セクションを参照してください。 +.\" -------------------------------------------------------------------- +.SH 環境変数 +.\" -------------------------------------------------------------------- +.TP +.B GROFF_TMAC_PATH +コロン区切りの tmac ディレクトリリストであり、 +このリストからマクロファイルを探します。つまり、 +.B tmac +パスです。 +設定されていない場合には、 +.B 関連ファイル +セクションで概要を書いたようにデフォルトパスが使用されます。 +.\" -------------------------------------------------------------------- +.SH バグ +.\" -------------------------------------------------------------------- +groff ドキュメントは、現在発展中です。一時的に他のドキュメントとの間で +小さな食い違いができてしまう可能性があります。 +.\" -------------------------------------------------------------------- +.SH 作者 +.\"-------------------------------------------------------------------- +このドキュメントは groff、すなわち GNU roff 配布物の一部です。 +このドキュメントは Bernd Warken が書きました。 +.LP +このドキュメントは FDL (GNU Free Documentation License) バージョン +1.1 以降の条項のもとで配布されています。お使いのシステムには +FDL のコピーがあるはずです。また、 +.RS +.LP +.IR +.RE +からオンラインでも入手可能です。 +.\" -------------------------------------------------------------------- +.SH "関連項目" +.\" -------------------------------------------------------------------- +groff システムの詳細すべてについて信頼できる情報源は、groff の +.BR info (1) +ファイルです。 +.LP +groff の概要については、 +.BR roff (7) +および groff ソースパッケージ中の +.I README +ファイルを参照してください。 +.LP +groff tmac マクロパッケージは、 +.BR groff_man (7), +.BR groff_markup (7), +.BR groff_mdoc (7), +.BR groff_mdoc.samples (7), +.BR groff_me (7), +.BR groff_mm (7), +.BR groff_mmroff (7), +.BR groff_ms (7), +.BR groff_msafer (7) +です。 +.LP +groff の言語については +.BR groff (7) +で、フォーマッタについては +.BR groff (1), +.BR troff (1) +で説明されています。 +.LP +ファイルシステム階層標準 (FHS) は +.BR http://www.pathname.com/fhs/ +で入手可能です。 diff --git a/ja_JP.eucJP/man/man5/make.conf.5 b/ja_JP.eucJP/man/man5/make.conf.5 new file mode 100644 index 0000000000..0d5d1b2315 --- /dev/null +++ b/ja_JP.eucJP/man/man5/make.conf.5 @@ -0,0 +1,761 @@ +.\" Copyright (c) 2000 +.\" Mike W. Meyer +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %FreeBSD: src/share/man/man5/make.conf.5,v 1.12.2.1 2001/03/08 05:44:45 obrien Exp % +.\" +.\" jpman %Id: make.conf.5,v 1.2 2001/03/12 16:40:09 nakano Stab % +.\" +.Dd November 3, 2000 +.Dt MAKE.CONF 5 +.Os +.Sh 名称 +.Nm make.conf +.Nd システムビルド情報 +.Sh 解説 +.Nm +ファイルには +.Fx +のソースや ports アプリケーションの制御に関する設定が含まれています。 +通常 +.Nm +ファイルは、システム管理者が、 +これらの値をデフォルトから変更したい場合に作成します。 +.Pp +.Nm +の用途は、コマンド実行やコンパイル動作を直接行うことではなく、 +.Pa /usr/src , +.Pa /usr/ports , +.Pa /usr/doc +となどにある様々な makefile にインクルードされることです。 +そのような makefile では、 +内部の動作が +.Nm +の与える条件によって変化するようになっているのです。 +.Pp +.Pa /etc/make.conf +ファイルはそれぞれ適切な +.Pa Makefile +からインクルードされます。 +各々の Makefile の中では、 +利用可能なすべてのオプションに対し、デフォルトの設定が与えられています。 +.Pa /etc/make.conf +で指定する必要があるオプションは、 +システム管理者がデフォルトから変更したいと思ったものだけです。 +.Pp +ビルドの手続きは、大きく 4 つの領域に分けられます。 +world、カーネル、ドキュメント、ports です。 +.Nm +で設定された変数はこれらの領域の 1 つ、2 つ、 +あるいは全てに適用されます。 +変数は、特定のビルドに対して +.Xr make 1 +の +.Fl D +オプションを用いて指定することもできます。 +.Pp +以下のリストでは、それぞれ指定したビルドの途中で用いることのできる +各変数の名前と簡単な説明を記述します。 +.Vt bool +と指定されている変数では、その値は意味を持ちません。 +変数が設定されていれば (たとえ値が +.Dq Li FALSE +や +.Dq Li NO +でも)、変数が設定されている状態での想定の通りに動作します。 +.Pp +次のリストは、すべてのビルド (あるいはビルド以外の目的で使われる +.Pa Makefile ) +で用いられる変数の名前と簡単な説明です。 +.Bl -tag -width Ar +.It Va CFLAGS +.Vt ( str ) +C のコードをコンパイルするときのコンパイラの設定を制御します。 +.Oo Fl O ( O2 , No ...\& ) Oc +以上の最適化レベルはサポートされていません。 +.Va BDECFLAGS +も +.Xr gcc 1 +の設定の一部として与えられます。これは +.An "Bruce Evans" Aq bde@FreeBSD.org +によって、開発や変更のテスト用に示唆されたものです。 +これは以下のように用います。 +.\"translator: BDECFLAGS 以下ちょっとあやしい。 +.Pp +.Bd -literal -offset indent +CXFLAGS+=${BDECFLAGS} +.Ed +.It Va CVS_UPDATE +.Vt ( bool ) +.Dq Li "make update" +で ports を更新するときに +.Xr cvs 1 +を用いる場合、設定します。 +.It Va CXXFLAGS +.Vt ( str ) +C++ のコードをコンパイルするときのコンパイラの設定を制御します。 +.Va CXXFLAGS +は最初は +.Va CFLAGS +の値に設定されます。この +.Va CXXFLAGS +の値に追加を行いたい場合は、 +.Dq Li = +ではなく +.Dq Li += +を用いてください。 +.It Va INSTALL +.Vt ( str ) +デフォルトのインストールコマンドです。 +インストールを行う前に比較を行いたい場合は、次の例を用いてください。 +.Bd -literal -offset indent +INSTALL="install -C" +.Ed +.It Va LOCAL_DIRS +.Vt ( str ) +この変数には +.Pa /usr/src +で make を行うときに入るべきディレクトリをすべてリストします。 +.It Va MTREE_FOLLOWS_SYMLINKS +.Vt ( str ) +.Xr mtree 8 +にシンボリックリンクを追跡させたい場合は +これを設定します。 +.\"translator: bool じゃなくて str? +.It Va NO_DOCUPDATE +.Vt ( bool ) +.Dq Li "make update" +で doc ツリーを更新させない場合これを設定します。 +.It Va NO_PORTSUPDATE +.Vt ( bool ) +.Dq Li "make update" +で ports ツリーを更新させない場合これを設定します。 +.It Va SUP_UPDATE +.Vt ( bool ) +.Dq Li "make update" +による ports の更新に +.Xr cvsup 1 +を使う場合これを設定します。 +.It Va SUP +.Vt ( str ) +.Dq Li "make update" +で用いられる +.Xr cvsup 1 +コマンドの置き場所です。 +.It Va SUPFLAGS +.Vt ( str ) +.Dq Li "make update" +を行うとき +.Xr sup 1 +に与えるフラグ。デフォルトは +.Op Fl g L Ar 2 +です。 +.It Va SUPHOST +.Vt ( str ) +.Dq Li "make update" +を行うときに用いる +sup サーバーのホスト名です。 +.It Va SUPFILE +.Vt ( str ) +.Dq Li "make update" +を行うとき、最初に用いる +.Ar supfile +です。デフォルトは +.Pa /usr/share/examples/cvsup/standard\-supfile +です。 +.It Va SUPFILE1 +.Vt ( str ) +.Dq Li "make update" +を行うとき、二番目に用いる +.Ar supfile +です。デフォルトは +.Pa /usr/share/examples/cvsup/secure\-supfile +です。 +.It Va SUPFILE2 +.Vt ( str ) +.Dq Li "make update" +を行うとき、三番目に用いる +.Ar supfile +です。デフォルトは +.Pa /usr/share/examples/cvsup/secure\-supfile +です。 +.It Va PORTSSUPFILE +.Vt ( str ) +.Dq Li "make update" +を行うときの ports 用の +.Ar supfile +です。デフォルトは +.Pa /usr/share/examples/cvsup/ports\-supfile +です。 +.It Va DOCSUPFILE +.Vt ( str ) +.Dq Li "make update" +を行うときのドキュメント用の +.Ar supfile +です。デフォルトは +.Pa /usr/share/examples/cvsup/doc\-supfile +です。 +.El +.Pp +次のリストは、カーネルのビルドで用いられる変数の名前と簡単な説明です。 +.Bl -tag -width Ar +.It Va BOOT_COMCONSOLE_PORT +.Vt ( str ) +ブートブロックが、 +キーボード/ビデオカードの代わりに +シリアルコンソールを用いるよう設定された場合に、 +コンソールとして用いるポートアドレスです。 +.It Va BOOT_COMCONSOLE_SPEED +.Vt ( int ) +ブートブロックが、 +キーボード/ビデオカードの代わりに +シリアルコンソールを用いるよう設定された場合に、 +コンソールで用いるボーレートです。 +.It Va BOOTWAIT +.Vt ( int ) +カーネルがデフォルトカーネルのブートを開始する前に、 +コンソールのキーが押されるのを待つ時間を制御します。 +値はだいたいミリ秒単位となります。 +ディスクからブートする前のキー入力の認識は BIOS が行うので、 +これが 0 に設定されていた場合でも、 +ユーザの選択したブートパラメータを与えることは可能です。 +.It Va COPTFLAGS +.Vt ( str ) +カーネルをコンパイルするときのコンパイラの設定を制御します。 +.Oo Fl O ( O2 , No ...\& ) Oc +以上の最適化レベルはサポートされていません。 +.It Va KERNEL +.Vt ( str ) +.Dq Li "${MAKE} buildkernel" +によるビルドと +.Dq Li "${MAKE} installkernel" . +によるインストールとで、 +どのカーネル設定を用いるかを制御します。例えば +.Bd -literal -offset indent +KERNEL=MINE DEBUG GENERIC OTHERMACHINE +.Ed +.Pp +とすると、 +.Pa MINE , DEBUG , GENERIC , OTHERMACHINE +といった各設定ファイルに対応するカーネルをビルドし、 +.Pa MIME +に対応するカーネルをインストールします。 +デフォルトは +.Pa GENERIC +です。 +.It Va NO_KERNELCONFIG +.Vt ( bool ) +.Dq Li "${MAKE} buildkernel" +の際に +.Xr config 8 +を実行しない場合には、これを設定します。 +.It Va NO_KERNELDEPEND +.Vt ( bool ) +.Dq Li "${MAKE} buildkernel" +の際に +.Dq Li "${MAKE} depend" +を実行しない場合には、これを設定します。 +.It Va NO_MODULES +.Vt ( bool ) +カーネルといっしょにモジュールをビルドしない場合に設定します。 +.El +.Pp +次のリストは、 world のビルドで用いられる変数の名前と簡単な説明です。 +.Bl -tag -width Ar +.It Va COMPAT1X +.Vt ( bool ) +.Fx +1 互換ライブラリをインストールする場合に設定します。 +.It Va COMPAT20 +.Vt ( bool ) +.Fx 2.0 +互換ライブラリをインストールする場合に設定します。 +.It Va COMPAT21 +.Vt ( bool ) +.Fx 2.1 +互換ライブラリをインストールする場合に設定します。 +.It Va COMPAT22 +.Vt ( bool ) +.Fx 2.2 +互換ライブラリをインストールする場合に設定します。 +.It Va COMPAT3X +.Vt ( bool ) +.Fx +3 互換ライブラリをインストールする場合に設定します。 +.It Va ENABLE_SUIDPERL +.Vt ( bool ) +suid +.Xr perl 1 +バイナリのインストールを行う場合に設定します。 +.It Va FETCH_CMD +.Vt ( str ) +ファイルの取得に用いるコマンドです。 +通常は +.Xr fetch 1 +です。 +.It Va MAKE_IDEA +.Vt ( bool ) +IDEA 暗号化コードをビルドする場合に設定します。 +このコードは米国やヨーロッパの多くの国々で特許が取得されています。 +合法的に IDEA を使えるかどうか決めるのは +.Em あなたの責任 +です。 +.It Va MAKE_KERBEROS4 +.Vt ( bool ) +KerverosIV (KTH eBones) をビルドする場合に設定します。 +.It Va MAKE_KERBEROS5 +.Vt ( bool ) +Kerveros5 (KTH Heimdal) をビルドする場合に設定します。 +.Em 注意! +これはまだ実験的なコードです。 +安定している Kerberos5 が必要ならば、 +ports を用いてください。 +.It Va MODULES_WITH_WORLD +.Vt ( bool ) +カーネルと同時にではなく、 +システムと同時にモジュールをビルドする場合に設定します。 +.It Va NO_CVS +.Vt ( bool ) +CVS をビルドしない場合に設定します。 +.It Va NO_BIND +.Vt ( bool ) +BIND をビルドしない場合に設定します。 +.It Va NO_FORTRAN +.Vt ( bool ) +.Xr g77 1 +と関連ライブラリをビルドしない場合に設定します。 +.It Va NO_LPR +.Vt ( bool ) +.Xr lpr 1 +と関連プログラムをビルドしない場合に設定します。 +.It Va NO_MAILWRAPPER +.Vt ( bool ) +MTA セレクタである +.Xr mailwrapper 8 +をビルドしない場合に設定します。 +.It Va NO_MAKEDEV +.Vt ( bool ) +インストールの際に +.Pa /dev +で +.Dq Li "MAKEDEV all" +を実行しない場合に設定します。 +.It Va NO_OBJC +.Vt ( bool ) +Objective C のサポートをビルドしない場合に設定します。 +.It Va NO_OPENSSH +.Vt ( bool ) +OpenSSH をビルドしない場合に設定します。 +.It Va NO_OPENSSL +.Vt ( bool ) +OpenSSL をビルドしない場合に設定します +(同時に +.Va NO_OPENSSH +も設定されたことになります)。 +.It Va NO_SENDMAIL +.Vt ( bool ) +.Xr sendmail 8 +と関連プログラムをビルドしない場合に設定します。 +.It Va NO_SHAREDOCS +.Vt ( bool ) +.Bx 4.4 +の古い文書をビルドしない場合に設定します。 +.It Va NO_TCSH +.Vt ( bool ) +.Pa /bin/csh +(これは +.Xr tcsh 1 +です) をビルド・インストールしない場合に設定します。 +.It Va NO_X +.Vt ( bool ) +X\-Windows のサポート (例えば +.Xr doscmd 1 +など) をコンパイルしない場合に設定します。 +.It Va NOCLEAN +.Vt ( bool ) +.Dq Li "make buildworld" +の途中で clean を行わない場合に設定します。 +何をやっているかわからない人は設定すべきではありません。 +.It Va NOCLEANDIR +.Vt ( bool ) +.Dq Li "${MAKE} cleandir" +の代わりに +.Dq Li "${MAKE} clean" +を実行する場合に設定します。 +.It Va NOCRYPT +.Vt ( bool ) +crypto コードを一切ビルドしない場合に設定します。 +.It Va NOGAMES +.Vt ( bool ) +ゲームをビルドしない場合に設定します。 +.It Va NOINFO +.Vt ( bool ) +.Xr info 5 +各ファイルを作成・インストールしない場合に設定します。 +.It Va NOLIBC_R +.Vt ( bool ) +.Nm libc_r +.Pf ( Nm libc +のリエントラント版) +をビルドしない場合に設定します。 +.It Va NOMANCOMPRESS +.Vt ( bool ) +man ページのインストールの際に圧縮を行わない場合に設定します。 +.It Va NOPERL +.Vt ( bool ) +.Xr perl 1 +をビルドしない場合に設定します。 +.It Va NOPROFILE +.Vt ( bool ) +profile 版ライブラリをコンパイルしない場合に設定します。 +.It Va NOSECURE +.Vt ( bool ) +.Pa secure +サブディレクトリで crypto コードをビルドしない場合に設定します。 +.It Va NOSHARE +.Vt ( bool ) +.Pa share +サブディレクトリをビルドしない場合に設定します。 +.It Va NOUUCP +.Vt ( bool ) +.Xr uucp 1 +と関連プログラムをビルドしない場合に設定します。 +.It Va PERL_THREADED +.Vt ( bool ) +.Xr perl 1 +をスレッドサポート機能込みでビルド・インストールする場合に設定します。 +.It Va PPP_NOSUID +.Vt ( bool ) +.Xr ppp 8 +を suid root プログラムとしてはインストールしない場合に設定します。 +.It Va SENDMAIL_MC +.Vt ( str ) +インストール時に用いるデフォルトの m4 設定ファイルです。 +この値には .mc ファイルのフルパスを与えます。例えば +.Pa /etc/mail/myconfig.mc 。 +make install すると、既存の +.Pa /etc/mail/sendmail.cf +を上書きしてしまうので、注意して使ってください。 +.Va SENDMAIL_CF +はもう推奨されなくなりました。 +.It Va SENDMAIL_ADDITIONAL_MC +.Vt ( str ) +ビルド時に .cf ファイルに変換される追加分の .mc ファイル +(複数指定可) です。 +値には、これらの .mc ファイルへのフルパスを与えます。 +例えば +.Pa /etc/mail/foo.mc +.Pa /etc/mail/bar.mc +など。 +.It Va SENDMAIL_CFLAGS +.Vt ( str ) +.Xr sendmail 8 +をビルドするときにコンパイルコマンドに渡すフラグです。 +.Va SENDMAIL_* +各フラグを用いれば、 SASL サポートをその設定と共に指定できます。 +例えば次のようにします。 +.Bd -literal -offset indent +SENDMAIL_CFLAGS=-I/usr/local/include -DSASL +SENDMAIL_LDFLAGS=-L/usr/local/lib +SENDMAIL_LDADD=-lsasl +.Ed +.It Va SENDMAIL_LDFLAGS +.Vt ( str ) +.Xr sendmail 8 +ビルドするときに +.Xr ld 1 +コマンドに渡すフラグです。 +.It Va SENDMAIL_LDADD +.Vt ( str ) +.Xr sendmail 8 +をビルドするときに +.Xr ld 1 +コマンドの末尾に追加するフラグです。 +.It Va SENDMAIL_DPADD +.Vt ( str ) +この変数の説明は与えられていません。 +.El +.Pp +次のリストは、ドキュメントのビルドで用いられる変数の名前と簡単な説明です。 +.Bl -tag -width Ar +.It Va DISTDIR +.Vt ( str ) +distfiles が保存されている場所です。 +通常これは +.Va PORTSDIR +の +.Pa distfiles +です。 +.It Va DOC_LANG +.Vt ( str ) +ビルド・インストールする言語とエンコーディングのリストです。 +.It Va PRINTERDEVICE +.Vt ( str ) +システム文書のデフォルトのフォーマットです。 +プリンタに依存します。 +簡単なプリンタなら +.Dq Li ascii +に、PostScript プリンタや +グラフィックスプリンタ + ghostscript フィルターなら +.Dq Li ps +に設定できます。 +.El +.Pp +次のリストは、 ports のビルドで用いられる変数の名前と簡単な説明です。 +.\"HERE GOES! +.Bl -tag -width Ar +.It Va FORCE_PKG_RESIDENT +.Vt ( bool ) +既存の package +(訳注: FreeBSD の package system におけるパッケージを指す場合にこう表記します) +の登録情報を上書きする場合に設定します。 +.It Va HAVE_MOTIF +.Vt ( bool ) +システムに Motif がある場合に設定します。 +.It Va KRB5_HOME +.Vt ( str ) +MIT Kerberos5 の port を +.Pa /usr/local +以外にインストールしたい場合に設定します。 +.\"translator: "ports" で固有単語とみなすべき？ +.It Va LOCALBASE +.Vt ( str ) +X 以外の ports をインストールする際のベースディレクトリを与えます。 +これは +.Pa /usr/ports +でビルドを行う際に +.Va PREFIX +にデフォルト値として与えられます。 +.It Va MASTER_SITE_AFTERSTEP +.Vt ( str ) +AfterStep の ports のマスターサイトを変更します。 +パスの最後の部分は +.Dq Li /%SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_BACKUP +.Vt ( str ) +.Pa Makefile +にリストされている場所が使えない場合、 +ports が distfile をチェックしに行く場所を制御します。 +パスの最後の部分は +.Dq Li /${DIST_SUBDIR}/ +でなければなりません。 +.It Va MASTER_SITE_COMP_SOURCES +.Vt ( str ) +.Pa comp.sources +ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li %SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_GNOME +.Vt ( str ) +GNOME ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li %SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_GNU +.Vt ( str ) +GNU ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li %SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_KDE +.Vt ( str ) +KDE ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li %SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_FREEBSD +.Vt ( bool ) +設定されていると、すべてのファイルをマスターの +.Fx +サイトから取得します。 +.It Va MASTER_SITE_MOZILLA +.Vt ( str ) +Mozilla ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li %SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_OVERRIDE +.Vt ( str ) +設定されていると、ports の +.Pa Makefile +にリストされているサイトよりも先に、このサイトをチェックしに行きます。 +次のようにすればバックアップサイトを先にチェックさせることができます。 +.Bd -literal -offset indent +MASTER_SITE_OVERRIDE?= ${MASTER_SITE_BACKUP} +.Ed +.It Va MASTER_SITE_PERL_CPAN +.Vt ( str ) +Perl ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.\".Bd -literal -offset indent +.\" /%SUBDIR%/ +.\".Ed +.Dq Li /%SUBDIR%/ +でなければなりません。 +.\"translator: ここの .Bd .Ed はコメントアウトしました。 +.It Va MASTER_SORT_REGEX +.Vt ( str ) +ミラーセットのソート順を制御する場合に設定します。 +.Pa .jp +ドメインのミラーを優先的に用いたければ、以下のような設定をします。 +.Bd -literal -offset indent +MASTER_SORT_REGEX?= ^file: ^ftp://ftp\.FreeBSD\.org/pub/FreeBSD/ports/local-distfiles/ ://[^/]*\.jp/ ://[^/]*\.jp\. +.Ed +.Pp +他の国別 TLD ドメインのユーザーは、 +.Dq Li jp +を適切なドメインに変更してください。 +.It Va MASTER_SITE_RINGSERVER +.Vt ( str ) +Ringserver ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li /%SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_RUBY +.Vt ( str ) +Ruby ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li /%SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_SUNSITE +.Vt ( str ) +Sunsite ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li /%SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_TCLTK +.Vt ( str ) +Tcl/Tk ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li /%SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_TEX_CTAN +.Vt ( str ) +TeX ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li /%SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_WINDOWMAKER +.Vt ( str ) +WindowMaker ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li /%SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_XCONTRIB +.Vt ( str ) +X contrib の ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li /%SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_XEMACS +.Vt ( str ) +Xemacs ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li /%SUBDIR%/ +でなければなりません。 +.It Va MASTER_SITE_XFREE +.Vt ( str ) +XFree ports のマスターサイトの場所を制御します。 +パスの最後の部分は +.Dq Li /%SUBDIR%/ +でなければなりません。 +.It Va MOTIFLIB +.Vt ( str ) +.Pa libXm.a +と +.Pa libXm.so +の場所です。 +.It Va MOTIF_STATIC +.Vt ( bool ) +Motif を用いる ports を、Motif の共有ライブラリを持たない +システム上でも実行させたい場合に設定します。 +.It Va NOCLEANDEPENDS +.Vt ( bool ) +.Dq Li "make clean" +によって clean される他の ports から依存されている +ports を clen したくない場合に設定します。 +.It Va NOPORTDOCS +.Vt ( bool ) +ports と同時に追加ドキュメントをインストールしない場合に設定します。 +.It Va PACKAGES +.Vt ( str ) +package ターゲット (package ツリーのディレクトリ) のみに用いられます。 +.\"translator: OK? +.It Va PATCH_SITES +.Vt ( str ) +パッチファイルの配布をしている一次サイトの場所です。 +.It Va PORTSDIR +.Vt ( str ) +ports ツリーの場所です。 +.It Va USA_RESIDENT +.Vt ( bool ) +ユーザーが米国に居住しており、 +米国の輸出規制に従う必要のある ports も、 +これに従っているとみなせる場合に設定します。 +.It Va WRKDIRPREFIX +.Vt ( str ) +ports をビルドする際に用いる一時ファイルを作成する場所です。 +.It Va X11BASE +.Vt ( str ) +X11 ディストリビューションを +.Pa /usr/X11R6 +以外の場所にインストールしたい場合、その場所を設定します。 +.El +.Sh ファイル +.Bl -tag -width /etc/defaults/make.conf -compact +.It Pa /etc/defaults/make.conf +.It Pa /etc/make.conf +.It Pa /usr/doc/Makefile +.It Pa /usr/src/Makefile +.It Pa /usr/src/Makefile.inc1 +.It Pa /usr/ports/Mk/bsd.port.mk +.It Pa /usr/ports/Mk/bsd.sites.mk +.El +.Sh 関連項目 +.Xr gcc 1 , +.Xr install 1 , +.Xr lpd 8 , +.Xr make 1 , +.Xr make 7 , +.Xr ports 7 , +.Xr sendmail 8 +.Sh 履歴 +.Nm +ファイルは +.Fx 4.0 +以前のいつかに登場しました。 +.Sh 作者 +このマニュアルページは +.An "Mike W. Meyer" Aq mwm@mired.org +が書きました。 +.Sh バグ +このマニュアルページは現在の +.Nm +で利用できるオプションに比べると、 +古くなることが時々あるかもしれません。 +現在利用できる最新のオプションについては、 +.Pa /etc/defaults/make.conf +ファイルを調べてください。 + diff --git a/ja_JP.eucJP/man/man7/Makefile b/ja_JP.eucJP/man/man7/Makefile index f57294ebc6..f70b2ba2d6 100644 --- a/ja_JP.eucJP/man/man7/Makefile +++ b/ja_JP.eucJP/man/man7/Makefile @@ -1,32 +1,37 @@ MAN7 = ascii.7\ clocks.7\ environ.7\ groff_char.7\ + groff_man.7\ + groff_markup.7\ groff_me.7\ groff_mm.7\ groff_mmse.7\ groff_ms.7\ groff_msafer.7\ hier.7\ hostname.7\ intro.7\ mailaddr.7\ man.7\ mdoc.7\ mdoc.samples.7\ + mmroff.7\ operator.7\ ports.7\ re_format.7\ + roff.7\ security.7\ style.perl.7\ symlink.7\ term.7 MLINKS= groff_me.7 me.7 MLINKS+=groff_mm.7 mm.7 MLINKS+=groff_mmse.7 mmse.7 MLINKS+=groff_ms.7 ms.7 MLINKS+=groff_msafer.7 msafer.7 +MLINKS+=groff_markup.7 markup.7 MLINKS+=intro.7 miscellaneous.7 .include "bsd.prog.mk" diff --git a/ja_JP.eucJP/man/man7/groff.7 b/ja_JP.eucJP/man/man7/groff.7 new file mode 100644 index 0000000000..37ea5cb49d --- /dev/null +++ b/ja_JP.eucJP/man/man7/groff.7 @@ -0,0 +1,2786 @@ +.\" st -*- nroff -*- +.ig +.\" jpman %Id: groff.7,v 0.0 2000/12/29 19:27:19 horikawa Chk % +groff.7 + +This file is part of groff, the GNU roff type-setting system. + +Copyright (C) 2000 Free Software Foundation, Inc. +written by Bernd Warken + +Last update: 17 May 2000 + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.1 or +any later version published by the Free Software Foundation; with the +Invariant Sections being this .ig-section and AUTHOR, with no +Front-Cover Texts, and with no Back-Cover Texts. + +A copy of the Free Documentation License is included as a file called +FDL in the main directory of the groff source package. +.. +. +.\" -------------------------------------------------------------------- +.\" Setup +.\" -------------------------------------------------------------------- +. +.if n \{\ +. mso tmac.tty-char +. ftr CR R +. ftr CI I +. ftr CB B +.\} +. +.if '\*[.T]'dvi' \{\ +. ftr CB CW +.\} +. +.\" a comment macro which does nothing +.de c +.. +. +.\" a tab string +.ds t "\t +. +.eo +. +.c text lines in macro definitions or bracketed sections \{...\} +.de text +. if 1 \&\$*\& +.. +. +.de option +. ds @tmp@ \f(CB\$1\fP +. shift 1 +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.als shellcommand option +. +.c --------- characters --------- +. +.de character +. ds @tmp@ \f(CB\$1\fP +. shift +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de 'char +. ds @tmp@ \(oq\f(CB\$1\fP\(cq +. shift +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de ''char +. ds @tmp@ \(lq\f(CB\$1\fP\(rq +. shift +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.c --------- requests --------- +. +.c request synopsis +.de REQ +. ds @tmp@ \&\$1 +. shift 1 +. IP "\f(CB\&\*[@tmp@] \fP\f(CI\&\$*\fP" 10n +. rm @tmp@ +.. +. +.de request +. ds @tmp@ \f(CB\$1\fP +. shift 1 +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.c --------- macro or function arguments --------- +. +.de argument +. ds @tmp@ \f(CI\$1\fP +. shift 1 +. while (\n[.$] >= 2) \{\ +. as @tmp@ \/\f(CR\$1\fP\f(CI\,\$2\fP +. shift 2 +. \} +. if \n[.$] .as @tmp@ \/\f(CR\$1\fP +. text \*[@tmp@] +. rm @tmp@ +.. +. +.c argument followed by a numerical expression +.de argterm +. ds @tmp@ \f(CI\$1\fP\|\f(CR\$2\fP +. shift 2 +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.c --------- numerical elements --------- +. +.de number +. ds @tmp@ \f(CR\$1\fP +. shift 1 +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de prefixednumber +. ds @tmp@ \&\$1\ \f(CR\$2\fP +. shift 2 +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.als scaleindicator request +. +.de scalednumber +. ds @tmp@ \f(CR\$1\fP\f(CB\$2\fP +. shift 2 +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de operator +. ds @tmp@ \(oq\f(CB\$1\fP\(cq +. shift +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.c --------- escape sequences --------- +. +.de esc[arg] +. ds @tmp@ \f(CB\(rs\$1[\fP\f(CI\$2\fP\f(CB]\fP +. shift 2 +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de esc(arg +. ds @tmp@ \f(CB\(rs\$1(\fP\f(CI\$2\fP +. shift 2 +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de escarg +. ds @tmp@ \f(CB\(rs\$1\fP\f(CI\$2\fP +. shift 2 +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de esc[] +. ds @tmp@ \f(CB\(rs[\fP\f(CI\$1\fP\f(CB]\fP +. shift +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de esc( +. ds @tmp@ \f(CB\(rs(\fP\f(CI\$1\fP +. shift +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de esc +. ds @tmp@ \f(CB\(rs\$1\fP +. shift +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de (esc +. ds @tmp@ \f(CB\(rs(\$1\fP +. shift +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.de [esc] +. ds @tmp@ \f(CB\(rs[\$1]\fP +. shift +. text \*[@tmp@]\$* +. rm @tmp@ +.. +. +.c escape sequence synopsis +.de ESC +. ds @tmp@ \&\$1 +. shift 1 +. IP "\f(CB\(rs\&\*[@tmp@]\fP\f(CI\&\$*\fP" +. rm @tmp@ +.. +. +.c synopsis for escape sequences with a long name +.de ESC[] +. ds @arg1@ \&\$1 +. ds @arg2@ \&\$2 +. shift 2 +. IP "\f(CB\(rs\&\*[@arg1@][\fP\f(CI\&\*[@arg2@]\fP\f(CB]\&\$*\fP" +. rm @arg1@ +. rm @arg2@ +.. +. +.c synopsis escape sequence with quoted argument +. de ESCq +. ds @tmp@ \&\$1 +. shift 1 +. IP "\f(CB\(rs\&\*[@tmp@]\(cq\fP\f(CI\h'-0.2m'\$*\/\fP\f(CB\(cq\fP" +. rm @tmp@ +.. +. +.c synopsis for 2-escapes (special characters) +.de ESc +. ds @tmp@ \$1 +. TP 14n +. text \f(CB\(rs(\&\*[@tmp@]\ \ \ \fP\fR\(\*[@tmp@]\fP +. shift 1 +. text \$*. +. rm @tmp@ +.. +. +.c --------- registers --------- +. +.c synopsis for registers +.de REG +. TP 10n +. text \&\f(CR\(rsn[\fP\f(CB\$1\fP\f(CR]\fP +. shift 1 +.if \n[.$] \&\$* +.. +. +.als register request +. +.c --------- warnings --------- +. +.als warning request +. +.c description of warnings +.de Warning +. ne (2v + 1) +. TP 12n +. text \f(CB\$1\fP +. text \f(CI\$2\fP +. br +.. +. +.ec +. +.\" -------------------------------------------------------------------- +.\" Title +.\" -------------------------------------------------------------------- +. +.TH GROFF 7 "7 December 2000" "Groff Version 1.16.1" +.SH NAME +groff \- a short reference for the GNU roff language +. +.\" -------------------------------------------------------------------- +.SH DESCRIPTION +.\" -------------------------------------------------------------------- +.I groff +stands for +.I GNU roff +and is the free implementation of the roff type-setting system. +See +.BR roff (7) +for a survey and the background of the groff system. +.LP +This document gives only short descriptions of the predefined roff +language elements as used in groff. +Both the classical features and the groff extensions are provided. +.LP +Historically, the +.I roff language +was called +.IR troff . +.I groff +is compatible with the classical system and provides proper extensions. +So in GNU, the terms +.IR roff , +.IR troff , +and +.I groff language +could be used as synonyms. +However +.I troff +slightly tends to refer more to the classical aspects, whereas +.I groff +emphasizes the GNU extensions, and +.I roff +is the general term for the language. +.LP +This file is only a short version of the complete documentation that is +found in the +.I groff +.BR info (1) +file, which contains more detailed, actual, and concise information. +.LP +The general syntax for writing groff documents is relatively easy, but +writing extensions to the roff language can be a bit harder. +.LP +The roff language is line-oriented. +There are only two kinds of lines, control lines and text lines. +The control lines start with a control character, by default a period +.''char . +or a single quote +.''char ' ; +all other lines are text lines. +.LP +.B Control lines +represent commands, optionally with arguments. +They have the following syntax. +The leading control character can be followed by a command name; +arguments, if any, are separated by blanks from the command name and +among themselves, for example, +.RS +.LP +\&\.command_name arg1 arg2 +.RE +.LP +For indentation, any number of space or tab characters can be inserted +between the leading control character and the command name, but the control +character must be on the first position of the line. +.LP +.B Text lines +represent the parts that will be printed. +They can be modified by escape sequences, which are recognized by a +leading backslash +.'char \(rs . +These are in-line or even in-word formatting elements or functions. +Some of these take arguments separated by single quotes +.''char ' , +others are regulated by a length encoding introduced by an open +parenthesis +.'char ( +or enclosed in brackets +.'char [ +and +.'char ] . +.LP +The roff language provides flexible instruments for writing language +extension, such as macros. +When interpreting macro definitions, the roff system enters a special +operating mode, called the +.BR "copy mode" . +.LP +The copy mode behavior can be quite tricky, but there are some rules +that ensure a safe usage. +.IP 1. +Printable backslashes must be denoted as +.esc e . +To be more precise, +.esc e +represents the current escape character. +To get a backslash glyph, use +.esc (rs . +.IP 2. +Double all backslashes. +.IP 3. +Begin all text lines with the special non-spacing character +.esc & . +.LP +This does not produce the most efficient code, but it should work as a +first measure. +For better strategies, see the groff info file and +.BR groff_tmac (5). +.LP +Reading roff source files is easier, just reduce all double backslashes +to a single one in all macro definitions. +. +.\" -------------------------------------------------------------------- +.SH "GROFF ELEMENTS" +.\" -------------------------------------------------------------------- +The roff language elements add formatting information to a text file. +The fundamental elements are predefined commands and variables that make +roff a full-blown programming language. +.LP +There are two kinds of roff commands, possibly with arguments. +.B Requests +are written on a line of their own starting with a dot +.'char . +or a +.''char ' , +whereas +.B Escape sequences +are in-line functions and in-word formatting elements starting with a +backslash +.'char \(rs . +.LP +The user can define her own formatting commands using the +.request .de +request. These commands are called +.BR macros , +but they are used exactly like requests. Macro packages are pre-defined +sets of macros written in the groff language. +A user's possibilities to create escape sequences herself is very +limited, only special characters can be mapped. +.LP +The groff language provides several kinds of variables with +different interfaces. +There are pre-defined variables, but the user can define her own +variables as well. +.LP +.B String +variables store character sequences. +They are set with the +.request .ds +request and retrieved by the +.esc * +escape sequences. +.LP +.B Register +variables can store numerical values, numbers with a scale unit, and +occasionally string-like objects. +They are set with the +.request .nr +request and retrieved by the +.esc n +escape sequences. +.LP +.B Environments +allow the user to temporarily store global formatting parameters like +line length, font size, etc. for later reuse. +This is done by the +.request .ev +request. +.LP +.B Fonts +are identified either by a name or by an internal number. +The current font is chosen by the +.request .ft +request or by the +.esc f +escape sequences. +Each device has special fonts, but the following fonts are available for +all devices. +.B R +is the standard font Roman. +.B B +is its +.B bold +counterpart. +The +.I italic +font is called +.B I +is everywhere available, but on text devices, it is displayed as an +underlined Roman font. +For the graphical output devices, there exist constant-width pendants of +these font, +.BR CR , +.BR CI , +and +.BR CB . +On text devices, all characters have a constant width anyway. +.LP +Moreover, there are some advanced roff elements. +A +.B diversion +stores information into a macro for later usage. +A +.B trap +is a positional condition like a certain number of lines from page top +or in a diversion or in the input. +Some action can be prescribed to be run automatically when the condition +is met. +.LP +More detailed information can be found in the groff info file. +. +.\" -------------------------------------------------------------------- +.SH "CONTROL CHARACTERS" +.\" -------------------------------------------------------------------- +There is a small set of characters that have a special controlling task +in certain conditions. +.TP +.character . +A dot is only special at the beginning of a line or after the +condition in the requests +.request .if , +.request .ie , +.request .el , +and +.request .while . +There it is the control character that introduces a request (or macro). +The special behavior can be delayed by using the +.esc . +escape. +By using the +.request .cc +request, the control character can be set to a different character, +making the dot +.'char . +a non-special character. +.IP "" +In all other positions, it just means a dot character. +In text paragraphs, it is advantageous to start each sentence at a line +of its own. +.TP +.character ' +The single quote has two controlling tasks. At the beginning of a line +and in the conditional requests it is the non-breaking control +character. +That means that it introduces a request like the dot, but with the +additional property that this request doesn't cause a linebreak. +By using the +.request .c2 +request, the non-break control character can be set to a different +character. +.IP "" +As a second task, it is the most commonly used argument separator in +some functional escape sequences (but any pair of characters not part +of the argument will work). +In all other positions, it denotes the single quote or apostrophe +character. +Groff provides a printable representation with the +.esc (cq +escape sequence. +.TP +.character \(dq +The double quote is used to enclose arguments in requests and macros. +The escaped double quote +.esc \(dq +introduces a comment. +Otherwise, it is not special. +Groff provides a printable representation with the +.esc (dq +escape sequence. +.TP +.character \(rs +The backslash usually introduces an escape sequence (this can be +changed with the +.request ec +request). +A printed version of the escape character is the +.esc e +escape; a backslash glyph can be obtained by +.esc (rs . +.TP +.character ( +The open parenthesis is only special in escape sequences when +introducing an escape name or argument consisting of exactly two +characters. +In groff, this behavior can be replaced by the \f(CB[]\fP construct. +.TP +.character [ +The opening bracket is only special in groff escape sequences; there it +is used to introduce a long escape name or long escape argument. +Otherwise, it is non-special, e.g. in macro calls. +.TP +.character ] +The closing bracket is only special in groff escape sequences; there it +terminates a long escape name or long escape argument. +Otherwise, it is non-special. +.TP +\f(CIspace\fP +Space characters are only functional characters. They separate the +arguments in requests or macros, and the words in text lines. +They are subject to groff's horizontal spacing calculations. +To get a defined space width, escape sequences like +.'char "\(rs\ " +(this is the escape character followed by a space), +.esc | , +.esc ^ , +or +.esc h +should be used. +.IP \f(CInewline\fP +In text paragraphs, newlines mostly behave like space characters. +Continuation lines can be specified by an escaped newline, i.e., by +specifying a backslash +.'char \(rs +as the last character of a line. +.IP \f(CItab\fP +If a tab character occurs during text the interpreter makes a horizontal +jump to the next pre-defined tab position. +There is a sophisticated interface for handling tab positions. +. +.\" -------------------------------------------------------------------- +.SH "NUMERICAL EXPRESSIONS" +.\" -------------------------------------------------------------------- +A +.B numerical value +is a signed or unsigned integer or float with or without an appended +scale indicator. +A +.B scale indicator +is a one-character abbreviation for a unit of measurement. +A number followed by a scale indicator signifies a size value. +By default, numerical values do not have a scale indicator, i.e., they are +normal numbers. +.LP +The roff language defines the following scale indicators. +.LP +.na +.nh +.TS +center, tab(@); +LfCB Lw(4i). +c@Centimeter +i@Inch +P@Pica\ \(eq\ 1/6\ inch +p@Point\ \(eq\ 1/72\ inch +m@T{ +Em\ \(eq\ \fRthe font size in points (width of letter `\f(CRm\fR') +T} +M@100th \fRof an \f(CREm +n@En\ \(eq\ Em/2 +u@\fRBasic unit for actual output device +v@\fRVertical line space in basic units +z@T{ +scaled point\ \(eq\ 1/\f(CIsizescale\fR of a point (defined in +font \fIDESC\fP file) +T} +.TE +.LP +.ad +.hy +.B Numerical expressions +are combinations of the numerical values defined above with +the arithmetical operators +.operator + , +.operator \- , +.operator * , +.operator / , +.operator % +.RI ( modulo ), +the comparative operators +.operator == +(this is the same as +.operator = ), +.operator <= , +.operator >= , +.operator < , +.operator > , +the logical operators +.operator & +.RI ( and ), +.operator : +.RI ( or ), +.operator ! +.RI ( not ), +and the parentheses +.operator ( +and +.operator ) . +.LP +Moreover, +.I groff +added the following operators for numerical expressions: +.LP +.na +.nh +.TS +center, tab(@); +LfCB Lw(4i). +e1\f(CB>?\fPe2@The maximum of \f(CIe1\fP and \f(CIe2\fP. +e1\f(CB0\fP. +T} +!\f(CIN\fP@T{ +True if the value of \f(CIN\fP is\ \f(CR\(<=0\fP. +T} +\&'\f(CIs1\fP'\f(CIs2\fP'@T{ +True if string\ \f(CIs1\fP is identical to string\ \f(CIs2\fP. +T} +!'\f(CIs1\fP'\f(CIs2\fP'@T{ +True if string\ \f(CIs1\fP is not identical to string\ \f(CIs2\fP. +T} +c\f(CIch@T{ +True if there is a character\ \f(CIch\fP available. +T} +d\f(CIname@T{ +True if there is a string, macro, diversion, or request +called \f(CIname\fP. +T} +e@Current page number is even. +o@Current page number is odd. +n@Formatter is \fBnroff\fP. +r\f(CIreg@T{ +True if there is a register named \f(CIreg\fP. +T} +t@Formatter is \fBtroff\fR. +.TE +.LP +.ad +.hy +. +.\" -------------------------------------------------------------------- +.SH REQUESTS +.\" -------------------------------------------------------------------- +This section provides a short reference for the predefined requests. +In groff, request and macro names can be arbitrarily long. +No bracketing or marking of long names is needed. +.LP +Most requests take one or more arguments. +The arguments are separated by space characters (no tabs!); there is no +inherent limit for their length or number. +An argument can be enclosed by a pair of double quotes: This is very handy +if an argument contains space characters, e.g., +.argument "\(dqarg\ with\ space\(dq" +denotes a single argument. +.LP +Some requests have optional arguments with a different behaviour. +Not all of these details are outlined here. +Refer to the groff info file for all details. +.LP +In the following request specifications, most argument names were chosen +to be descriptive. +Only the following denotations need clarification. +.LP +.na +.nh +.TS +center, tab(@); +LfCI Lw(4i). +c@denotes a single character. +font@T{ +a font either specified as a font name or a font number. +T} +anything@T{ +all characters up to the end of the line or within \f(CB\(rs{\fP +and \f(CB\(rs}\fP. +T} +n@T{ +is a numerical expression that evaluates to an integer value. +T} +N@T{ +is an arbitrary numerical expression, signed or unsigned. +T} +\(+-N@T{ +has three meanings depending on its sign, described below. +T} +.TE +.LP +.ad +.hy +If an expression defined as +.argument \(+-N +starts with a +.operator + +sign the resulting value of the expression will be added to an already +existing value inherent to the related request, e.g. adding to a number +register. +If the expression starts with a +.operator - +the value of the expression will be subtracted from the request value. +.LP +Without a sign, +.argument N +replaces the existing value directly. +To assign a negative number either prepend\ \c +.number 0 +or enclose the negative number in parentheses. +. +.\" -------------------------------------------------------------------- +.SS "REQUEST SHORT REFERENCE" +.\" -------------------------------------------------------------------- +.PD 0 +. +.REQ . +Empty line, ignored. Useful for structuring documents. +. +.REQ .\(rs\(dq anything +Complete line is a comment. +. +.REQ .ab string +Print +.argument string +on standard error, exit program. +. +.REQ .ad +Begin line adjustment for output lines in current adjust mode. +. +.REQ .ad c +Start line adjustment in mode +.argument c +(\f(CIc\fP\f(CR\|\^\(eq\|l,r,b,n\fP). +. +.REQ .af register c +Assign format +.argument c +to +.argument register +(\f(CIc\fP\f(CR\|\^\(eq\|l,i,I,a,A\fP). +. +.REQ .aln alias register +Create alias name for +.argument register . +. +.REQ .als alias object +Create alias name for request, string, macro, or diversion +.argument object . +. +.REQ .am macro +Append to +.argument macro +until +.request .. +is called. +. +.REQ .am macro end +Append to +.argument macro +until +.request .end +is called. +. +.REQ .as stringvar anything +Append +.argument anything +to +.argument stringvar . +. +.REQ .asciify diversion +Unformat special ASCII characters in +.argument diversion . +. +.REQ .backtrace +Print a backtrace of the input on stderr. +. +.REQ .bd font N +Embolden +.argument font +by +.argterm N -1 +units. +. +.REQ .bd S font N +Embolden Special Font +.argument S +when current font is +.argument font . +. +.REQ .bp +Eject current page and begin new page. +. +.REQ .bp \(+-N +Eject current page; next page number +.argument \(+-N . +. +.REQ .blm macro +Set the blank line macro to +.argument macro . +. +.REQ .br +Line break. +. +.REQ .break +Break out of a while loop. +. +.REQ .c2 +Reset no-break control character to +.''char ' . +. +.REQ .c2 c +Set no-break control character to +.argument c . +. +.REQ .cc +Reset control character to +.'char . . +. +.REQ .cc c +Set control character to +.argument c . +. +.REQ .ce +Center the next input line. +. +.REQ .ce N +Center following +.argument N +input lines. +. +.REQ .cf filename +Copy contents of file +.argument filename +unprocessed to stdout or to the diversion. +. +.REQ .cflags mode c1 c2 ... +Treat characters +.argument c1 , +.argument c2 , +.argument ... +according to +.argument mode +number. +. +.REQ .ch trap N +Change +.argument trap +location +to +.argument N . +. +.REQ .char c anything +Define character +.argument c +to string +.argument anything . +. +.REQ .chop object +Chop the last character off macro, string, or diversion +.argument object . +. +.REQ .close stream +Close the +.argument stream . +. +.REQ .continue +Finish the current iteration of a while loop. +. +.REQ .cp +Enable compatibility mode. +. +.REQ .cp N +If +.I N +is zero disable compatibility mode, otherwise enable it. +. +.REQ .cs font N M +Set constant character width mode for +.argument font +to +.argterm N /36 +ems with em +.argument M . +. +.REQ .cu N +Continuous underline in nroff, like +.request .ul +in troff. +. +.REQ .da macro +Divert and append to +.argument macro . +. +.REQ .de macro +Define or redefine +.argument macro +until +.request .. +is called. +. +.REQ .de macro end +Define or redefine +.argument macro +until +.request .end +is called. +. +.REQ .di +End current diversion. +. +.REQ .di macro +Divert to +.argument macro . +. +.REQ .do name +Interpret +.request .name +with compatibility mode enabled. +. +.REQ .ds stringvar anything +Set +.argument stringvar +to +.argument anything . +. +.REQ .dt N trap +Set diversion trap to position +.argument N +(default scale indicator\ \c +.scaleindicator v ). +. +.REQ .ec +Reset escape character to +.'char \(rs . +. +.REQ .ec c +Set escape character to +.argument c . +. +.REQ .el anything +Else part for if-else (\c +.argument .ie ) +request. +. +.REQ .em macro +The +.argument macro +will be run after the end of input. +. +.REQ .eo +Turn off escape character mechanism. +. +.REQ .ev +Switch to previous environment. +. +.REQ .ev env +Push down environment number or name +.argument env +and switch to it. +. +.REQ .evc env +Copy the contents of environment +.argument env +to the current environment. +No pushing or popping. +. +.REQ .ex +Exit from roff processing. +. +.REQ .fam name +Set the current font family to +.argument name . +. +.REQ .fc +Disable field mechanism. +. +.REQ .fc a +Set field delimiter to +.argument a +and pad character to space. +.REQ .fc a b +Set field delimiter to +.argument a +and pad character to +.argument b . +. +.REQ .fi +Fill output lines. +. +.REQ .fl +Flush output buffer. +. +.REQ .fp n font +Mount +.argument font +on position +.argument n . +. +.REQ .fp n internal external +Mount font with long +.argument external +name to short +.argument internal +name on position +.argument n . +. +.REQ .fspecial font s1 s2... +When the current font is +.argument font , +then the fonts +.argument s1 , +.argument s2 , +.argument ... +will be special. +. +.REQ .ft +Return to previous font. +Same as +.request \(rsfP . +.REQ .ft font +Change to font name or number +.argument font ; +same as +.esc[arg] f font +escape sequence. +. +.REQ .ftr font1 font2 +Translate +.argument font1 +to +.argument font2 . +. +.REQ .hc +Remove additional hyphenation indicator character. +. +.REQ .hc c +Set up additional hyphenation indicator character\ \c +.argument c . +. +.REQ .hcode c1 code1 c2 code2 ... +Set the hyphenation code of character +.argument c1 +to +.argument code1 , +that of +.argument c2 +to +.argument code2 , +etc. +. +.REQ .hla lang +Set the current hyphenation language to +.argument lang . +. +.REQ .hlm n +Set the maximum number of consecutive hyphenated lines to +.argument n . +. +.REQ .hpf file +Read hyphenation patterns from +.argument file . +. +.REQ .hw words +List of +.argument words +with exceptional hyphenation. +. +.REQ .hy N +Switch to hyphenation mode +.argument N . +. +.REQ .hym n +Set the hyphenation margin to +.argument n +(default scale indicator\ \c +.scaleindicator m ). +. +.REQ .hys n +Set the hyphenation space to +.argument n . +. +.REQ .ie cond anything +If +.argument cond +then +.argument anything +else goto +.request .el . +. +.REQ .if cond anything +If +.argument cond +then +.argument anything ; +otherwise do nothing. +. +.REQ .ig +Ignore text until +.request .. +is called. +. +.REQ .ig end +Ignore text until +.request .end . +. +.REQ .in +Change to previous indent value. +. +.REQ .in \(+-N +Change indent according to +.argument \(+-N +(default scale indicator\ \c +.scaleindicator m ). +. +.REQ .it N trap +Set an input-line count trap at position +.argument N . +. +.REQ .kern +Enable pairwise kerning. +. +.REQ .kern n +If +.argument n +is zero, disable pairwise kerning, otherwise enable it. +. +.REQ .lc +Remove leader repetition character. +. +.REQ .lc c +Set leader repetition character to\ \c +.argument c . +. +.REQ .length register anything +Write the length of the string +.argument anything +in +.argument register . +. +.REQ .lf N file +Set input line number to +.argument N +and filename to +.argument file . +. +.REQ .lg N +Ligature mode on if +.argterm N >0 . +. +.REQ .ll +Change to previous line length. +. +.REQ .ll \(+-N +Set line length according to +.argument \(+-N +(default size +.scalednumber 6.5 i , +default scale indicator\ \c +.scaleindicator m ). +. +.REQ .ls +Change to the previous value of additional intra-line skip. +. +.REQ .ls N +Set additional intra-line skip value to +.argument N , +i.e., +.argterm N -1 +blank lines are inserted after each text output line. +. +.REQ .lt \(+-N +Length of title (default scale indicator\ \c +.scaleindicator m ). +. +.REQ .mc +Margin character off. +. +.REQ .mc c +Print character +.argument c +after each text line at actual distance from right margin. +. +.REQ .mc c N +Set margin character to +.argument c +and distance to +.argument N +from right margin (default scale indicator\ \c +.scaleindicator m ). +. +.REQ .mk register +Mark current vertical position in +.argument register . +. +.REQ .mso file +The same as the .so request except that +.I file +is also searched in the tmac directories. +. +.REQ .na +No output-line adjusting. +. +.REQ .ne +Need a one-line vertical space. +. +.REQ .ne N +Need +.argument N +vertical space (default scale indicator\ \c +.scaleindicator v ). +. +.REQ .nf +No filling or adjusting of output-lines. +. +.REQ .nh +No hyphenation. +. +.REQ .nm +Number mode off. +. +.REQ .nm \(+-N M S I +In line number mode, set number, multiple, spacing, and indent. +. +.REQ .nn +Do not number next line. +. +.REQ .nn N +Do not number next +.argument N +lines. +. +.REQ .nr register \(+-N M +Define or modify +.argument register +using +.argument \(+-N +with auto-increment +.argument M . +. +.REQ .nroff +Make the built-in condition +.B n +true and +.B t +false. +. +.REQ .ns +Turn no-space mode on. +. +.REQ .nx filename +Next file. +. +.REQ .open stream filename +Open +.register filename +for writing and associate the stream named +.register stream +with it. +. +.REQ .opena stream filename +Like +.request .open +but append to it. +. +.REQ .os +Output vertical distance that was saved by the +.request .sv +request. +. +.REQ .pc +Reset page number character to\ \c +.'char % . +. +.REQ .pc c +Page number character. +. +.REQ .pi program +Pipe output to +.argument program +(nroff only). +. +.REQ .pl +Set page length to default +.scalednumber 11 i . +The current page length is stored in +.register .p . +. +.REQ .pl \(+-N +Change page length to +.argument \(+-N +(default scale indicator\ \c +.scaleindicator v ). +. +.REQ .pm +Print macro names and sizes (number of blocks of 128 bytes). +. +.REQ ".pm t" +Print only total of sizes of macros (number of 128 bytes blocks). +. +.REQ .pn \(+-N +Next page number +.argument N . +. +.REQ .pnr +Print the names and contents of all currently defined number registers +on stderr. +. +.REQ .po +Change to previous page offset. The current page offset is available in +.register .o . +. +.REQ .po \(+-N +Page offset +.argument N . +. +.REQ .ps +Return to previous point-size. +.REQ .ps \(+-N +Point size; same as +.esc[arg] s \(+-N . +. +.REQ .psbb filename +Get the bounding box of a PostScript image +.argument filename . +. +.REQ .pso command +This behaves like the +.request .so +request except that input comes from the standard output of +.argument command . +. +.REQ .ptr +Print the names and positions of all traps (not including input line +traps and diversion traps) on stderr. +. +.REQ .rchar c1 c2... +Remove the definitions of characters +.argument c1 , +.argument c2 , +.argument ... +. +.REQ .rd prompt +Read insertion. +. +.REQ .rj n +Right justify the next +.argument n +input lines. +. +.REQ .rm name +Remove request, macro, or string +.argument name . +. +.REQ .rn old new +Rename request, macro, or string +.argument old +to +.argument new . +. +.REQ .rnn reg1 reg2 +Rename register +.argument reg1 +to +.argument reg2 . +. +.REQ .rr register +Remove +.argument register . +. +.REQ .rs +Restore spacing; turn no-space mode off. +. +.REQ .rt \(+-N +Return +.I (upward only) +to marked vertical place (default scale indicator\ \c +.scaleindicator v ). +. +.REQ .shc +Reset soft hyphen character to +.esc (hy . +. +.REQ .shc c +Set the soft hyphen character to +.argument c . +. +.REQ .shift n +In a macro, shift the arguments by +.argument n \ \c +positions. +. +.REQ .so filename +Include source file. +. +.REQ .sp +Skip one line vertically. +. +.REQ .sp N +Space vertical distance +.argument N +up or down according to sign of +.argument N +(default scaling indicator\ \c +.scaleindicator v ). +. +.REQ .special s1 s2 ... +Fonts +.argument s1 , +.argument s2 , +etc. are special and will be searched for characters not in the current font. +. +.REQ .ss N +Space-character size set to +.argument N /12 +of the spacewidth in the current font. +. +.REQ .ss N M +Space-character size set to +.argterm N /12 +and sentence space size set to +.argterm M /12 +of the spacewidth in the current font (\f(CR\(eq1/3 em\fP). +. +.REQ .sty n style +Associate +.argument style +with font position +.argument n . +. +.REQ .substring register n1 n2 +Replace the string in +.argument register +with the substring defined by the indices +.argument n1 +and +.argument n2 . +. +.REQ .sv +Save +.scalednumber 1 v +of vertical space. +. +.REQ .sv N +Save the vertical distance +.argument N +for later output with +.request .os +request. +. +.REQ .sy command-line +Execute program +.argument command-line . +. +.REQ ".ta T" N +Set tabs after every position that is a multiple of +.argument N +(default scaling indicator\ \c +.scaleindicator m ). +.REQ .ta n1 n2 ... nn \f(CBT\fP r1 r2 ... rn +Set tabs at positions +.argument n1 , +.argument n2 , +\&..., +.argument nn , +then set tabs at +.argument nn + r1 , +.argument nn + r2 , +\&..., +.argument nn + rn , +then at +.argument nn + rn + r1 , +.argument nn + rn + r2 , +\&..., +.argument nn + rn + rn , +and so on. +. +.\".REQ .tar +.\"Restore internally saved tab positions. +.\". +.\".REQ .tas +.\"Save tab positions internally. +. +.REQ .tc +Remove tab repition character. +.REQ .tc c +Set tab repetition character to\ \c +.argument c . +. +.REQ .ti \(+-N +Temporary indent next line (default scaling indicator\ \c +.scaleindicator m ). +. +.REQ .tkf font s1 n1 s2 n2 +Enable track kerning for +.argument font . +. +.REQ .tl \f(CB\(cq\fPleft\f(CB\(cq\fPcenter\f(CB\(cq\fPright\f(CB\(cq\fP +Three-part title. +. +.REQ .trf filename +Transparently output the contents of file +.argument filename . +. +.REQ .tm anything +Print +.argument anything +on terminal (UNIX standard message output). +. +.REQ .tr abcd.... +Translate +.argument a +to +.argument b , +.argument c +to +.argument d , +etc. on output. +. +.REQ .trnt abcd.... +This is the same as the +.request .tr +request except that the translations do not apply to text that is +transparently throughput into a diversion with +.esc ! . +. +.REQ .troff +Make the built-in condition +.B t +true and +.B n +false. +. +.REQ .uf font +Underline font set to +.argument font +(to be switched to by +.request .ul ). +. +.REQ .ul N +Underline (italicize in troff) +.argument N +input lines. +. +.REQ .vpt n +Enable vertical position traps if +.argument n +is non-zero, disable them otherwise. +. +.REQ .vs +Change to previous vertical base line spacing. +. +.REQ .vs N +Set vertical base line spacing to +.argument N . +Default value is +.scalednumber 12 p . +. +.REQ .warn n +Set warnings code to +.argument n . +. +.REQ .wh N trap +Set location trap; negative means from page bottom. +. +.REQ .while cond anything +While condition +.argument cond +is true, accept +.argument anything +as input. +. +.REQ .write stream anything +Write +.argument anything +to the stream named +.argument stream . +. +.PD +.LP +Besides these standard groff requests, there might be further macro +calls. +They can originate from a macro package (see +.BR roff (7) +for an overview) or from a preprocessor. +.LP +Preprocessor macros are easy to be recognized. They enclose their code +into a pair of characteristic macros. +.LP +.TS +box, center, tab (@); +c | c | c +CfCB | CfCB | CfCB. +preprocessor@start macro@ end macro += +eqn@.PS@.PE +grap@.G1@.G2 +grn@.GS@.GE +pic@.PS@.PE +refer@.R1@.R2 +soelim@\fInone@\fInone +tbl@.TS@.TE +.TE +.LP +. +.\" -------------------------------------------------------------------- +.SH "ESCAPE SEQUENCES" +.\" -------------------------------------------------------------------- +. +Escape sequences are in-line language elements usually introduced by +a backslash +.'char \(rs +and followed by an escape name and sometimes by a required argument. +Input processing is continued directly after the escaped character or +the argument resp. without an intervening separation character. +So there must be a way to determine the end of the escape name and the end +of the argument. +.LP +This is done by enclosing names (escape name and arguments consisting of +a variable name) by a pair of brackets +.esc[] name +and constant arguments (number expressions and characters) by apostrophes +(ASCII 0x27) like +.IR \(cqconstant\(cq . +.LP +There are abbreviations for short names. +Two character escape names can be specified by an opening parenthesis like +.esc( xy +without a closing counterpart. +And all one-character names different from the special characters +.'char [ +and +.'char ( +can even be specified without a marker in the form +.esc \fP\f(CIc . +.LP +Constant arguments of length +.number 1 +can omit the marker apostrophes, too, but there is no two-character +analogue. +.LP +While 1-character escape sequences are mainly used for in-line functions +and system related tasks, the 2-letter names following the +.esc( "" +construct are used for special characters predefined by the roff system. +Names with more than two characters +.esc[] name +mostly denote user defined named characters (see the +.request .char +request). +. +.\" -------------------------------------------------------------------- +.SS "SINGLE CHARACTER ESCAPES" +.\" -------------------------------------------------------------------- +. +.PD 0 +. +.\" --------- comments --------- +. +.ESC \(dq +Beginning of a comment. +Everything up to the end of the line is ignored. +. +.ESC # +Everything up to and including the next newline is ignored. +This is interpreted in copy mode. +This is like +.esc \(dq +except the ignoring of the terminating newline. +. +.\" --------- strings --------- +. +.ESC * s +The string stored in the string variable with 1-character name +.argument s . +. +.ESC *( st +The string stored in the string variable with 2-character name +.argument st . +. +.ESC[] * stringvar +The string stored in the string variable with arbitrary length name +.argument stringvar . +. +.\" --------- macro arguments --------- +. +.ESC $0 +The name by which the current macro was invoked. The +.request .als +request can make a macro have more than one name. +. +.ESC $ x +Macro argument with 1-place number +.argument x , +where +.argument x +is a digit between 1 and 9. +. +.ESC $( xy +Macro argument with 2-digit number +.argument xy . +. +.ESC[] $ nexp +Macro argument with number +.argument nexp , +where +.argument nexp +is a numerical expression evaluating to an integer \(>=1. +. +.ESC $* +In a macro, the concatenation of all the arguments separated by spaces. +. +.ESC $@ +In a macro, the concatenation of all the arguments with each surrounded +by double quotes, and separated by spaces. +. +.\" --------- escaped characters --------- +. +.ESC \(rs +reduces to a single backslash; useful to delay its interpretation as +escape character in copy mode. +For a printable backslash, use +.esc e . +. +.ESC \(cq +The acute accent \(aa; same as +.esc( aa . +Unescaped: apostrophe, right quotation mark, single quote (ASCII 0x27). +. +.ESC ` +The grave accent \(ga; same as +.esc( ga . +Unescaped: left quote, backquote (ASCII 0x60). +. +.ESC \- +The \- sign in the current font. +. +.ESC . +An uninterpreted dot (period), even at start of line. +. +.ESC % +Default optional hyphenation character. +. +.ESC ! +Transparent line indicator. +. +.ESC ? anything\fB?\fP +In a diversion, this will transparently embed +.argument anything +in the diversion. +.argument anything +is read in copy mode. +See also the escape sequences +.esc ! +and +.esc ? . +. +. +.\" --------- spacing --------- +. +.ESC \& space +Unpaddable space-size space character (no line break). +. +.ESC 0 +Digit width. +. +.ESC | +1/6\ em narrow space character; zero width in nroff. +. +.ESC ^ +1/12\ em half-narrow space character; zero width in nroff. +. +.ESC & +Non-printable, zero width character. +. +.ESC ) +Like +.esc & +except that it behaves like a character declared with the cflags +request to be transparent for the purposes of end of sentence +recognition. +. +.ESC / +Increases the width of the preceding character so that the spacing +between that character and the following character will be correct if +the following character is a roman character. +. +.ESC , +Modifies the spacing of the following character so that the spacing +between that character and the preceding character will correct if the +preceding character is a roman character. +. +.ESC ~ +Unbreakable space that stretches like a normal inter-word space when a +line is adjusted. +. +.ESC \& newline +Ignored newline, for continuation lines. +. +.\" --------- structuring --------- +. +.ESC { +Begin conditional input. +. +.ESC } +End conditional input. +. +.\" --------- longer escape names --------- +. +.ESC ( st +The special character with 2-character name +.argument st , +see section +.BR "SPECIAL CHARACTERS" . +. +.ESC[] \& name +The named character with arbitrary length name +.argument name . +. +.\" --------- alphabetical escapes --------- +. +.ESC a +Non-interpreted leader character. +. +.ESCq A anything +If +.argument anything +acceptable as name of a string, macro, diversion, register, +environment or font it is +.number 1 +otherwise +.number 0 . +. +.ESCq b abc... +Bracket building function. +. +.ESC c +Interrupt text processing. +. +.ESCq C char +The character called +.argument char ; +same as +.esc[] char , +but compatible to other roff versions. +. +.ESC d +Forward (down) 1/2 em vertical unit (1/2 line in nroff). +. +.ESCq D charseq +Draw a graphical element defined by the characters in +.argument charseq ; +see groff info file for details. +. +.ESC e +Printable version of the current escape character. +. +.ESC E +Equivalent to an escape character, but is not interpreted in copy-mode. +. +.ESC f F +Change to font with 1-character name or 1-digit number +.argument F . +. +.ESC f( fo +Change to font with 2-characer name or 2-digit number +.argument fo . +. +.ESC[] f font +Change to font with arbitrary length name or number expression +.argument font . +. +.ESC[] g reg +Return format of register with name +.argument reg +suitable for +.request .af . +Alternative forms +.esc(arg g xy +and +.escarg g x . +. +.ESCq h N +Local horizontal motion; move right +.argument N +(left if negative). +. +.ESCq H N +Set height of current font to +.argument N . +. +.ESC[] k reg +Mark horizontal input place in register with arbitrary length name +.argument reg . +Alternative forms +.esc(arg k xy +and +.escarg k x . +. +.ESCq l Nc +Horizontal line drawing function (optionally using character +.argument c ). +. +.ESCq L Nc +Vertical line drawing function (optionally using character +.argument c ). +. +.ESC n r +The numerical value stored in the register variable with the 1-character +name +.argument r . +. +.ESC n( re +The numerical value stored in the register variable with the 2-character +name +.argument re . +. +.ESC[] n reg +The numerical value stored in the register variable with arbitrary +lenght name +.argument reg . +. +.ESCq N n +Typeset the character with code +.argument n +in the current font, no special fonts are searched. Useful for adding +characters to a font using the +.request .char +request. +. +.ESCq o abc... +Overstrike characters +.argument a , +.argument b , +.argument c , +etc. +. +.ESC p +Break and spread output line. +. +.ESC r +Reverse 1\ em vertical motion (reverse line in nroff). +. +.ESCq R name \(+-n +The same as +.request .nr +.argument name +.argument \(+-n . +. +.ESC[] s \(+-N +Set the point size to +.I N +scaled points. Note the alternative forms +.BI \(rss \(+- [ N ]\c +, +.BI \(rss' \(+-N '\c +, +.BI \(rss \(+- ' N '\c +, +.esc(arg s \(+-xy , +.BI \(rss \(+- ( xy\c +, +.escarg s \(+-x . +Same as +.request .ps +request. +. +.ESCq S N +Slant output +.argument N +degrees. +. +.ESC t +Non-interpreted horizontal tab. +. +.ESC u +Reverse (up) 1/2 em vertical motion (1/2 line in nroff). +. +.ESCq v N +Local vertical motion; move down +.argument N +(up if negative). +. +.ESC[] V env +The contents of the environment variable +.argument env . +Alternative forms +.esc(arg V xy +and +.escarg V x . +. +.ESCq w string +The width of the character sequence +.argument string . +. +.ESCq x N +Extra line-space function (negative before, positive after). +. +.ESCq X string +Output +.argument string +as device control function. +. +.ESC[] Y name +Output string variable or macro +.argument name +uninterpreted as device control function. +Alternative forms +.esc(arg Y xy +and +.escarg Y x . +. +.ESC z c +Print +.argument c +with zero width (without spacing). +. +.ESCq Z anything +Print +.argument anything +and then restore the horizontal and vertical position; +.argument anything +may not contain tabs or leaders. +.PD +.LP +The escape sequences +.esc e , +.esc . , +.esc \(dq , +.esc $ , +.esc * , +.esc a , +.esc n , +.esc t , +.esc g , +and +.escarg \& newline +are interpreted in copy mode. +.LP +Escape sequences starting with +.esc ( +or +.esc [ +do not represent single character escape sequences, but introduce escape +names with two or more characters. +.LP +If a backslash is followed by a character that does not constitute a +defined escape sequence the backslash is silently ignored and the +character maps to itself. +. +.\" -------------------------------------------------------------------- +.SS "SPECIAL CHARACTERS" +.\" -------------------------------------------------------------------- +Common special characters are predefined by escape sequences of the form +.(esc \fP\f(CIxy +with characters +.argument x +and +.argument y . +Some of these exist in the usual font while most of them are only +available in the special font. Below you'll find a selection of the most +important glyphs; a complete list can be found in +.BR groff_char (7). +.RS +.LP +.PD 0 +. +.ESc bu Bullet sign +.ESc co Copyright +.ESc ct Cent +.ESc dd Double dagger +.ESc de Degree +.ESc dg Dagger +.ESc em Em-dash +.ESc hy Hyphen +.ESc rg Registered sign +.ESc sc Section sign +.ESc ul Underline character +.ESc == Identical +.ESc >= Larger or equal +.ESc <= Less or equal +.ESc != Not equal +.ESc -> Right arrow +.ESc <- Left arrow +.ESc +- Plus-minus sign +.PD +.RE +. +.\" -------------------------------------------------------------------- +.SH REGISTERS +.\" -------------------------------------------------------------------- +Registers are variables that store a value. +In groff, most registers store numerical values (see section +.B NUMERICAL EXPRESSIONS +above), but some can also hold a string value. +.LP +Each register is given a name. +Arbitrary registers can be defined and set with the request +.request .nr +.argument register . +.LP +The value stored in a register can be retrieved by the escape sequences +introduced by +.esc n . +.LP +Most useful are predefined registers. +In the following the notation +.argument name +is used to refer to a register called +.register name +to make clear that we speak about registers. +Please keep in mind that the +.esc en[] +decoration is not part of the register name. +. +.\" -------------------------------------------------------------------- +.SS "READ-ONLY REGISTERS" +.\" -------------------------------------------------------------------- +The following registers have predefined values that should not be +modified by the user (usually, registers starting with a dot a read-only). +Mostly, they provide information on the current settings or store results +from request calls. +.LP +.PD 0 +.REG .$ Number of arguments in the current macro. +.REG .A +Set to +.number 1 +in +.B troff +if option +.B \-A +is used; always +.number 1 +in +.BR nroff . +.REG .H Available horizontal resolution in basic units. +.REG .T +Set to +.number 1 +if option +.B \-T +is used. +.REG .V Available vertical resolution in basic units. +.REG .a +Post-line extra line-space most recently utilized using +.escarg x 'N' . +.REG .C 1 if compatibility mode is in effect, 0 otherwise. +.REG .c Current input line number. +.REG .cdp +The depth of the last character added to the current environment. +It is positive if the character extends below the baseline. +.REG .ce +The number of lines remaining to be centered, as set by the +.request .ce +request. +.REG .cht +The height of the last character added to the current environment. +It is positive if the character extends above the baseline. +.REG .csk +The skew of the last character added to the current environment. +The skew of a character is how far to the right of the center of a character +the center of an accent over that character should be placed. +.REG .d +Current vertical place in current diversion; equal to register +.register nl . +.REG .ev The name or number of the current environment (string-valued). +.REG .f Current font number. +.REG .fam The current font family (string-valued). +.REG .fp The number of the next free font position. +.REG .g +Always 1 in GNU troff. +Macros should use it to test if running under groff. +.REG .h Text base-line high-water mark on current page or diversion. +.REG .hla +The current hyphenation language as set by the +.B .hla +request. +.REG .hlc +The number of immediately preceding consecutive hyphenated lines. +.REG .hlm +The maximum allowed number of consecutive hyphenated lines, as set by +the +.request .hlm +request. +.REG .hy +The current hyphenation flags (as set by the +.request .hy +request). +.REG .hym +The current hyphenation margin (as set by the +.request .hym +request). +.REG .hys +The current hyphenation space (as set by the +.request .hys +request). +.REG .i Current ident. +.REG .in The indent that applies to the current output line. +.REG .kern +.number 1 +if pairwise kerning is enabled, +.number 0 +otherwise. +.REG .l Current line length. +.REG .lg +The current ligature mode (as set by the +.request .lg +request). +.REG .ll The line length that applies to the current output line. +.REG .lt +The title length (as set by the +.request .lt +request). +.REG .n Length of text portion on previous output line. +.REG .ne +The amount of space that was needed in the last +.request .ne +request that caused a trap to be sprung. +Useful in conjunction with +.register .trunc . +.REG .o Current page offset. +.REG .p Current page length. +.REG .pn +The number of the next page: either the value set by a +.request .pn +request, or the number of the current page plus\ 1. +.REG .ps The current pointsize in scaled points. +.REG .psr The last-requested pointsize in scaled points. +.REG .rj +The number of lines to be right-justified as set by the rj request. +.REG .s Current point size as a decimal fraction. +.REG .sr +The last requested pointsize in points as a decimal fraction +(string-valued). +.REG .t Distance to the next trap. +.REG .tabs +A string representation of the current tab settings suitable for use as +an argument to the +.request .ta +request. +.REG .trunc +The amount of vertical space truncated by the most recently sprung +vertical position trap, or, if the trap was sprung by a +.request .ne +request, minus the amount of vertical motion produced by +.request .ne . +request. +In other words, at the point a trap is sprung, it represents the difference +of what the vertical position would have been but for the trap, and what the +vertical position actually is. +Useful in conjunction with the +.register .ne +register. +.REG .ss +The value of the parameters set by the first argument of the +.request .ss +request. +.REG .sss +The value of the parameters set by the second argument of the +.request .ss +request. +.REG .u Equal to 1 bin fill mode and 0 in nofill mode. +.REG .v Current vertical line spacing. +.REG .vpt +.number 1 +if vertical position traps are enabled, +.number 0 +otherwise. +.REG .w Width of previous character. +.REG .warn +The sum of the number codes of the currently enabled warnings. +.REG .x The major version number. +.REG .y The minor version number. +.REG .Y The revision number of groff. +.REG .z Name of current diversion. +.REG llx +Lower left x-coordinate (in PostScript units) of a given PostScript +image (set by +.request .psbb ). +.REG lly +Lower left y-coordinate (in PostScript units) of a given PostScript +image (set by +.request .psbb ). +.REG rsb Like +.register sb , +but takes account of the heights and depths of characters. +.REG rst +Like +.register st , +but takes account of the heights and depths of characters. +.REG sb +Depth of string below base line (generated by width function +.esc w ). +.REG skw +Right skip width from the center of the last character in the +.esc w +argument. +.REG ssc +The amount of horizontal space (possibly negative) that should be added +to the last character before a subscript (generated by width function +.esc w ). +.REG st +Height of string above base line (generated by width function +.esc w ). +.REG urx +Upper right x-coordinate (in PostScript units) of a given PostScript +image (set by +.request .psbb ). +.REG ury +Upper right y-coordinate (in PostScript units) of a given PostScript +image (set by +.request .psbb ). +.PD +. +.\" -------------------------------------------------------------------- +.SS "WRITABLE REGISTERS" +.\" -------------------------------------------------------------------- +The following registers can be read and written by the user. +They have predefined default values, but these can be modified for +customizing a document. +.LP +.PD 0 +.REG % Current page number. +.REG c. Current input line number. +.REG ct Character type (set by width function +.esc w ). +.REG dl Maximal width of last completed diversion. +.REG dw Current day of week (1-7). +.REG dy Current day of month (1-31). +.REG hp Current horizontal position at input line. +.REG ln Output line number. +.REG mo Current month (1-12). +.REG nl Vertical position of last printed text base-line. +.REG slimit +If greater than 0, the maximum number of objects on the input stack. +If \(<=0 there is no limit, i.e., recursion can continue until virtual +memory is exhausted. +.REG systat +The return value of the +.I system() +function executed by the last +.request .sy +request. +.REG year The current year (year 2000 compliant). +.REG yr +Current year minus 1900. For Y2K compliance use register +.register year +instead. +.PD +. +.\" -------------------------------------------------------------------- +.SH WARNINGS +.\" -------------------------------------------------------------------- +Each warning generated by groff is identified by a name and a code +number. The codes are powers of 2 to allow bit-encoding with a single +integer. There are also names that can be used to refer to groups of +warnings. +.LP +The name associated with a warning is used by the +.option \-w +and +.option \-W +options; +the number code is used by the +.request .warn +request and by the +.esc[arg] n warn +register. +.LP +.PD 0 +.Warning all group +All warnings except +.warning di , +.warning mac +and +.warning reg . +Intended to cover all warnings with traditional macro packages. +.Warning break 4 +In fill mode, lines which could not be broken so that their length was +less than the line length. This is enabled by default. +.Warning char 1 +Non-existent characters. This is enabled by default. +.Warning delim 8 +Missing or mismatched closing delimiters. +.Warning di 256 +Use of +.request .di +or +.request .da +without an argument when there is no current diversion. +.Warning el 16 +Use of the +.request .el +request with no matching +.request .ie +request. +.Warning escape 32768 +Unrecognized escape sequence. Then the escape character is ignored. +.Warning font 131072 +Non-existent fonts. This is enabled by default. +.Warning ig 262144 +Illegal escapes in text ignored with the +.request \.ig +request. These are conditions that are errors when they occur outside +of ignored text. +.Warning mac 512 +Use of undefined strings, macros, and diversions. Automatically handled +as empty. Usually, only one warning per name. +.Warning missing 8192 +Request that is missing non-optional arguments. +.Warning input 16384 +Illegal input character. +.Warning number 2 +Invalid numeric expressions. This is enabled by default. +.Warning range 64 +Out of range arguments. +.Warning reg 1024 +Use of undefined number register. Automatically defined as having +value 0. Usually, only one warning per name. +.Warning right-brace 4096 +Use of +.esc } +where a number was expected. +.Warning scale 32 +Meaningless scaling indicators. +.Warning space 65536 +Missing space between a request or macro and its argument. Then no +macro is automatically defined. This is enabled by default. This +warning will never occur in compatibility mode. +.Warning syntax 128 +Dubious syntax in numeric expressions. +.Warning tab 2048 +Inappropriate use of a tab character (either in an unquoted macro +argument or where a number was expected). +.Warning w group +All warnings. +.PD +.LP +.TS +tab(@), box, expand; +c c c | c c c | c c c +R RI CB | R RI CB | R RI CB. +Bit@Code@Warning@Bit@Code@Warning@Bit@Code@Warning +_ +0@1@char@8@256@di@16@65536@space +1@2@number@9@512@mac@17@131072@font +2@4@break@10@1024@reg@18@262144@ig +3@8@delim@11@2048@tab +4@16@el@12@4096@right-brace +5@32@scale@13@8192@missing +6@64@range@14@16384@input +7@128@syntax@15@32768@escape +.TE +.LP +. +.\" -------------------------------------------------------------------- +.SH COMPATIBILITY +.\" -------------------------------------------------------------------- +.I groff +provides a +.B compatibility mode +that allows to process roff code written for classical +.troff +or for other implementations of roff in a consistent way. +.LP +Compatibility mode can be turned on with the +.option \-C +command line option, and turned on or off with the +.request .cp +request. The number register +.esc(arg n .C +is +.number 1 +if compatibility mode is on, +.number 0 +otherwise. +.LP +This became necessary because the GNU concept for long names causes some +incompatibilities. +.I Classical troff +will interpret +.IP +.B +\&.dsabcd +.LP +as defining a string +.B ab +with contents +.BR cd . +Normally, +.I groff +will interpret this as a call of a macro named +.request dsabcd . +.LP +Also +.I classical troff +will interpret +.esc *[ +or +.esc n[ +as references to a string or number register called +.register [ . +In +.I GNU native +.IR mode , +however, this will normally be interpreted as the start of a long name. +.LP +In +.I compatibility +.IR mode , +groff will interpret these things in the traditional way, but long names +are not recognized. +.LP +On the other hand, groff in +.I GNU native mode +does not allow to use the escape sequences +.esc e , +.esc | , +.esc ^ , +.esc & , +.esc } , +.esc { , +.esc "\ " (space), +.esc ' , +.esc ` , +.esc - , +.esc _ , +.esc ! , +.esc % , +and +.esc c +in names of strings, macros, diversions, number registers, fonts or +environments, whereas +.I classical troff +does. The +.esc A +escape sequence can be helpful in avoiding these escape sequences in +names. +.LP +Fractional pointsizes cause one noteworthy incompatibility. +In +.I classical +.IR troff , +the +.request .ps +request ignores scale indicators and so +.RS +.LP +.B .ps\ 10u +.RE +.LP +will set the pointsize to 10 points, whereas in groff native mode the +pointsize will be set to 10 scaled points. +.LP +In +.I groff +mode, there is a fundamental difference between unformatted input +characters, and formatted output characters. +Everything that affects how an output character will be output is stored +with the character; once an output character has been constructed it is +unaffected by any subsequent requests that are executed, including the +.request .bd , +.request .cs , +.request .tkf , +.request .tr , +or +.request .fp +requests. +.LP +Normally output characters are constructed from input characters at the +moment immediately before the character is added to the current output +line. +Macros, diversions and strings are all, in fact, the same type of object; +they contain lists of input characters and output characters in any +combination. +.LP +An output character does not behave like an input character for the +purposes of macro processing; it does not inherit any of the special +properties that the input character from which it was constructed might +have had. +The following example will make things clearer. +.LP +.RS +.nf +.ft B +\&.di x +\(rs\(rs\(rs\(rs +\&.br +\&.di +\&.x +.ft +.fi +.RE +.LP +In +.I GNU mode +this will be printed as +.esc \(rs . +So each pair of input backslashes +.'char \(rs\(rs +is turned into a single output backslash +.'char \(rs +and the resulting output backslashes are not interpreted as escape +characters when they are reread. +.LP +.I Classical troff +would interpret them as escape characters when they were reread and +would end up printing a single backslash +.'char \(rs . +.LP +The correct way to get a printable +.'char \(rs +is to use the +.esc e +escape sequence. This will always print a single instance of the +current escape character, regardless of whether or not it is used in a +diversion. It will also work in both GNU mode and compatibility mode. +.LP +To store an escape sequence in a diversion that will be interpreted when +the diversion is reread, either the traditional +.esc ! +transparent output facility or the +new +.esc ? +escape sequence can be used. +. +.\" -------------------------------------------------------------------- +.SH BUGS +.\" -------------------------------------------------------------------- +At the moment, the documentation of the groff system is in a state of +change and evolution. It is possible that there are small +inconsistencies between different documents temporarily. +.LP +The +.B WARNINGS +section belongs to +.BR troff (1). +. +.\" -------------------------------------------------------------------- +.SH AUTHOR +.\" -------------------------------------------------------------------- +This document is part of groff, the GNU roff distribution. It was +written by Bernd Warken . +.LP +It is distributed under the terms of the FDL (GNU Free Documentation +License) version 1.1 or later. You should have received a copy of the +FDL on your system, it is also available on-line under +.RS +.LP +.IR http://www.gnu.org/copyleft/fdl.html . +.RE +.LP +Formerly, the extensions of the groff language were kept in the manual +page +.BR troff (1). +This document contains the essential parts of that documentation, but +the gory details are found in the groff info file. +. +.\" -------------------------------------------------------------------- +.SH "SEE ALSO" +.\" -------------------------------------------------------------------- +The main source of information for the groff language is the +.B groff +.BR info (1) +file. +.LP +For a survey of roff and the groff system and further documentation +pointers see +.BR roff (7). +.LP +The formatter programs are described in +.BR groff (1) +and +.BR troff (1); +a complete of all predefined glyph names can be found in +.BR groff_char (7). +.LP +The classical +.I troff +documentation is available on-line at +.RS +.LP +.I http://cm.bell-labs.com/cm/cs/cstr.html +.RE +and +.RS +.IR http://www.kohala.com/start/troff/ . diff --git a/ja_JP.eucJP/man/man7/groff_man.7 b/ja_JP.eucJP/man/man7/groff_man.7 new file mode 100644 index 0000000000..7b84cbdfb7 --- /dev/null +++ b/ja_JP.eucJP/man/man7/groff_man.7 @@ -0,0 +1,461 @@ +.ig \"-*- nroff -*- +Copyright (C) 1999-2000 Free Software Foundation, Inc. + +Permission is granted to make and distribute verbatim copies of +this manual provided the copyright notice and this permission notice +are preserved on all copies. + +Permission is granted to copy and distribute modified versions of this +manual under the conditions for verbatim copying, provided that the +entire resulting derived work is distributed under the terms of a +permission notice identical to this one. + +Permission is granted to copy and distribute translations of this +manual into another language, under the above conditions for modified +versions, except that this permission notice may be included in +translations approved by the Free Software Foundation instead of in +the original English. +.. +.\" jpman %Id: groff_man.7,v 1.3 2001/02/21 02:20:00 horikawa Stab % +.\" WORD: hanging indentation ぶら下げインデント +.\" WORD: designator 指示子 +.de TQ +.br +.ns +.TP \\$1 +.. +.TH GROFF_MAN 7 "7 December 2000" "Groff Version 1.16.1" +. +.SH 名称 +. +groff_man \- マニュアルページ生成サポート用 groff `man' マクロ +. +.SH 書式 +. +.B groff +.B \-man +[ +.IR options .\|.\|. +] +[ +.IR files .\|.\|. +] +. +.SH 解説 +. +.I groff +でマニュアルページを生成するのに使用される +.B tmac.an +マクロは、James Clark が書きました。 +このドキュメントは、パッケージ中の各マクロの使い方を、短くまとめたものです。 +. +.SH オプション +. +.B man +マクロは、次のようなコマンドラインオプションを理解します +(レジスタをいくつか定義します)。 +.TP +.B \-rC1 +コマンドラインに複数のマニュアルページを与えた場合、 +それぞれのページ番号が\ 1 から始まるのではなく、連続した番号に +なります。 +.TP +.B \-rD1 +両面印字にします。 +偶数ページと奇数ページのフッタは、異なった整形が成されます。 +.TP +.BI \-rP nnn +ページの数え始めを\ 1 ではなく +.I nnn +からにします。 +.TP +.BI \-rS xx +ベースドキュメントフォントサイズを +10\ ポイントではなく +.I xx +ポイントにします +.RI ( xx +には 10, 11, 12 のいずれかが使用できます)。 +.TP +.BI \-rX nnn +ページ\ \c +.IR nnn +の後のページを +.IR nnn a, +.IR nnn b, +.IR nnn c +などというように数えます。例えば、`\-rX2' というオプションの場合、 +ページを 1, 2, 2a, 2b, 2c というように割り振ります。 +. +.SH 使用法 +. +このセクションは、マニュアルページ用に使用可能なマクロについて +述べています。さらにカスタマイズしたい場合は、 +.B man.local +ファイル中に追加のマクロおよびリクエストを置いてください。 +このファイルは +.BR tmac.an +の直後にロードされます。 +.TP +.BI .TH " title section " [ extra1 "] [" extra2 "] [" extra3 ] +このマニュアルページのタイトルを +.I title +に、セクションを +.IR section +に設定します。セクションは、 +1 から\ 8 までの値をとらなくてはなりません。 +.I section +値には、後ろに文字列を置くこともできます。例えば、 +`.pm' とすると、マニュアルページの特定のサブセクションを +示します。 +.I title +と +.I section +は、ともにヘッダ行の左端と右端に置かれます +(括弧でくくられた +.I section +が +.IR title +の直後に付きます)。 +.I extra1 +は、フッタ行の中央に置かれます。 +.I extra2 +は、フッタ行の左に置かれます +(両面印字がアクティブになっている場合、偶数ページには +左に、奇数ページには右に、置かれます)。 +.I extra3 +はヘッダ行の中央に置かれます。 +.IP +HTML 出力用には、ヘッダおよびフッタは完全に取り除かれます。 +.IP +さらに、このマクロは改ページします。新しい行番号は、再度\ 1 に +なります (コマンドラインで `-rC1' オプションが指定されている場合を +除きます)。この機能は、複数のマニュアルページを整形する +場合のためだけにあります。マニュアルページが 1 つの場合、 +.B TH +は、ファイルの先頭において、まさに 1 つだけ存在すべきです。 +.TP +.BI ".SH [" "text for a heading" ] +番号づけをしないセクション用の見出しを設定します。 +これは左詰めになります。 +.B SH +に続いたテキスト ( +.BR SH +に引数がない場合は次の行のテキスト) は、行末までのものがすべてボールド体で、 +そしてベースドキュメントサイズよりも 1 だけ大きなフォントサイズで +表示されます 。 +さらに、テキストの左側の余白はデフォルト値に戻されます。 +.TP +.BI ".SS [" "text for a heading" ] +番号づけしないセクションの 2 番目の見出しを設定します。 +.B SS +に続いたテキスト ( +.BR SS +に引数がない場合は次の行のテキスト) は、行末までのものがすべてボールド体で、 +そしてベースドキュメントサイズと同じ大きさのフォントで表示されます。 +さらに、テキストの左側の余白はデフォルト値に戻されます。 +.TP +.BI ".TP [" nnn ] +インデントされた、ラベルつきの段落を設定します。 +インデント幅は、引数が与えられていれば +.I nnn +に設定されます (省略されていれば、デフォルトの単位は +`n' です)。引数が与えられていなければ、インデント幅は +デフォルト値に設定されます。 +このマクロの後に続いたテキストの 1 行目は、 +左詰めに表示する文字列として解釈され、 +ラベルとして使用するのに適切なものとなります。 +これは段落の一部であるとは解釈はされませんので、 +引き続く入力行のテキストで 1 行目を満たそうとはしません。 +それでも、ラベルがインデント幅ほど広がっていない場合には、 +同じ行から段落が始まり (ただし、インデントはされます)、次の +行へと続いていきます。 +ラベルがインデント幅よりも広い場合は、段落の説明部分は +ラベルの次の行から始まり、すべてインデントされます。 +ラベルのフォントの形もサイズもデフォルト値には設定されない +ことに注意してください。これに対して、残りのテキストは +デフォルトのフォント設定になります。 +.B TP +マクロは、あなたが今ちょうど読んでいるこの解説に使用されている +マクロです。 +.TP +.B .LP +.TQ +.B .PP +.TQ +.B .P +これらのマクロは、共通の別名です。 +これらのうちのどれを使用しても現在の位置で行を打ち切ります。 +そして、その後に +.B PD +マクロで指定した量だけ垂直方向にスペースを置きます。 +フォントのサイズおよび形はデフォルト値に戻されます +(10pt ローマン体)。 +最後に、現在の左側の余白の量を復元します。 +.TP +.BI ".IP [" designator "] [" nnn ] +インデントされた段落を設定します。その際、 +.I designator +を段落の始まりに印をつけるためのタグとして使用します。 +インデント幅は、引数が与えられている場合は +.I nnn +に設定されます (デフォルトの単位は `n' です)。 +引数が与えられていない場合は、デフォルトのインデント幅が +使用されます。 +この段落 (ただし、指示子 (designator) を含まず) の +フォントサイズおよびフェースはデフォルト値に戻されます。 +特定のインデントをするが指示子をつけない段落を開始するには、 +第 2 引数に `""' (ダブルクォート 2 つ) を使用してください。 +.IP +例えば次の段落は、`.IP\ \\(bu\ 4' を用いて、すべて +指示子として中点をつけて設定されます: +.RS +.IP \(bu 4 +.B IP +は、リストを整形するために +.B tmac.an +で使用される 3 つのマクロのうちの 1 つです。 +.IP \(bu 4 +.B HP +は、また別のマクロです。 +このマクロは、左側にぶら下げインデントされた段落を生成します。 +.IP \(bu 4 +.B TP +は、また別のマクロです。 +このマクロは、インデントされないラベルを生成し、その後に +インデントされた段落が続きます。 +.RE +.TP +.BI ".HP [" nnn ] +左側にぶら下げインデントされた段落を設定します。 +引数が与えられている場合、インデント幅は +.I nnn +に設定されます (デフォルトの単位は `n' です)。 +引数が与えられていない場合、デフォルトのインデント幅が +使用されます。 +フォントサイズおよびフェースはデフォルト値に戻されます。 +次の段落は、インデント幅を\ 4 に設定されているときの +このマクロの効果を示したものです: +.RS +.HP 4 +この段落は、 +.B HP +マクロを実行したあとの段落です。 +見ての通り、このマクロは、最初の行を除いた行すべてが +インデントされた段落を生成しています。 +.RE +.TP +.BI ".RS [" nnn ] +このマクロは、値が与えられていれば (デフォルト単位は +`n' です) その値だけ左側の余白を右に移動します。 +値が与えられていなければ、デフォルトのインデント幅が +使用されます。 +.B RS +マクロの呼び出しは入れ子にできます。 +.TP +.BI ".RE [" nnn ] +このマクロは、左側の余白を +.IR nnn +レベルまで戻します。引数が与えられていなければ、 +このマクロはレベルを 1 つだけ戻します。 +第 1 レベル (すなわち、まだ +.B RS +を呼び出していない) は番号\ 1 を持っており、 +.B RS +マクロを呼び出すごとにレベルが\ 1 ずつ増加します。 +.PP +まとめると、次のマクロは、垂直方向にスペースを入れた +行の折り返しを行います (スペースの量は +.B PD +マクロを使用すると変更できます): +.BR SH , +.BR SS , +.BR TP , +.B LP +.RB ( PP , +.BR P ), +.BR IP , +.BR HP +。 +マクロ +.B RS +および +.B RE +も行を折り返しますが、垂直方向にスペースを入れません。 +. +.SH "フォントを設定するためのマクロ" +. +標準フォントはローマン体です。そして、デフォルトのテキストサイズは +10\ ポイントです。 +.TP +.BI ".SM [" text ] +同じ行にあるテキストあるいは次の行にあるテキストが、 +デフォルトのフォントよりも 1 ポイントだけ小さいフォントで +表示されるようになります。 +.TP +.BI ".SB [" text ] +同じ行にあるテキストあるいは次の行にあるテキストが、 +ボールド体のフォントで、そしてデフォルトのフォントよりも +1 ポイントだけ小さいフォントで表示されるようになります。 +.TP +.BI ".BI " text +同じ行にあるテキストが、ボールド体とイタリック体を +交互に使って表示されるようになります。 +テキストはマクロ呼び出しと同じ行にあることが必要です。 +したがって、 +.RS +.IP +\&.BI this "word and" that +.PP +という行は、`this' と `that' がボールド体で表示され、 +それに対して `word and' の部分はイタリック体で +表示されます。 +.RE +.TP +.BI ".IB " text +テキストが、イタリック体とボールド体を交互に使って +表示されるようになります。テキストはマクロ呼び出しと +同じ行にあることが必要です。 +.TP +.BI ".RI " text +マクロ呼び出しと同じ行にあるテキストが、ローマン体と +イタリック体を交互に使って表示されるようになります。 +テキストは、マクロ呼び出しと同じ行にあることが必要です。 +.TP +.BI ".IR " text +マクロ呼び出しと同じ行にあるテキストが、イタリック体と +ローマン体を交互に使って表示されるようになります。 +テキストは、マクロ呼び出しと同じ行にあることが必要です。 +.TP +.BI ".BR " text +マクロ呼び出しと同じ行にあるテキストが、ボールド体と +ローマン体を交互に使って表示されるようになります。 +テキストは、マクロ呼び出しと同じ行にあることが必要です。 +.TP +.BI ".RB " text +マクロ呼び出しと同じ行にあるテキストが、ローマン体と +ボールド体を交互に使って表示されるようになります。 +テキストは、マクロ呼び出しと同じ行にあることが必要です。 +.TP +.BI ".R [" text ] +.I text +がローマン体フォントで表示されるようになります。 +マクロが呼び出された行にテキストがない場合は、次の行の +テキストがローマン体で表示されます。 +これが、他のマクロを処理し終わったときに返されるテキストの +デフォルトのフォントです。 +.TP +.BI ".B [" text ] +.I text +がボールド体で表示されるようになります。 +マクロが呼び出された行にテキストがない場合は、次の行の +テキストがボールド体で表示されます。 +.TP +.BI ".I [" text ] +.I text +がイタリック体で表示されるようになります。 +マクロが呼び出された行にテキストがない場合は、次の行の +テキストがイタリック体で表示されます。 +. +.SH "その他" +. +.B grohtml +を除いた出力デバイス用のインデント幅はすべて 7.2n です。 +grohtml の場合は替わりに 1.2i になります。 +.TP +.B .DT +0.5 インチごとにタブを設定します。 +このマクロは常に +.B TH +リクエスト中で呼ばれるため、タブ位置が変更された場合に限って +呼び出すことには意味があります。 +.TP +.BI ".PD [" nnn ] +新しい段落 (セクション) の前のスペースを調整します。 +オプションの引数は、スペースの量を与えます (デフォルトの単位は `v')。 +パラメータ無しの場合、この値はデフォルト値に戻されます +(tty デバイスでは 1 行で、それ以外では 0.4v)。 +このリクエストは、 +.BR SH , +.BR SS , +.BR TP , +.B LP +(それぞれ \& +.B PP +および +.BR P ), +.BR IP , +.BR HP +マクロに影響を与えます。 +.PP +次の文字列が定義されています: +.TP +.B \e*S +デフォルトのフォントサイズに戻します。 +.TP +.B \e*R +「登録」マークです。 +.TP +.B \e*(Tm +「商標」マークです。 +.TP +.B \e*(lq +.TQ +.B \e*(rq +左および右クォートです。 +これは、それぞれ `\e(lq' と `\e(rq' と同じです。 +.PP +.B tbl +あるいは +.B eqn +のようなプリプロセッサが必要な場合、マニュアルページの +1 行目を次のように見えるようにする例になります: +.PP +.RS +.BI .\e"\ word +.RE +.PP +ダブルクォートの後には空白文字 1 つが入ることに注意してください。 +.I word +は、必要なプリプロセッサを表す文字で成り立っています。 +`e' は +.BR eqn +を表し、 +`r' は +.BR refer +を、そして `t' は +.BR tbl +を表します。 +最近の +.B man +プログラムの実装では、この 1 行目を読んで自動的に正しい +プリプロセッサを呼び出します。 +. +.SH "関連項目" +. +.B tmac.an +マクロは、 +.I groff +リクエストの集まりでできていますので、原理的には、 +必要がある場合には自己流の +.I groff +リクエストを作って +.B tmac.an +の機能を追加することができます。 +これらのリクエストの完全なリストは WWW ページ +.PP +.ce 1 +http://www.cs.pdx.edu/~trent/gnu/groff/groff_toc.html +から入手できます。 +.PP +.BR tbl (1), +.BR eqn (1), +.BR refer (1), +.BR man (1) +. +.SH 作者 +. +このマニュアルページは、本来 Debian GNU/Linux システム用に +Susan G. Kleinmann が書いたものです。 +それを Werner Lemberg が修正し、更新しました。 +それが今では GNU troff 配布物の一部になっています。 diff --git a/ja_JP.eucJP/man/man7/groff_markup.7 b/ja_JP.eucJP/man/man7/groff_markup.7 new file mode 100644 index 0000000000..548205c694 --- /dev/null +++ b/ja_JP.eucJP/man/man7/groff_markup.7 @@ -0,0 +1,340 @@ +.TH GROFF_MARKUP 7 "7 December 2000" "Groff Version 1.16.1" +.\" jpman %Id: groff_markup.7,v 1.3 2001/03/09 04:57:05 horikawa Stab % +.\" Copyright (C) 2000 Free Software Foundation, Inc. +.\" Written by Gaius Mulley (gaius@glam.ac.uk) +.\" +.\" This file is part of groff. +.\" +.\" groff is free software; you can redistribute it and/or modify it under +.\" the terms of the GNU General Public License as published by the Free +.\" Software Foundation; either version 2, or (at your option) any later +.\" version. +.\" +.\" groff is distributed in the hope that it will be useful, but WITHOUT ANY +.\" WARRANTY; without even the implied warranty of MERCHANTABILITY or +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +.\" for more details. +.\" +.\" You should have received a copy of the GNU General Public License along +.\" with groff; see the file COPYING. If not, write to the Free Software +.\" Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +.\" +.\" user level guide to using the -markup macroset +.\" +.do mso tmac.arkup +.LINE +.SH 名称 +groff_markup \- ウェブページのオーサリング用 groff マクロ +.LINE +.SH 書式 +.B "groff \-markup" +[ options ] +file ... +.SH 解説 +このマニュアルページは、GNU \-markup マクロについて解説しています。 +これは、groff ドキュメント整形システムの一部です。 +このマニュアルページは、ごく基本的なガイドに過ぎませんし、 +html デバイスドライバ +.RB (grohtml) +はいまだにアルファ版という段階です。 +多くの人達がテストする機会を持てるようにするため、 +このマクロを配布物に含めているのです。 +このマクロファイルは、\fC-Thtml\fP を使用すれば +(\fCtroffrc\fP ファイルによって) 自動的に呼ばれるのだということに +注意してください。 +.PP +ハイパーリンクが動作することを確認するには、このマニュアルページを +.B grohtml +デバイスを用いて整形してください。 +.PP +これは、このマクロセットで見つかる機能の概要です。 +.SH 書式 +.ta 2iL +\&.HTMLINDEX セクション / ヘッダ用に自動的に +.br + 作成されるリンクのレベルを決定します。 +.br +\&.BODYCOLOR ウェブページの色を指定します。 +.br +\&.BACKGROUND 背景画像を指定します。 +.br +\&.URL 2 つのパラメータを用いて URL を作成します。 +.br +\&.MAILTO HTML 用電子メールアドレスを作成します。 +.br +\&.FTP FTP への参照を作成します。 +.br +\&.IMAGE 画像ファイルを挿入します。 +.br +\&.HTML デバイスドライバに生の HTML +.br + リクエストを渡します。 +.br +\&.TAG $1 から HTML の name タグを生成します。 +.br +.\"\&.CDFTP optionally create two different links +.\".br +.\" depending on hostname +.\".br +\&.LINE 水平方向の罫線を幅いっぱいに作成します。 +.br +.PP +.IR pic , +.IR eqn , +.IR refer +および +.I tbl +プリプロセッサの出力を入力として受け付けることができます。 +.SH リクエスト +.TP +.B HTMLINDEX +見出しに対して自動的に作成されるリンクの +切り捨てレベルを決定します。 +デフォルトでは、troff ドキュメント中にある +すべての見出しへのリンクが HTML ウェブページの先頭に作成されます。 +おそらく、細かいレベルの見出しにはリンクは必要ないことが +多いでしょう。またウェブページによっては、見出しへのリンクは一切 +必要ないものもあるかもしれません。このような場合、 +.sp +.nf +\fC\&.HTMLINDEX 0\fP +.fi +.sp +とすると、 +.B grohtml +がリンクを生成しないようになります。 +\fCHTMLINDEX\fP を 2 にすると +.sp +.B "1.1.1 Some Title" +.sp +という見出しも、3 レベル目の見出しがあるということにより、 +リンクに含まれないようになります。 +.TP +.B BODYCOLOR +5 つパラメータを取ります: 文字色、背景色、アクティブな +ハイパーリンクの色、まだ訪問したことがない +ハイパーリンクの色、そして訪問したことのある +ハイパーリンクの色です。 +.TP +.B BACKGROUND +このマクロの唯一のパラメータは、背景画像ファイルを示します。 +.TP +.B URL +2 つあるいは 3 つのパラメータを使用して +.TAG URL +URL を生成します。 +$1 はリンク名、$2 は実際の URL、そして $3 は $2 の直後に +印字されるオプション部分です。 +これは、 +.URL "groff のホームページ" http://groff.ffii.org/ +のエンコードの方法を示したものです。 +.sp +.nf +\s-2\fC\&.URL "groff のホームページ" http://groff.ffii.org/ :\fP\s+2 +.fi +.sp +\fC-Thtml\fP 以外のデバイスでこれを処理すると、 +次のように表示されます: +groff のホームページ \(lahttp://groff.ffii.org\(ra 。 +URL マクロは、どんな種類の要素でも使えます。例えば、 +.URL "Eric Raymond の pic ガイド" pic.html +という参照を次のようにして作ることができます: +.sp +.nf +\s-2\fC\&.URL "Eric Raymond の pic ガイド" pic.html\fP\s+2 +.fi +.sp +.TP +.B MAILTO +HTML 用の電子メール参照を生成します。 +第 1 引数は、電子メールアドレスとして必須のものです。 +第 2 引数はオプションであり、ブラウザに表示されるテキストです。 +そして、第 3 引数もオプションであり、これは第 2 引数の直後に +表示されるものです。 +例えば、groff メンテナは +.MAILTO wl@gnu.org "Werner Lemberg" +と +.MAILTO Ted.Harding@nessie.mcc.ac.uk "Ted Harding" +です。 +これは、次のマクロで実現します: +.sp +.nf +\s-2\fC\&.MAILTO wl@gnu.org "Werner Lemberg"\fP +.sp +\fC\&.MAILTO Ted.Harding@nessie.mcc.ac.uk \\ +.br +"Ted Harding" \s+2\fP +.fi +.sp +実際には、groff では URL はテキストとしての空白を +一切使わないものとして扱われることに注意してください。 +このことは、いくつかの問題の原因となりますのでバグだと +考えられるでしょう。 +これを回避するために、\fCtmac.arkup\fP は他に影響を +与えない空白に展開される幅 0 の文字を挿入します +(HTML モードであるときに限ります)。 +.TP +.B FTP +データが FTP 経由で取得できることを示します。 +第 1 引数は、ブラウザに表示されるテキストであり、 +第 2 引数は URL です。 +第 3 引数は、先に述べたマクロと同様に、第 2 引数の +直後に表示されるテキストとして扱われます。 +第 2 および第 3 の引数はオプションです。 +例として、これは、 +.FTP "現在の groff 開発者用配布物" \ +ftp://ftp.ffii.org/pub/groff/devel/groff-current.tar.gz +の場所です。 +このマクロの例は、次のように指定します: +.sp +\s-2\fC\&.FTP "現在の groff 開発者用配布物" \\ +.br +ftp://ftp.ffii.org/pub/groff/devel/groff-current.tar.gz \fP\s+2 +.sp +.TP +.B IMAGE +ドキュメントに画像を含めることができます。 +第 1 引数は画像ファイルです。 +次の 2 つの引数はオプションです。 +第 2 引数は画素数での画像の幅です (指定がなければ、デフォルトは +400 画素です)。 +第 3 引数は画素数での画像の高さです (指定がなければ、デフォルトは +画像幅と同じです)。 +.sp +.TP +.B HTML +このマクロの後に続いたテキストはすべて生の HTML として +扱われます。 +ドキュメントが \fC-Thtml\fP を \fI使わずに\fP +処理される場合、このマクロは無視されます。 +このマクロは、より高水準な他のマクロの構成要素です。 +.sp +例えば、\fCBACKGROUND\fP マクロは次のように定義されます: +.nf +\fC\&.de BACKGROUND +\&. HTML +\&.. +\fP +.fi +.TP +.B TAG +引数から HTML の name タグを生成します。 +このタグは、 +.URL URL #URL +マクロを使って参照できます。 +御覧の通り、同一ドキュメント内の参照ですので、タグ名の前には +`\fC#\fP' を付けなくてはなりません。 +このリンクは、先の URL マクロの記述の中で TAG を置くことで +実現したのです。ソースは次のようになります: +.sp +\s-2\fC\&.TP +.br +\&.B URL +.br +は、 +.br +\&.TAG URL +を生成します。 +.br +URL は 2 個あるいは 3 個の +.br +引数を使います。 +.br +$1 がリンクの名前、そして $2 が実際の URL です。 +.br +\fP\s+2 (後略) +.sp +.\".TP +.\".B CDFTP +.\"takes four arguments. +.\"Basically it is the FTP macro with optional local reference. +.\"It was designed to allow the same groff source to be built on two different +.\"machines and access the ftp data differently. +.\"For example, on a web server you might wish for the web page to reference +.\"a web site. +.\"However, if you were producing a CDROM of your information you might wish +.\"for the ftp data to be also stored on your CDROM and referenced as a file. +.\"An example to get the current groff development distribution +.\".CDFTP merlin "click here." \ +.\"ftp://ftp.ffii.org/pub/groff/devel/groff-current.tar.gz \ +.\"../../groff.tar.gz +.\"The source for this CDFTP invocation is +.\".sp +.\"\fC\s-2\&.CDFTP merlin "click here." \ +.\"ftp://ftp.ffii.org/pub/groff/devel/groff-current.tar.gz \ +.\"../../groff.tar.gz\fP\s+2 +.\".sp +.\"which means if the html is generated on machine \fCmerlin\fP +.\"then generate a URL to \fC../../groff.tar.gz\fP. +.\"Otherwise construct an FTP URL to +.\"\fCftp://ftp.ffii.org/pub/groff/devel/groff-current.tar.gz\fP. +.TP +.B LINE +水平方向に幅いっぱいの罫線を生成します。 +次が例です: +.sp +\fC\s-2\&.LINE\fP\s+2 +.sp +.SH +セクション見出しへのリンク +.LP +デフォルトでは、 +.B grohtml +はセクションの見出しすべてへのリンクを生成し、リンクを +HTML ドキュメントの先頭に配置します。 +.B grohtml +は、セクションの見出しがどう見えるかを推測しなくてはなりません +\(em +.B grohtml +が実際に見ているものは、どこにテキストを置き、どこに +線を引き、どこでフォントサイズやフェースを変えるべきかなどを示した、 +デバイス非依存の言語だけなのだということを覚えておいてください。 +.B grohtml +は、最も左端から始まったボールド体のテキスト行が +見出しなのだと信じています。 +そのため、見出しを間違って解釈することもあります。 +ユーザは、\fCgroff -P-g\fP を使って groff を起動させることで、 +見出しおよびタイトルの推測機能をすべて抑制することができます。 +.SH +grohtml の制限 +.LP +基本的なテキストはそのままの形で変換できますが、 +.B grohtml +がテキストの関係を作ろうとしたり推測したりしなくては +ならないような領域がいくつかあります。 +とりわけ、 +テキストの表やインデントされた段落、あるいは 2 段組モードに +つき当たると、 +.B grohtml +は常に列をそろえるために HTML の table の作成を実行しようと +します。 +.B grohtml +は、ブラウザが自動的に整形する必要があるのはどの行なのかも +突き止めようとします。 +結局のところ、理にかなった推測をしようとすれば、大抵の場合 +間違いが生じます。 +バグレポートやパッチを頂いていくうちにこうした間違いはどんどん +起こらなくなっていくのではないかと期待します。:-) +.PP +tbl, pic, eqn の結果も画像を使って生成されており、 +このことも制限とみなされるかもしれません。 +.SH 関連ファイル +/usr/share/tmac/tmac.arkup +.SH "関連項目" +.BR groff (1), +.BR troff (1), +.BR grohtml (1) +.LP +.SH 作者 +.B grohtml +は +.MAILTO gaius@glam.ac.uk "Gaius Mulley" +が書きました。 +.LINE +.SH バグ +バグレポートは +.MAILTO bug-groff@gnu.org "Groff Bug Mailing List" +へ送ってください。 +バグが再現できるように、完全で自己完結している例を付けてください。 +また、どのバージョンの groff を使っているかも伝えてください。 +.LINE diff --git a/ja_JP.eucJP/man/man7/mmroff.7 b/ja_JP.eucJP/man/man7/mmroff.7 new file mode 100644 index 0000000000..63147e5d56 --- /dev/null +++ b/ja_JP.eucJP/man/man7/mmroff.7 @@ -0,0 +1,50 @@ +.\" +.\" %Id: mmroff.man,v 1.2 2000/02/21 20:32:58 jhaegg Exp % +.\" jpman %Id: mmroff.7,v 1.3 2001/02/06 03:23:45 horikawa Stab % +.\" +.TH MMROFF 7 "7 December 2000" "Groff Version 1.16.1" +.SH 名称 +mmroff \- 参照のプリプロセッサ +.SH 書式 +.B mmroff +[ +.I -x +] +.I groff_arguments +.SH 解説 +\fBmmroff\fP は、\fBgroff\fP 用の単純なプリプロセッサです。 +これは、\fBmm\fP マクロにおいて参照を展開するために使用されます。 +\fBgroff_mm(7)\fP を参照してください。 +\fBgroff\fP は 2 度実行されます。1 回目では \fB-z\fP および +\fB-rRef=1\fR オプションつきで実行され、すべての参照を収集し、 +そして、参照ファイルが最新のものになってから実際の参照の処理を +行います。 +.TP +\fB\-x\fR +参照ファイルを作るだけです。このオプションは参照ファイルを +更新するのに使用できますが、正しい参照を作るために必要な +処理とは限りません。また、このオプションを使用すると、 +\fBgroff\fP は 1 回だけ実行されます。 +.\".SH BUGS +.SH 作者 +J\(:orgen H\(:agg, Lund, Sweden です。 +.SH 関連ファイル +.TP +.B /usr/share/tmac/tmac.m +.TP +.B /usr/share/tmac/mm/*.cov +.TP +.B /usr/share/tmac/mm/*.MT +.TP +.B /usr/share/tmac/mm/locale +.SH "関連項目" +.BR groff_mm(7), +.BR groff_mmse(7), +.BR groff (1), +.BR troff (1), +.BR tbl (1), +.BR pic (1), +.BR eqn (1) +.br +.BR mm (7) +.BR mmse (7) diff --git a/ja_JP.eucJP/man/man7/roff.7 b/ja_JP.eucJP/man/man7/roff.7 new file mode 100644 index 0000000000..f7c64c295e --- /dev/null +++ b/ja_JP.eucJP/man/man7/roff.7 @@ -0,0 +1,536 @@ +.\" -*- nroff -*- +.ig +roff.7 + +This file is part of groff, the GNU roff type-setting system. + +Copyright (C) 2000 Free Software Foundation, Inc. +written by Bernd Warken + +Last update: 17 May 2000 + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.1 or +any later version published by the Free Software Foundation; with the +Invariant Sections being this .ig-section and AUTHOR, with no +Front-Cover Texts, and with no Back-Cover Texts. + +A copy of the Free Documentation License is included as a file called +FDL in the main directory of the groff source package. +.. +.\" jpman %Id: roff.7,v 1.3 2001/03/09 05:10:03 horikawa Stab % +. +.\" -------------------------------------------------------------------- +.\" Setup +.\" -------------------------------------------------------------------- +. +.if n \{\ +. mso tmac.tty-char +. ftr CR R +. ftr CI I +. ftr CB B +.\} +. +.\" text lines in macro definitions or bracketed sections \{...\} +.de text +. if 1 \&\\$*\& +.. +. +.de option +. ds @tmp@ \f(CB\\$1\fP +. shift 1 +. text \\*[@tmp@]\\$* +. rm @tmp@ +.. +. +.de 'char +. ds @tmp@ `\f(CB\\$1\fP' +. shift +. text \\*[@tmp@]\\$* +. rm @tmp@ +.. +. +.de esc +. ds @tmp@ \f(CB\e\\$1\fP +. shift +. text \\*[@tmp@]\\$* +. rm @tmp@ +.. +. +.de argname +. ds @tmp@ \f(CI\\$1\fP +. shift 1 +. text \\*[@tmp@]\\$* +. rm @tmp@ +.. +. +.de prefixednumber +. ds @tmp@ \&\\$1\ \f(CR\\$2\fP +. shift 2 +. text \\*[@tmp@]\\$* +. rm @tmp@ +.. +. +.\" WORD: gremlin picture gremlin 図 +.\" -------------------------------------------------------------------- +.\" Title +.\" -------------------------------------------------------------------- +.TH ROFF 7 "7 December 2000" "Groff Version 1.16.1" +.SH 名称 +roff \- roff 清書システムの調査 +.\" -------------------------------------------------------------------- +.SH 解説 +.\" -------------------------------------------------------------------- +.I roff +とは清書プログラム群の一般名称です。 +.IR troff , +.IR nroff , +.IR groff +などの名前で知られています。 +.LP +roff 清書システムは、整形用言語、マクロパッケージ、 +プリプロセッサ、出力デバイス用ポストプロセッサ、 +ユーザ用フロントエンドプログラム、そして変換ツールから +構成されています。 +.LP +今日、最も一般的な roff システムはフリーソフトウェアでの +実装である +.I groff +(`GNU\ roff') +です。groff より前の実装は「古典」 (1973 年まで遡ります) +と呼ぶことにします。 +.LP +.I groff +は、古典である祖先のシステムと下位互換性がありますが、数多くの +拡張がされており、今もなお進化し続けています。 +ほとんどすべての計算機システムで利用できるため、今日では事実上の +roff 標準となっています。 +.LP +その古さにもかかわらず、roff は今日でも広く使用されています。 +例えば、UNIX システムのマニュアルページ +.RI ( man ページ ) +は roff で書かれています。 +テキストデバイスに対する roff 出力は、いまだに並ぶもののないほど優れて +います。グラフィカルな出力も他のフリーの清書プログラムと同等の品質を +持っていますし、ものによっては商用システムのものよりも優れているときも +あります。 +.LP +このドキュメントでは概要のみを示し、詳細なドキュメントについては +ポインタを示します。 + +このドキュメントは維持されておらず、時代遅れになっている可能性が +あります。正確なドキュメントが必要なら groff info ファイルを +参照してください。これには詳細で現実に即した正確なリファレンス情報が +含まれています。 +.\" -------------------------------------------------------------------- +.SH "整形用言語" +.\"-------------------------------------------------------------------- +.I roff +システム用の言語を指す 3 つの用語があります。 +.I troff 言語 +は、 +.I roff +の古典的な部分に重点を置くときに使われます。 +.I groff 言語 +は GNU 拡張を含んでおり、それに対して +.I roff 言語 +は一般的な用語です。 +.LP +.I groff 言語 +のすべての部分について記述されたドキュメントの一次情報源は +groff info ファイルです。 +.BR groff (7) +マニュアルページでは、定義済みの言語要素すべてについて +簡潔な説明をしています。 +.LP +roff を使用したドキュメントは、普通のテキストファイルを整形用 +要素で修飾したものです。 +マクロパッケージの 1 つを使って高品質のドキュメントを書くのは +とても簡単なことです。 +マクロパッケージは高水準プログラミング言語のようなものであり、 +それに対して素の roff 言語は C やアセンブラのような低水準言語に +たとえられます。 +.LP +roff 言語は低水準のリクエスト、マクロ定義、エスケープシーケンス、 +文字列変数、数値レジスタまたはサイズレジスタ、そして C のような +制御構造を提供する完全なプログラミング言語です。 +.ig / +In the 1980s, it was even possible to write the common utilities for +system administration by only using troff. +There were contests on writing the most unreadable program fake by +exclusively using troff. +Because of security impacts, these dangerous features were removed in +.IR groff . +./ +.LP +この言語の要素についていくらか説明が必要でしょう。 +リクエストは、C, C++ のようなプログラミング言語によって定義された +基本的な整形用コマンドです。それに対して、マクロは roff 言語で +記述された整形用コマンドです。 +ドキュメントの著者は、リクエストとマクロを使う際の違いに +気づくことはないでしょう。どちらもドット +.'char . +始まりの単独行で記述されます。 +ただし、望むならば、ユーザは独自のマクロを定義できます。 +.LP +エスケープシーケンスはインライン要素で、バックスラッシュ +.'char \e +で始まります。これらはさまざまな機能を実装するのに +使われます。それには、 +.esc ( +を用いた非 ASCII 文字の挿入、 +.esc * +を用いた文字列の内容の挿入、 +.esc n +を用いたレジスタ変数の挿入、 +.esc f +を用いたフォントの変更、 +.esc \(dq +を用いた文中のコメント、 +.esc \e +のような特殊な制御文字のエスケープ、 +その他多くの機能が含まれます。 +.\" -------------------------------------------------------------------- +.SH フォーマッタ +.\"-------------------------------------------------------------------- +フォーマッタは groff ドキュメントを解析し、それを特殊なデバイスに合った +形式に変換するためのフロントエンドプログラムです。 +古典的な +.I roff +にはフォーマッタが 2 つあります。 +.B nroff +がテキストデバイス用で、 +.B troff +がグラフィカルデバイス用です。 +.LP +これらのプログラムは +.I groff +実装でもまだ存在しますが、通常は +.BR groff +と呼ばれるプログラムを通してアクセスされます。 +これによって、古くからの機能を 1 つのプログラムに結合し、拡張 +できるのです。 +groff には多くのコマンドラインオプションがあります。その大部分が +.BR troff +からもらい受けたものです。 +このオプションの密林から逃れるべく、ユーザフレンドリなユーティリティ +.B grog +(`groff guess' からとられた名前です) が作成されました。 +これは、どの引数を使うべきかを、ドキュメントから推測して、適切な +コマンドラインを表示します。 +完璧なものではありませんが、取り掛かりには良いでしょう。 +.\" -------------------------------------------------------------------- +.SH プリプロセッサ +.\"-------------------------------------------------------------------- +groff でもまだ利用可能な古典的プリプロセッサです。 +.RS +.LP +.PD 0 +.TP +.I eqn +数式を埋め込むためのものです。 +.TP +.I grap +グラフィカル要素を構成するためのものです (このプリプロセッサは +groff と一緒にはついてきません。追加パッケージです)。 +.TP +.I grn +gremlin 図を埋め込むためのものです。 +.TP +.I pic +図を作成するためのものです。 +.TP +.I refer +参考文献の参照用です。 +.TP +.I soelim +他の roff ファイルを埋め込むためのものです。 +.TP +.I tbl +長方形のテーブル用です。 +.PD +.RE +.LP +これらのプリプロセッサはそれぞれ独自の言語を定義しており、 +プリプロセッサに通されると、roff コードに変換されます。 +ですので、これらの言語で書かれた部分は roff ドキュメントに +埋め込んであっても良いのです。 +こうした拡張ドキュメントは、実際のフォーマッタにかけられる前に、 +対応する 1 つ以上のプリプロセッサに通されます。 +.LP +プリプロセッサプログラムは、プリプロセッサ用に +限定されているドキュメントの部分を抽出し、変換します。 +プリプロセッサは、 +それらのプログラム名を使った UNIX パイプラインで呼び出すことも、 +もしくは groff オプションで自動的に呼び出すこともできます。 +.LP +.TS +center, box, tab (@); +C | C +CfCB | CfCB. +プリプロセッサ@groff オプション += +eqn@\-e +grap@\-G +grn@\-g +pic@\-p +refer@\-R +tbl@\-r +soelim@\-s +.TE +.LP +. +.\" -------------------------------------------------------------------- +.SH "マクロパッケージ" +.\" -------------------------------------------------------------------- +マクロパッケージは、ある特殊な種類のドキュメントを簡便な方法で +フォーマットするのに適したマクロの集合です。 +マクロパッケージによって、roff の使い勝手が格段に良くなります。 +パッケージのマクロ定義は、 +.BI tmac. name +と呼ばれるファイルに保管されています。ここで、 +.I name +はこのパッケージに対する roff 内部での名称です。 +すべての tmac ファイルは、 +1 つあるいは少数のディレクトリ中の標準の場所に保管されています。 +.LP +ドキュメントが使用するマクロパッケージは、 +フォーマッタのコマンドラインオプション +.option \-m +で指定し、例えば +.option "troff\ \-m" +.argname name +や +.option "groff\ \-m" +.argname name +とします。 +マクロパッケージの命名およびその置き場所についての一般的な詳細は +.BR tmac (5) +にあります。 +.LP +古くからある有名なマクロパッケージは +.IR man , +.IR mandoc , +.I mdoc +がマニュアルページ用、そして +.IR me , +.IR ms , +.I mm +が書籍、記事、そして手紙用です。 +これらのコレクションのほかにも、groff はさまざまな用途の +新しいマクロパッケージを提供しており、その数は増加しています。 +例えば、他のファイル形式を統合したり変換したりするものです。 +.\" -------------------------------------------------------------------- +.SH "ファイル名の拡張子" +.\" -------------------------------------------------------------------- +マニュアルページ (man ページ) はファイル名の拡張子として +セクション番号をとります。例えば、このドキュメントのファイル名は +.IR roff.7 +です。つまり、このドキュメントはマニュアルページの +.prefixednumber section 7 +に保存されているということです。 +.LP +古典的なマクロパッケージは、パッケージ名を拡張子にとります。 +例えば、 +.I me +マクロパッケージを使ったドキュメントは +.IB file. me +となり、 +.IR mm +マクロパッケージに対しては +.IB file. mm +、 +.IR ms +マクロパッケージに対しては +.IB file. ms +、 +.I pic +ファイルに対しては +.IB file. pic +といった具合です。 +.ig +.LP +But there is no general naming scheme for roff documents, though +.IB file. roff +or +.IB file. rof +seems to be a good choice. +.LP +File name extensions can be very handy in conjunction with the +.BR less (1) +pager. +It provides the possibility to feed all input into a command-line pipe that +is specified in the shell environment variable +.B LESSOPEN +This process is not well documented, so here an example +.B LESSOPEN='|lesspipe %s' +where +.B lesspipe +is either a system supplied command or a shell script of your own. +.. +.\" -------------------------------------------------------------------- +.SH 編集方法 +.\" -------------------------------------------------------------------- +ほとんどのテキストエディタは roff を使ったドキュメントの編集を +サポートしています。特に使い勝手が良いのが、Emacs エディタ +とその仲間での +.B nroff-mode +です。 +.\" -------------------------------------------------------------------- +.SH 環境変数 +.\" -------------------------------------------------------------------- +.TP +.SM +.B GROFF_TMAC_PATH +コロン区切りの検索ディレクトリリストです。 +.BR tmac (5) +を参照してください。 +.TP +.SM +.B GROFF_TYPESETTER +デフォルトのデバイスです。 +.TP +.SM +.B GROFF_FONT_PATH +.BI dev name +コロン区切りの検索ディレクトリリストです。 +.B troff +は、このリストよりも先に、 +.option \-F +オプションで与えられたディレクトリを検索します。 +標準ディレクトリ +.RB ( .:/usr/local/share/groff/font:/usr/lib/font ) +内はこのリストの後で検索されます。 +.\" -------------------------------------------------------------------- +.SH 関連ファイル +.\"-------------------------------------------------------------------- +デフォルトでは、 +.I groff +はライブラリファイルをすべて +.IR /usr/local/share/groff +配下のディレクトリツリーにインストールします。 +この場所は、システムによっては異なるかもしれません。 +以降、このディレクトリを +.IR +として表現します。 +.LP +.TP +.IB /tmac/troffrc +troff 用の初期化ファイル +.TP +.IB /tmac/tmac. name +マクロファイル +.TP +.IB /font/dev name /DESC +.IR name +デバイス記述ファイル +.TP +.IB /font/dev name / F +.IR name +デバイスの +.I F +フォント用のフォントファイル +.\" -------------------------------------------------------------------- +.SH バグ +.\" -------------------------------------------------------------------- +groff ドキュメントは現在も発展途上です。 +ドキュメント間で一時的に小さな食い違いが生じる可能性があります。 +.\" -------------------------------------------------------------------- +.SH 作者 +.\" -------------------------------------------------------------------- +このドキュメントは groff すなわち GNU roff 配布物の一部です。 +Bernd Warken が書きました。 +.LP +このドキュメントは FDL (GNU Free Documentation License) バージョン 1.1 +以降の条項のもとに配布されています。FDL のコピーをシステム上に +持っているはずです。また、これはオンライン +.RS +.LP +.IR +.RE +でも入手可能です。 +.\" -------------------------------------------------------------------- +.SH "関連項目" +.\" -------------------------------------------------------------------- +主な情報源は、 +.I groff +.BR info (1) +ファイルです。 +.LP +定義済みの +.I groff +言語要素についても +.BR groff (7) +マニュアルページに記載があります。 +.LP +フォーマッタおよびそのラッパについては +.BR groff (1), +.BR grog (1), +.BR nroff (1), +.BR troff (1) +に記載があります。 +.LP +出力デバイス用のポストプロセッサについては +.BR grodvi (1), +.BR grohtml (1), +.BR grolbp (1), +.BR grolj4 (1), +.BR grops (1), +.BR grotty (1) +に記載があります。 +.LP +標準プリプロセッサについては +.BR eqn (1), +.BR grn (1), +.BR grap (1), +.BR pic (1), +.BR refer (1), +.BR soelim (1), +.BR tbl (1) +に記載があります。 +.LP +マクロパッケージについてのマニュアルページには +.BR groff_tmac (5), +.BR groff_man (7), +.BR groff_markup (7), +.BR groff_mdoc (7), +.BR groff_mdoc.samples (7), +.BR groff_me (7), +.BR groff_mm (7), +.BR groff_mmroff (7), +.BR groff_ms (7), +.BR groff_msafer (7) +が含まれています。 +.LP +次のようなユーティリティが利用できます: +.BR addftinfo (1), +.BR afmtodif (1), +.BR hpftodit (1), +.BR indxbib (1), +.BR lookbib (1), +.BR pfbtops (1), +.BR tfmtodit (1), +.BR gxditview (1) +です。 +.LP +.I roff +システムの GNU 実装についての詳細は +.BR groff_char (7), +.BR groff_font (7), +.BR groff_out (7) +および groff ソース配布物のメインディレクトリ内の +.I README +ファイルを参照してください。 +.I groff +開発グループとの連絡の取り方や参加の仕方についての +詳細も載っています。 +.LP +古典的な +.troff +ドキュメントは今でもオンラインで入手可能です。 +特に有益なのが、かのフリーである UNIX 7 用のベル研オリジナルの +会報です。これは +.I http://cm.bell-labs.com/cm/cs/cstr.html +にあります。そして、故 Richard S. Stevens のコレクションが +.IR http://www.kohala.com/start/troff/ +にあります。