OSDN Git Service

Import translated manuals from JM CVS Repository.
[linuxjm/jm.git] / manual / GNU_groff / draft / man5 / groff_tmac.5
diff --git a/manual/GNU_groff/draft/man5/groff_tmac.5 b/manual/GNU_groff/draft/man5/groff_tmac.5
new file mode 100644 (file)
index 0000000..cfdfb75
--- /dev/null
@@ -0,0 +1,681 @@
+.\"                        -*- nroff -*- 
+.ig /
+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 <bwarken@mayn.de>
+
+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.
+./
+.\" Japanese Version Copyright (c) 2001 UCHIDA Norihiro all rights reserved.
+.\" Translated Mon Mar 12 2001 by UCHIDA Norihiro <KY4N-UCD@asahi-net.or.jp>
+.\" --------------------------------------------------------------------
+.\" 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@
+..
+.
+.\" --------------------------------------------------------------------
+.\" Title
+.\" --------------------------------------------------------------------
+.TH GROFF_TMAC 5 "22 May 2000" "Groff Version 1.16.1"
+.\"O .SH NAME
+.SH Ì¾Á°
+.\"O groff_tmac \- macro files in the roff typesetting system
+groff_tmac \- roff ¥Æ¥­¥¹¥ÈÀ°·Á¥·¥¹¥Æ¥à¤Î¥Þ¥¯¥í¥Õ¥¡¥¤¥ë
+.\" --------------------------------------------------------------------
+.\"O .SH DESCRIPTION
+.SH ÀâÌÀ
+.\" --------------------------------------------------------------------
+.\"O The
+.\"O .BR roff (7)
+.\"O type-setting system provides a set of macro packages suitable for
+.\"O special kinds of documents.  Each macro package stores its macros and
+.\"O definitions in a file called the package's
+.\"O .BR "tmac file" .
+.\"O The name is deduced from
+.\"O .RB ` T roff
+.\"O .BR MAC ros'.
+.BR roff (7)
+¥Æ¥­¥¹¥ÈÀ°·Á¥·¥¹¥Æ¥à¤Ï¡¢ÆÃÄê¤Î¥É¥­¥å¥á¥ó¥È¤Ë¤È¤Ã¤ÆÊØÍø¤Ê¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤ò
+Ä󶡤·¤Æ¤¤¤ë¡£¤½¤ì¤¾¤ì¤Î¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Ï¥Ñ¥Ã¥±¡¼¥¸¤´¤È¤Î
+.B tmac ¥Õ¥¡¥¤¥ë
+¤È¸Æ¤Ð¤ì¤ë¥Õ¥¡¥¤¥ë¤Ë¥Þ¥¯¥í¤ÈÄêµÁ¤ò³ÊǼ¤·¤Æ¤¤¤ë¡£
+¤³¤Î̾Á°¤Ï
+.RB ` T roff
+.BR MAC ros'
+¤ËͳÍ褹¤ë¡£
+.LP
+.\"O The tmac files are normal roff source documents, except that they
+.\"O usually contain only definitions and setup commands, but no text.  All
+.\"O tmac files are kept in a single or a small number of directories, the
+.\"O .B tmac
+.\"O directories.
+tmac ¥Õ¥¡¥¤¥ë¤ÏÉáÄ̤Πroff ¤Î¥½¡¼¥¹¥É¥­¥å¥á¥ó¥È¤Ç¡¢Ä̾ï¤ÏÄêµÁ¤È¥»¥Ã¥È¥¢¥Ã¥×
+¥³¥Þ¥ó¥É¤À¤±¤ò´Þ¤ß¡¢¥Æ¥­¥¹¥È¤Ï´Þ¤Þ¤ì¤Ê¤¤¡£
+¤¹¤Ù¤Æ¤Î tmac ¥Õ¥¡¥¤¥ë¤Ï¡¢¤Ò¤È¤Ä¤¢¤ë¤¤¤Ï¤¤¤¯¤Ä¤«¤Î¥Ç¥£¥ì¥¯¥È¥ê
+.RB ( tmac
+¥Ç¥£¥ì¥¯¥È¥ê) ¤Ë³ÊǼ¤µ¤ì¤ë¡£
+.\" --------------------------------------------------------------------
+.\"O .SH NAMING
+.SH Ì¿Ì¾ÊýË¡
+.\" --------------------------------------------------------------------
+.\"O In classical roff systems, there was a funny naming scheme.
+.\"O If the name of a macro package started with
+.\"O .'char m
+.\"O this letter was omitted, e.g., the macro package for the man pages
+.\"O .I man
+.\"O was called
+.\"O .I an
+.\"O and its macro file
+.\"O .IR tmac.an .
+¸ÅŵŪ¤Ê roff ¥·¥¹¥Æ¥à¤Ç¤Ï¡¢´ñ̯¤Ê̿̾µ¬Â§¤¬ÍѤ¤¤é¤ì¤Æ¤¤¤¿¡£
+¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Î̾Á°¤¬
+.'char m
+¤Ç»Ï¤Þ¤ë¾ì¹ç¤Ï¡¢¤³¤Îʸ»ú¤Ï¾Êά¤µ¤ì¤¿¡£¤¿¤È¤¨¤Ð¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸
+.I man
+ÍѤΥޥ¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Ï
+.I an
+¤Ç¡¢¤½¤Î¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤Ï
+.I tmac.an
+¤È̿̾¤µ¤ì¤¿¡£
+.LP
+.\"O By a similar reasoning, macro packages that did not start with an
+.\"O .'char m
+.\"O were often referred to by adding an
+.\"O .'char m ,
+.\"O  e.g., the package corresponding to
+.\"O .I tmac.doc
+.\"O was called
+.\"O .I mdoc
+.\"O because the command-line for activating it reads
+Ʊ¤¸¤è¤¦¤ÊÍýͳ¤«¤é¡¢
+.'char m
+¤Ç»Ï¤Þ¤é¤Ê¤¤¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Ï¤·¤Ð¤·¤Ð
+.'char m
+¤òÄɲ䵤ì¤Æ¸Æ¤Ð¤ì¤¿¡£¤¿¤È¤¨¤Ð¡¢
+.I tmac.doc
+¤ËÂбþ¤¹¤ë¥Ñ¥Ã¥±¡¼¥¸¤Ï
+.I mdoc
+¤È¸Æ¤Ð¤ì¤¿¡£¤Ê¤¼¤Ê¤é¡¢¤³¤Î¥Þ¥¯¥í¤òÍѤ¤¤ë¤È¤­¤Î¥³¥Þ¥ó¥É¥é¥¤¥ó¤¬°Ê²¼¤Î¤è¤¦¤Ë
+Æɤá¤ë¤«¤é¤Ç¤¢¤ë¡£
+.RS
+.LP
+.\"O .BIR "troff\ \-m" doc .
+.BI "troff\ \-m" doc
+.RE
+.LP
+.\"O Actual versions of
+.\"O .BR groff (1)
+.\"O provide both naming schemes for the inflicted macro packages, with and
+.\"O without the leading
+.\"O .'char m .
+.\"O So in
+.\"O .IR groff ,
+.\"O the
+.\"O .I man
+.\"O macro package may be specified as
+.\"O .RS
+.\"O .LP
+.\"O .BIR "groff\ \-m\ " man ,
+.\"O .br
+.\"O .BIR "groff\ \-m" an ,
+.\"O .br
+.\"O .BIR "groff\ \-m" man , or
+.\"O .br
+.\"O .BIR "groff\ \-m " an .
+.\"O .RE
+.\"O .LP
+¸½¹Ô¥Ð¡¼¥¸¥ç¥ó¤Î
+.BR groff (1)
+¤Ç¤Ï¡¢»ÈÍѤ¹¤ë¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Î̿̾ÊýË¡¤ÏÀè¹Ô¤¹¤ë
+.'char m
+¤¬¤¢¤ë¾ì¹ç¡¦¤Ê¤¤¾ì¹ç¤ÎξÊý¤òÄ󶡤·¤Æ¤¤¤ë¡£
+¤·¤¿¤¬¤Ã¤Æ¡¢
+.I groff
+¤Ç¤Ï
+.I man
+¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Ï°Ê²¼¤Î¤è¤¦¤Ë»ØÄê¤Ç¤­¤ë¡£
+.RS
+.LP
+.BI "groff\ \-m\ " man
+.br
+.BI "groff\ \-m" an
+.br
+.BI "groff\ \-m" man
+.br
+.BI "groff\ \-m " an
+.RE
+.LP
+.\"O The easiest way to find out which macro packages are available on a
+.\"O system is to check the content of the
+.\"O .I tmac
+.\"O directories.
+.\"O For example, a file called
+.\"O .BI tmac. anything
+.\"O determines a macro package named
+.\"O .IR anything .
+¥·¥¹¥Æ¥à¾å¤ÇÍ­¸ú¤Ê¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤ò¸«¤Ä¤±¤ë¤â¤Ã¤È¤â´Êñ¤ÊÊýË¡¤Ï¡¢
+.I tmac
+¥Ç¥£¥ì¥¯¥È¥ê¤ÎÆâÍƤò¥Á¥§¥Ã¥¯¤¹¤ë¤³¤È¤Ç¤¢¤ë¡£
+¤¿¤È¤¨¤Ð¡¢
+.BI tmac. anything
+¤È¤¤¤¦¥Õ¥¡¥¤¥ë¤Ï
+.I anything
+¤È¤¤¤¦Ì¾Á°¤Î¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤òÄêµÁ¤·¤Æ¤¤¤ë¡£
+.LP
+.\"O In
+.\"O .IR groff ,
+.\"O most macro packages are described in man pages called
+.\"O .BR groff_<name> (7),
+.\"O with a leading
+.\"O .'char m
+.\"O for the classical packages.
+.I groff
+¤Ç¤Ï¡¢¤Û¤È¤ó¤É¤Î¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤¬
+.BR groff_<name> (7)
+¤È¤¤¤¦¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ÇÀâÌÀ¤µ¤ì¤Æ¤ª¤ê¡¢¸ÅŵŪ¤Ê¥Ñ¥Ã¥±¡¼¥¸¤â
+.'char m
+¤òÀè¹Ô¤·¤Æ¤¢¤ë¡£
+.\" --------------------------------------------------------------------
+.\"O .SH INCLUSION
+.SH ¥Þ¥¯¥í¤Î»ÈÍÑÊýË¡
+.\" --------------------------------------------------------------------
+.\"O There are several ways to use a macro package in documents.  At
+.\"O run-time, the groff option
+.\"O .option \-m \ \c
+.\"O .argument name
+.\"O makes the definitions in the macro file
+.\"O .BI tmac. name
+.\"O available as described in the section
+.\"O .BR NAMING .
+¥É¥­¥å¥á¥ó¥ÈÃæ¤Ç¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤ò»È¤¦ÊýË¡¤Ï¤¤¤¯¤Ä¤«¤¢¤ë¡£
+¼Â¹Ô»þ¤Î»ØÄêÊýË¡¤Ç¤Ï¡¢groff ¤Î ¥ª¥×¥·¥ç¥ó
+.option \-m \ \c
+.argument name
+¤Ç¡¢
+.B Ì¿Ì¾ÊýË¡
+¤Î¥»¥¯¥·¥ç¥ó¤Çµ­½Ò¤·¤¿¤è¤¦¤Ë¥Þ¥¯¥í¥Õ¥¡¥¤¥ë
+.BI tmac. name
+¤ÎÄêµÁ¤òÍ­¸ú¤Ë¤¹¤ë¡£
+.LP
+.\"O It is also possible to include the macro file into the document by using 
+.\"O the groff requests
+.\"O .request .so
+.\"O or
+.\"O .request .mso .
+.\"O For
+.\"O .request .so
+.\"O the full filename of the macro file must be specified \(em including the
+.\"O directory where it is kept.
+.\"O If the macro file is stored in one of the tmac directories it is more
+.\"O convenient to use
+.\"O .request .mso
+.\"O instead because it additionally searches the tmac path for the filename.
+groff ¤Î¥ê¥¯¥¨¥¹¥È
+.request .so
+¤ä
+.request .mso
+¤ò»È¤Ã¤Æ¥É¥­¥å¥á¥ó¥ÈÃæ¤Ç¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤ò»ØÄꤹ¤ë¤³¤È¤â¤Ç¤­¤ë¡£
+.request .so
+¤Ç¤Ï¡¢¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤Ï³ÊǼ¤µ¤ì¤Æ¤¤¤ë¥Ç¥£¥ì¥¯¥È¥ê¤â´Þ¤á¤¿´°Á´¤Ê¥Õ¥¡¥¤¥ë̾¤Ç
+»ØÄꤹ¤ëɬÍפ¬¤¢¤ë¡£
+¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤¬ tmac ¥Ç¥£¥ì¥¯¥È¥ê¤Î¤Ò¤È¤Ä¤Ë³ÊǼ¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢Âå¤ï¤ê¤Ë
+.request .mso
+¤ò»ÈÍѤ¹¤ëÊý¤¬ÊØÍø¤Ç¤¢¤ë¡£¤³¤Á¤é¤Ï¥Õ¥¡¥¤¥ë̾¤Ë tmac ¥Ñ¥¹¤òÄɲä·¤Æ
+¸¡º÷¤ò¤¹¤ë¡£
+.LP
+.\"O Note that in order to resolve the
+.\"O .request .so
+.\"O and
+.\"O .request .mso
+.\"O requests the roff preprocessor
+.\"O .shellcommand soelim
+.\"O must be called.  This can be done either directly by a pipeline on the
+.\"O command line or by using the
+.\"O .option \-s
+.\"O option of
+.\"O .shellcommand groff .
+.request .so
+¤È
+.request .mso
+¤Î¥ê¥¯¥¨¥¹¥È¤ò²ò·è¤¹¤ë¤¿¤á¤Ë roff ¤Î¥×¥ê¥×¥í¥»¥Ã¥µ
+.shellcommand soelim
+¤¬¸Æ¤Ó½Ð¤µ¤ì¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¤³¤È¤ËÃí°Õ¤¹¤ë¤³¤È¡£
+¤³¤ì¤Ï¡¢¥³¥Þ¥ó¥É¥é¥¤¥ó¾å¤Î¥Ñ¥¤¥×¥é¥¤¥ó¤ÇľÀܼ¹Ԥ¹¤ëÊýË¡¤È¡¢
+.shellcommand groff
+¤Î
+.option \-s
+¥ª¥×¥·¥ç¥ó¤ò»È¤Ã¤Æ¸Æ¤Ó½Ð¤¹ÊýË¡¤Î¤É¤Á¤é¤Ç¤â²Äǽ¤Ç¤¢¤ë¡£
+.LP
+.\"O You can also supply the letter
+.\"O .'char s
+.\"O in the preprocessor word as described in section
+.\"O .BR CONVENTION .
+.B µ¬Äê
+¤Î¥»¥¯¥·¥ç¥ó¤Çµ­½Ò¤·¤Æ¤¢¤ë¤è¤¦¤Ë¡¢¥×¥ê¥×¥í¥»¥Ã¥µ»ØÄê»Ò¤Îʸ»ú
+.'char s
+¤Ç»ØÄꤹ¤ë¤³¤È¤â¤Ç¤­¤ë¡£
+.LP
+.\"O For example, suppose a macro file is stored as
+.\"O .I /usr/share/groff/tmac/tmac.macros
+.\"O and is used in some document called
+.\"O .IR docu.roff .
+¤¿¤È¤¨¤Ð¡¢¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤¬
+.I /usr/share/groff/tmac/tmac.macros
+¤Ë³ÊǼ¤µ¤ì¤Æ¤¤¤Æ¡¢
+.I docu.roff
+¤È¤¤¤¦¥É¥­¥å¥á¥ó¥È¤Ç»ÈÍѤ¹¤ë¤È²¾Äꤹ¤ë¡£
+.LP
+.\"O At run-time, the formatter call for this is
+¼Â¹Ô»þ¤Ç¤Ï¡¢¥Õ¥©¡¼¥Þ¥Ã¥¿¤Î¸Æ¤Ó½Ð¤·ÊýË¡¤Ï°Ê²¼¤Î¤è¤¦¤Ë¤Ê¤ë¡£
+.RS
+.LP
+.ft CR
+.shellcommand "groff\ \-m"
+.argument macros
+.argument docu.roff
+.ft P
+.RE
+.LP
+.\"O To include the macro file directly in the document either
+¥É¥­¥å¥á¥ó¥ÈÃæ¤Ç¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤òľÀÜ»ØÄꤹ¤ë¤Ë¤Ï¡¢
+.RS
+.ft CR
+\&\.mso tmac.macros
+.ft P
+.RE
+.\"O is used or
+¤òÍѤ¤¤ë¤«¡¢
+.RS
+.ft CR
+\&\.so /usr/share/groff/tmac/tmac.macros
+.ft P
+.RE
+¤È»ØÄꤹ¤ë¡£
+.LP
+.\"O In both cases, the formatter is called with
+¤É¤Á¤é¤Î¾ì¹ç¤Ç¤â¡¢¥Õ¥©¡¼¥Þ¥Ã¥¿¤ò
+.ft CR
+.RS
+groff\ \-s docu.roff
+.RE
+.ft P
+¤Î¤è¤¦¤Ë¤·¤Æ¸Æ¤Ó½Ð¤¹¡£
+.
+.\" --------------------------------------------------------------------
+.\"O .SH CONVENTION
+.SH µ¬Äê
+.\" --------------------------------------------------------------------
+.LP
+.\"O There is a convention that is supported by many modern roff
+.\"O type-setters: the
+.\"O .B preprocessor word
+.\"O described in the following.
+ºÇ¶á¤Î¿¤¯¤Î roff À°·Á¥·¥¹¥Æ¥à¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë
+.B ¥×¥ê¥×¥í¥»¥Ã¥µ»ØÄê»Ò
+¤Îµ¬Äê¤Ë¤Ä¤¤¤Æ°Ê²¼¤Ëµ­½Ò¤¹¤ë¡£
+.LP
+.\"O If the first line in a document is a comment, the first word (after the
+.\"O comment characters and a blank) constitutes the
+.\"O .B preprocessor
+.\"O .BR word .
+¥É¥­¥å¥á¥ó¥È¤ÎÀèƬ¹Ô¤¬¥³¥á¥ó¥È¤Î¾ì¹ç¤Ï¡¢¥³¥á¥ó¥Èʸ»ú¤È¶õÇò¤Ë³¤¯ºÇ½é¤Î
+ʸ»ú¤Ï
+.B ¥×¥ê¥×¥í¥»¥Ã¥µ»ØÄê»Ò
+¤ò¹½À®¤¹¤ë¡£
+.\"O That means that the letters of this word are interpreted as
+.\"O abbreviations for those preprocessor commands that should be run
+.\"O when formatting the document.  Mostly, only the letters corresponding to 
+.\"O the options for the preprocessors are recognized, 
+.\"O .'char e ,
+.\"O .'char G ,
+.\"O .'char g ,
+.\"O .'char p ,
+.\"O .'char R ,
+.\"O .'char s , and
+.\"O .'char t
+.\"O (see
+.\"O .BR roff (7)).
+¤Ä¤Þ¤ê¡¢¤³¤ì¤é¤Îʸ»ú¤Ï¥É¥­¥å¥á¥ó¥È¤òÀ°·Á¤¹¤ë¤È¤­¤Ëµ¯Æ°¤µ¤ì¤ë
+¥×¥ê¥×¥í¥»¥Ã¥µ¥³¥Þ¥ó¥É¤Î¾Êά·Á¤È¤ß¤Ê¤µ¤ì¤ë¡£
+¤¿¤¤¤Æ¤¤¤Ï¡¢¥×¥ê¥×¥í¥»¥Ã¥µ¤Î¸Æ¤Ó½Ð¤·¥ª¥×¥·¥ç¥ó¤È°ìÃפ¹¤ëʸ»ú¤À¤±¤¬Ç§¼±¤µ¤ì¡¢
+°Ê²¼¤Î¤â¤Î¤¬¤¢¤ë¡£
+.'char e ,
+.'char G ,
+.'char g ,
+.'char p ,
+.'char R ,
+.'char s ,
+.'char t
+.RB ( roff (7)
+¤ò»²¾È¤Î¤³¤È)
+.LP
+.\"O Besides being a good reminder for the user, some formatters (like the
+.\"O .BR man (1)
+.\"O program) are even able to automatically start the preprocessors
+.\"O specified in the preprocessor word, but do not bet on this.
+¥æ¡¼¥¶¤ËÎɤ­½õ¸À¤òÍ¿¤¨¤ë¤Ê¤é¤Ð¡¢¤¤¤¯¤Ä¤«¤Î¥Õ¥©¡¼¥Þ¥Ã¥¿ (¤¿¤È¤¨¤Ð
+.BR man (1)
+¥×¥í¥°¥é¥à¤Ê¤É) ¤â¥×¥ê¥×¥í¥»¥Ã¥µ»ØÄê»Ò¤Ë¤è¤Ã¤Æ»ØÄꤵ¤ì¤¿¥×¥ê¥×¥í¥»¥Ã¥µ¤ò
+¼«Æ°Åª¤Ëµ¯Æ°¤¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£¤·¤«¤·¡¢¤½¤ÎÆ°ºî¤ò´üÂÔ¤¹¤ë¤Ù¤­¤Ç¤Ï¤Ê¤¤¡£
+.\" --------------------------------------------------------------------
+.\"O .SH "WRITING A MACRO FILE"
+.SH ¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤Îµ­½ÒÊýË¡
+.\" --------------------------------------------------------------------
+.\"O Writing a groff macro file is easy.  Design a set of macros, strings,
+.\"O registers, etc.  Store them in a single file.  Documents that use the
+.\"O macros include this macro file with the
+.\"O .request .so
+.\"O request as described in the
+.\"O .B INCLUSION
+.\"O section.
+groff ¤Î¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤òµ­½Ò¤¹¤ë¤³¤È¤Ï´Êñ¤Ç¤¢¤ë¡£
+°ìÏ¢¤Î¥Þ¥¯¥í¡¢Ê¸»úÎ󡢥쥸¥¹¥¿¤Ê¤É¤ò¥Ç¥¶¥¤¥ó¤·¡¢¤½¤ì¤é¤ò¤Ò¤È¤Ä¤Î¥Õ¥¡¥¤¥ë¤Ë
+³ÊǼ¤¹¤ë¡£¤³¤Î¥Þ¥¯¥í¤òÍѤ¤¤ë¥É¥­¥å¥á¥ó¥È¤Ç
+.request .so
+¥ê¥¯¥¨¥¹¥È¤Ë¤è¤Ã¤Æ¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤ò»ØÄꤹ¤ëÊýË¡¤Ï
+.B ¥Þ¥¯¥í¤Î»ÈÍÑÊýË¡
+¤Î¥»¥¯¥·¥ç¥ó¤Ëµ­½Ò¤·¤Æ¤¢¤ë¡£
+.LP
+.\"O To use the tmac functionality, call the macro file
+.\"O .BI tmac. whatever
+.\"O and put it in some directory of the tmac path, cf. section
+.\"O .BR FILES .
+.\"O Then documents can include it with the
+.\"O .request .mso
+.\"O request or the
+.\"O .shellcommand "groff\ \-m"
+.\"O option as described in the
+.\"O .B INCLUSION
+.\"O section.
+tmac ¤Îµ¡Ç½¤òÍѤ¤¤ë¤Ë¤Ï¡¢¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤ò
+.BI tmac. whatever
+¤Î¤è¤¦¤Ë̿̾¤·¤Æ tmac ¥Ñ¥¹¤Ç»ØÄꤵ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥ê¤Ë³ÊǼ¤¹¤ë
+.RB ( ¥Õ¥¡¥¤¥ë
+¤Î¥»¥¯¥·¥ç¥ó¤ò»²¾È)¡£
+¤½¤·¤Æ¡¢¥É¥­¥å¥á¥ó¥È¤Ç¤Ï
+.B ¥Þ¥¯¥í¤Î»ÈÍÑÊýË¡
+¤Î¥»¥¯¥·¥ç¥ó¤Çµ­½Ò¤·¤Æ¤¢¤ë¤è¤¦¤Ë¡¢
+.request .mso
+¥ê¥¯¥¨¥¹¥È¤ä
+.shellcommand "groff\ \-m"
+¥ª¥×¥·¥ç¥ó¤Ë¤è¤Ã¤Æ¤½¤Î¥Þ¥¯¥í¤ò»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
+.LP
+.\"O If your macros might be of general usage contact the groff maintainers
+.\"O to have them included in the groff
+.\"O .I contrib
+.\"O source directory.
+¤â¤·¤¢¤Ê¤¿¤Î¥Þ¥¯¥í¤¬°ìÈÌŪ¤ÊÍÑÅӤ˸þ¤¤¤Æ¤¤¤ë¤Ê¤é¤Ð¡¢groff ¤Î¥á¥ó¥Æ¥Ê¤Ë
+Ï¢Íí¤ò¤È¤Ã¤Æ groff ¤Î
+.I contrib
+¥½¡¼¥¹¥Ç¥£¥ì¥¯¥È¥ê¤Ë¤½¤ì¤é¤ò´Þ¤á¤ë¤è¤¦¤Ë¤·¤Æ¤Û¤·¤¤¡£
+.LP
+.\"O Some general guidelines might be helpful in writing macros.
+¥Þ¥¯¥í¤Îµ­½Ò¤Ë¤Ï¡¢°ìÈÌŪ¤Ê¥¬¥¤¥É¥é¥¤¥ó¤Î¤¤¤¯¤Ä¤«¤¬Ìò¤ËΩ¤Ä¤À¤í¤¦¡£
+.IP \(bu 2m
+.\"O Double all functional backslashes,
+µ¡Ç½Åª¤Ê¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¤Ï¤¹¤Ù¤ÆÆó½Å¤Ë¤¹¤ë¡£
+.'char \e
+->
+.\"O .'char \e\e .
+.'char \e\e
+.IP \(bu 2m
+.\"O All printable backslashes must be written as
+.\"O .'char \ee .
+ɽ¼¨¤¹¤ë¤¿¤á¤Î¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¤Ï¼¡¤Î¤è¤¦¤Ëµ­½Ò¤¹¤ë¡£
+.'char \ee
+.IP \(bu 2m
+.\"O Escape all dots,
+¥É¥Ã¥È¤Ï¤¹¤Ù¤Æ¥¨¥¹¥±¡¼¥×¤¹¤ë¡£
+.'char .
+->
+.\"O .'char \e. .
+.'char \e.
+.IP \(bu 2m
+.\"O Make ample use of the non-printable character
+.\"O .'char \e&
+.\"O in text parts, esp. before
+.\"O .'char \e
+.\"O and at the beginning of a line, but not before a delayed command.
+¥Æ¥­¥¹¥ÈÉôʬ¤Ë¤ÏÈóɽ¼¨Ê¸»ú¤Ç¤¢¤ë
+.'char \e&
+¤ò
+.'char \e
+¤ÎÁ°¤È¹Ô¤ÎÀèƬ¤Ë¹­¤¯ÍѤ¤¤ë¤è¤¦¤Ë¤¹¤ë¡£¤¿¤À¤·¸å¤Ë³¤¯¥³¥Þ¥ó¥É¤¬¤¢¤ë¾ì¹ç¤Ï
+¤³¤Î¸Â¤ê¤Ç¤Ï¤Ê¤¤¡£
+.IP \(bu 2m
+.\"O Use the character
+.\"O .'char @
+.\"O in temporary variable names.
+°ì»þŪ¤ÊÊÑ¿ô̾¤Ë¤Ïʸ»ú
+.'char @
+¤òÍѤ¤¤ë¡£
+.IP \(bu 2m
+.\"O Test your macros for text and graphical devices, e.g.,
+.\"O .I latin1
+.\"O and
+.\"O .IR ps .
+¥Þ¥¯¥í¤Ï¥Æ¥­¥¹¥È¤È¥°¥é¥Õ¥£¥Ã¥¯¤Î¥Ç¥Ð¥¤¥¹¤Ç¥Æ¥¹¥È¤¹¤ë¡£¤¿¤È¤¨¤Ð
+.I latin1
+¤È
+.I ps
+¤Ê¤É¡£
+.\" --------------------------------------------------------------------
+.\"O .SH FILES
+.SH ¥Õ¥¡¥¤¥ë
+.\" --------------------------------------------------------------------
+.\"O All macro names that want to use the tmac mechanism must be named
+.\"O according to the form
+.\"O .BIR tmac. name .
+tmac ¤Î¥á¥«¥Ë¥º¥à¤ÇÍѤ¤¤è¤¦¤È¤¹¤ë¥Þ¥¯¥í¤Î̾Á°¤Ï
+.BI tmac. name
+¤È¤¤¤¦·Á¼°¤Ç̿̾¤µ¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+.LP
+.\"O The macro files are kept in the
+.\"O .B tmac
+.\"O .BR directories ,
+.\"O all of which constitue the
+.\"O .B tmac
+.\"O .BR path.
+¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤Ï
+.B "tmac ¥Ñ¥¹"
+¤ò¹½À®¤¹¤ë
+.B "tmac ¥Ç¥£¥ì¥¯¥È¥ê"
+¤Ë³ÊǼ¤µ¤ì¤ë¡£
+.\"O In accordance with the Filesystem Hierarchy Standard (FHS), the standard
+.\"O tmac directory location for groff is
+.\"O .IR /usr/share/groff/tmac ,
+.\"O a local installation will use
+.\"O .IR /usr/local/share/groff/tmac .
+Filesystem Hierarchy Standard (FHS) ¤Ë½àµò¤·¤Æ¤¤¤ì¤Ð¡¢
+groff ¤Îɸ½àŪ¤Ê tmac ¥Ç¥£¥ì¥¯¥È¥ê¤Î¾ì½ê¤Ï
+.I /usr/share/groff/tmac
+¤Ç¤¢¤ê¡¢¥í¡¼¥«¥ë¤ÊƳÆþÀè¤Ï
+.I /usr/local/share/groff/tmac
+¤¬ÍѤ¤¤é¤ì¤ë¤À¤í¤¦¡£
+.\"O Older systems used a subdirectory of
+.\"O .IR /usr/lib .
+¸Å¤¤¥·¥¹¥Æ¥à¤Ë¤ª¤¤¤Æ¤Ï¡¢
+.I /usr/lib
+°Ê²¼¤Î¥µ¥Ö¥Ç¥£¥ì¥¯¥È¥ê¤ò»ÈÍѤ·¤Æ¤¤¤¿¡£
+.\"O Independently of the default tmac path, the tmac path actually used by a
+.\"O document can always be set by a shell environment variable, cf. section
+.\"O .BR ENVIRONMENT .
+¥Ç¥Õ¥©¥ë¥È¤Î tmac ¥Ñ¥¹¤È¤ÏÆÈΩ¤·¤Æ¡¢¼ÂºÝ¤Ë¥É¥­¥å¥á¥ó¥È¤ÇÍѤ¤¤é¤ì¤ë
+tmac ¥Ñ¥¹¤Ï¾ï¤Ë¥·¥§¥ë´Ä¶­ÊÑ¿ô¤Ç»ØÄꤹ¤ë¤³¤È¤¬¤Ç¤­¤ë¡£¥»¥¯¥·¥ç¥ó
+.B ´Ä¶­ÊÑ¿ô
+¤ò»²¾È¤Î¤³¤È¡£
+.\" --------------------------------------------------------------------
+.\"O .SH ENVIRONMENT
+.SH ´Ä¶­ÊÑ¿ô
+.\" --------------------------------------------------------------------
+.TP
+.B GROFF_TMAC_PATH
+.\"O A colon separated list of tmac directories in which to search for macro
+.\"O files, the
+.\"O .B tmac
+.\"O .BR path .
+.\"O If unset a default path is used as is outlined in the
+.\"O .B FILES
+.\"O section.
+¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤ò¸¡º÷¤¹¤ë¤¿¤á¤Î tmac ¥Ç¥£¥ì¥¯¥È¥ê
+.RB ( "tmac ¥Ñ¥¹" )
+¤ò¥³¥í¥ó¤Ç¶èÀڤ俥ꥹ¥È¡£
+»ØÄꤵ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ï¡¢
+.B ¥Õ¥¡¥¤¥ë
+¤Î¥»¥¯¥·¥ç¥ó¤Ç¼¨¤·¤¿¥Ç¥Õ¥©¥ë¥È¤Î¥Ñ¥¹¤¬»ÈÍѤµ¤ì¤ë¡£
+.\" --------------------------------------------------------------------
+.\"O .SH BUGS
+.SH ¥Ð¥°
+.\" --------------------------------------------------------------------
+.\"O The groff documentation is in evolution at the moment.  It is possible
+.\"O that small inconsistencies between different documents exist
+.\"O temporarily.
+¸½ºß¡¢groff ¥·¥¹¥Æ¥à¤Î¥É¥­¥å¥á¥ó¥È¤Ï¿Ê²½¤ÎÅÓ¾å¤Ë¤¢¤ë¡£
+°ì»þŪ¤Ë¥É¥­¥å¥á¥ó¥ÈƱ»Î¤Ç¤µ¤µ¤ä¤«¤ÊÌ·½âÅÀ¤¬¸«¤é¤ì¤ë¤À¤í¤¦¡£
+.\" --------------------------------------------------------------------
+.\"O .SH AUTHOR
+.SH Ãø¼Ô
+.\" --------------------------------------------------------------------
+.\"O This document is part of groff, the GNU roff distribution.  It was
+.\"O written by Bernd Warken <bwarken@mayn.de>.
+¤³¤Î¥É¥­¥å¥á¥ó¥È¤Ï groff (GNU roff ¥Ñ¥Ã¥±¡¼¥¸) ¤Î°ìÉô¤Ç¤¢¤ë¡£
+Bernd Warken <bwarken@mayn.de> ¤Ë¤è¤Ã¤Æµ­½Ò¤µ¤ì¤¿¡£
+.LP
+.\"O It is distributed under the terms of the FDL (GNU Free Documentation
+.\"O License) version 1.1 or later.  You should have received a copy of the
+.\"O FDL on your system, it is also available on-line under
+¤³¤Î¥É¥­¥å¥á¥ó¥È¤Ï FDL (GNU Free Documentation License) ¤Î¥Ð¡¼¥¸¥ç¥ó 1.1 
+°Ê¹ß¤Î¸µ¤ËÇÛÉÛ¤µ¤ì¤ë¡£¤¢¤Ê¤¿¤Î¥·¥¹¥Æ¥à¤Ë¤â FDL ¤Î¥³¥Ô¡¼¤¬¤¢¤ë¤Ï¤º¤Ç¤¢¤ë¡£
+°Ê²¼¤Ç¤â¥ª¥ó¥é¥¤¥ó¤Ç»²¾È¤Ç¤­¤ë¡£
+.RS
+.LP
+.IR <http://www.gnu.org/copyleft/fdl.html> .
+.RE
+.\" --------------------------------------------------------------------
+.\"O .SH "SEE ALSO"
+.SH ´ØÏ¢¹àÌÜ
+.\" --------------------------------------------------------------------
+.\"O The authoritative source of information for all details of the groff
+.\"O system is the groff
+.\"O .BR info (1)
+.\"O file.
+groff ¥·¥¹¥Æ¥à¤Î¾ÜºÙ¤Ë¤Ä¤¤¤Æ¡¢¿®¤º¤Ù¤­¾ðÊ󸻤ϡ¢groff ¤Î
+.BR info (1)
+¥Õ¥¡¥¤¥ë¤Ç¤¢¤ë¡£
+.LP
+.\"O For a groff overview, see
+.\"O .BR roff (7)
+.\"O and the file
+.\"O .I README
+.\"O in the groff source package.
+groff ¤Î³µÍפˤĤ¤¤Æ¤Ï
+.BR roff (7)
+¤È groff ¥½¡¼¥¹¥Ñ¥Ã¥±¡¼¥¸¤Î
+.I README
+¥Õ¥¡¥¤¥ë¤ò»²¾È¤Î¤³¤È¡£
+.LP
+.\"O The groff tmac macro packages are
+.\"O .BR groff_man (7),
+.\"O .BR groff_markup (7),
+.\"O .BR groff_mdoc (7),
+.\"O .BR groff_mdoc.samples (7),
+.\"O .BR groff_me (7),
+.\"O .BR groff_mm (7),
+.\"O .BR groff_mmroff (7),
+.\"O .BR groff_ms (7),
+.\"O .BR groff_msafer (7).
+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
+.\"O The groff language is described in
+.\"O .BR groff (7)
+.\"O and the formatters in
+.\"O .BR groff (1),
+.\"O .BR troff (1).
+groff ¸À¸ì¤Ë¤Ä¤¤¤Æ¤Ï
+.BR groff (7)
+¤Ë¡¢¥Õ¥©¡¼¥Þ¥Ã¥¿¤Ë¤Ä¤¤¤Æ¤Ï
+.BR groff "(1) ¤È"
+.BR troff (1)
+¤Ëµ­½Ò¤µ¤ì¤Æ¤¤¤ë¡£
+.LP
+.\"O The Filesystem Hierarchy Standard (FHS) is available at
+.\"O .BR http://www.pathname.com/fhs/ .
+.\"O 
+Filesystem Hierarchy Standard (FHS) ¤Ë¤Ä¤¤¤Æ¤Ï
+.B http://www.pathname.com/fhs/
+¤ò»²¾È¤Î¤³¤È¡£
+
+