manual/GNU_groff/draft/man5/groff_tmac.5

   1 .\"                        -*- nroff -*-
   2 .ig /
   3 groff_tmac.5
   4
   5 This file is part of groff, the GNU roff type-setting system.
   6
   7 Copyright (C) 2000 Free Software Foundation, Inc.
   8 written by Bernd Warken <bwarken@mayn.de>
   9
  10 Last update: 17 May 2000
  11
  12 Permission is granted to copy, distribute and/or modify this document
  13 under the terms of the GNU Free Documentation License, Version 1.1 or
  14 any later version published by the Free Software Foundation; with the
  15 Invariant Sections being this .ig-section and AUTHOR, with no
  16 Front-Cover Texts, and with no Back-Cover Texts.
  17
  18 A copy of the Free Documentation License is included as a file called
  19 FDL in the main directory of the groff source package.
  20 ./
  21 .\" Japanese Version Copyright (c) 2001 UCHIDA Norihiro all rights reserved.
  22 .\" Translated Mon Mar 12 2001 by UCHIDA Norihiro <KY4N-UCD@asahi-net.or.jp>
  23 .\" --------------------------------------------------------------------
  24 .\" Setup
  25 .\" --------------------------------------------------------------------
  26 .
  27 .if n \{\
  28 .  mso tmac.tty-char
  29 .  ftr CR R
  30 .  ftr CI I
  31 .  ftr CB B
  32 .\}
  33 .
  34 .\" text lines in macro definitions or bracketed sections \{...\}
  35 .de text
  36 .  if 1 \&\\$*\&
  37 ..
  38 .
  39 .de BIR
  40 .  ie (\\n[.$] < 3) \
  41 .    BI $@
  42 .  el \{\
  43 .    ds @tmp@ \fB\\$1\fP\fI\\$2\fP
  44 .    shift 2
  45 .    text \\*[@tmp@]\fR\\$*\fP
  46 .    rm @tmp@
  47 .  \}
  48 ..
  49 .
  50 .de 'char
  51 .  ds @tmp@ `\f(CB\\$1\fP'
  52 .  shift
  53 .  text \\*[@tmp@]\\$*
  54 .  rm @tmp@
  55 ..
  56 .
  57 .de option
  58 .  ds @tmp@ \f(CB\\$1\fP
  59 .  shift 1
  60 .  text \\*[@tmp@]\\$*
  61 .  rm @tmp@
  62 ..
  63 .
  64 .als shellcommand option
  65 .
  66 .de argument
  67 .  ds @tmp@ \f(CI\\$1\fP
  68 .  shift 1
  69 .  text \\*[@tmp@]\\$*
  70 .  rm @tmp@
  71 ..
  72 .
  73 .de request
  74 .  ds @tmp@ \f(CB\\$1\fP
  75 .  shift 1
  76 .  text \\*[@tmp@]\\$*
  77 .  rm @tmp@
  78 ..
  79 .
  80 .\" --------------------------------------------------------------------
  81 .\" Title
  82 .\" --------------------------------------------------------------------
  83 .TH GROFF_TMAC 5 "22 May 2000" "Groff Version 1.16.1"
  84 .\"O .SH NAME
  85 .SH Ì¾Á°
  86 .\"O groff_tmac \- macro files in the roff typesetting system
  87 groff_tmac \- roff ¥Æ¥¥¹¥ÈÀ°·Á¥·¥¹¥Æ¥à¤Î¥Þ¥¯¥í¥Õ¥¡¥¤¥ë
  88 .\" --------------------------------------------------------------------
  89 .\"O .SH DESCRIPTION
  90 .SH ÀâÌÀ
  91 .\" --------------------------------------------------------------------
  92 .\"O The
  93 .\"O .BR roff (7)
  94 .\"O type-setting system provides a set of macro packages suitable for
  95 .\"O special kinds of documents.  Each macro package stores its macros and
  96 .\"O definitions in a file called the package's
  97 .\"O .BR "tmac file" .
  98 .\"O The name is deduced from
  99 .\"O .RB ` T roff
 100 .\"O .BR MAC ros'.
 101 .BR roff (7)
 102 ¥Æ¥¥¹¥ÈÀ°·Á¥·¥¹¥Æ¥à¤Ï¡¢ÆÃÄê¤Î¥É¥¥å¥á¥ó¥È¤Ë¤È¤Ã¤ÆÊØÍø¤Ê¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤ò
 103 Äó¶¡¤·¤Æ¤¤¤ë¡£¤½¤ì¤¾¤ì¤Î¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Ï¥Ñ¥Ã¥±¡¼¥¸¤´¤È¤Î
 104 .B tmac ¥Õ¥¡¥¤¥ë
 105 ¤È¸Æ¤Ð¤ì¤ë¥Õ¥¡¥¤¥ë¤Ë¥Þ¥¯¥í¤ÈÄêµÁ¤ò³ÊÇ¼¤·¤Æ¤¤¤ë¡£
 106 ¤³¤ÎÌ¾Á°¤Ï
 107 .RB ` T roff
 108 .BR MAC ros'
 109 ¤ËÍ³Íè¤¹¤ë¡£
 110 .LP
 111 .\"O The tmac files are normal roff source documents, except that they
 112 .\"O usually contain only definitions and setup commands, but no text.  All
 113 .\"O tmac files are kept in a single or a small number of directories, the
 114 .\"O .B tmac
 115 .\"O directories.
 116 tmac ¥Õ¥¡¥¤¥ë¤ÏÉáÄÌ¤Î roff ¤Î¥½¡¼¥¹¥É¥¥å¥á¥ó¥È¤Ç¡¢ÄÌ¾ï¤ÏÄêµÁ¤È¥»¥Ã¥È¥¢¥Ã¥×
 117 ¥³¥Þ¥ó¥É¤À¤±¤ò´Þ¤ß¡¢¥Æ¥¥¹¥È¤Ï´Þ¤Þ¤ì¤Ê¤¤¡£
 118 ¤¹¤Ù¤Æ¤Î tmac ¥Õ¥¡¥¤¥ë¤Ï¡¢¤Ò¤È¤Ä¤¢¤ë¤¤¤Ï¤¤¤¯¤Ä¤«¤Î¥Ç¥£¥ì¥¯¥È¥ê
 119 .RB ( tmac
 120 ¥Ç¥£¥ì¥¯¥È¥ê) ¤Ë³ÊÇ¼¤µ¤ì¤ë¡£
 121 .\" --------------------------------------------------------------------
 122 .\"O .SH NAMING
 123 .SH Ì¿Ì¾ÊýË¡
 124 .\" --------------------------------------------------------------------
 125 .\"O In classical roff systems, there was a funny naming scheme.
 126 .\"O If the name of a macro package started with
 127 .\"O .'char m
 128 .\"O this letter was omitted, e.g., the macro package for the man pages
 129 .\"O .I man
 130 .\"O was called
 131 .\"O .I an
 132 .\"O and its macro file
 133 .\"O .IR tmac.an .
 134 ¸ÅÅµÅª¤Ê roff ¥·¥¹¥Æ¥à¤Ç¤Ï¡¢´ñÌ¯¤ÊÌ¿Ì¾µ¬Â§¤¬ÍÑ¤¤¤é¤ì¤Æ¤¤¤¿¡£
 135 ¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤ÎÌ¾Á°¤¬
 136 .'char m
 137 ¤Ç»Ï¤Þ¤ë¾ì¹ç¤Ï¡¢¤³¤ÎÊ¸»ú¤Ï¾ÊÎ¬¤µ¤ì¤¿¡£¤¿¤È¤¨¤Ð¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸
 138 .I man
 139 ÍÑ¤Î¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Ï
 140 .I an
 141 ¤Ç¡¢¤½¤Î¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤Ï
 142 .I tmac.an
 143 ¤ÈÌ¿Ì¾¤µ¤ì¤¿¡£
 144 .LP
 145 .\"O By a similar reasoning, macro packages that did not start with an
 146 .\"O .'char m
 147 .\"O were often referred to by adding an
 148 .\"O .'char m ,
 149 .\"O  e.g., the package corresponding to
 150 .\"O .I tmac.doc
 151 .\"O was called
 152 .\"O .I mdoc
 153 .\"O because the command-line for activating it reads
 154 Æ±¤¸¤è¤¦¤ÊÍýÍ³¤«¤é¡¢
 155 .'char m
 156 ¤Ç»Ï¤Þ¤é¤Ê¤¤¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Ï¤·¤Ð¤·¤Ð
 157 .'char m
 158 ¤òÄÉ²Ã¤µ¤ì¤Æ¸Æ¤Ð¤ì¤¿¡£¤¿¤È¤¨¤Ð¡¢
 159 .I tmac.doc
 160 ¤ËÂÐ±þ¤¹¤ë¥Ñ¥Ã¥±¡¼¥¸¤Ï
 161 .I mdoc
 162 ¤È¸Æ¤Ð¤ì¤¿¡£¤Ê¤¼¤Ê¤é¡¢¤³¤Î¥Þ¥¯¥í¤òÍÑ¤¤¤ë¤È¤¤Î¥³¥Þ¥ó¥É¥é¥¤¥ó¤¬°Ê²¼¤Î¤è¤¦¤Ë
 163 ÆÉ¤á¤ë¤«¤é¤Ç¤¢¤ë¡£
 164 .RS
 165 .LP
 166 .\"O .BIR "troff\ \-m" doc .
 167 .BI "troff\ \-m" doc
 168 .RE
 169 .LP
 170 .\"O Actual versions of
 171 .\"O .BR groff (1)
 172 .\"O provide both naming schemes for the inflicted macro packages, with and
 173 .\"O without the leading
 174 .\"O .'char m .
 175 .\"O So in
 176 .\"O .IR groff ,
 177 .\"O the
 178 .\"O .I man
 179 .\"O macro package may be specified as
 180 .\"O .RS
 181 .\"O .LP
 182 .\"O .BIR "groff\ \-m\ " man ,
 183 .\"O .br
 184 .\"O .BIR "groff\ \-m" an ,
 185 .\"O .br
 186 .\"O .BIR "groff\ \-m" man , or
 187 .\"O .br
 188 .\"O .BIR "groff\ \-m " an .
 189 .\"O .RE
 190 .\"O .LP
 191 ¸½¹Ô¥Ð¡¼¥¸¥ç¥ó¤Î
 192 .BR groff (1)
 193 ¤Ç¤Ï¡¢»ÈÍÑ¤¹¤ë¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤ÎÌ¿Ì¾ÊýË¡¤ÏÀè¹Ô¤¹¤ë
 194 .'char m
 195 ¤¬¤¢¤ë¾ì¹ç¡¦¤Ê¤¤¾ì¹ç¤ÎÎ¾Êý¤òÄó¶¡¤·¤Æ¤¤¤ë¡£
 196 ¤·¤¿¤¬¤Ã¤Æ¡¢
 197 .I groff
 198 ¤Ç¤Ï
 199 .I man
 200 ¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Ï°Ê²¼¤Î¤è¤¦¤Ë»ØÄê¤Ç¤¤ë¡£
 201 .RS
 202 .LP
 203 .BI "groff\ \-m\ " man
 204 .br
 205 .BI "groff\ \-m" an
 206 .br
 207 .BI "groff\ \-m" man
 208 .br
 209 .BI "groff\ \-m " an
 210 .RE
 211 .LP
 212 .\"O The easiest way to find out which macro packages are available on a
 213 .\"O system is to check the content of the
 214 .\"O .I tmac
 215 .\"O directories.
 216 .\"O For example, a file called
 217 .\"O .BI tmac. anything
 218 .\"O determines a macro package named
 219 .\"O .IR anything .
 220 ¥·¥¹¥Æ¥à¾å¤ÇÍ¸ú¤Ê¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤ò¸«¤Ä¤±¤ë¤â¤Ã¤È¤â´ÊÃ±¤ÊÊýË¡¤Ï¡¢
 221 .I tmac
 222 ¥Ç¥£¥ì¥¯¥È¥ê¤ÎÆâÍÆ¤ò¥Á¥§¥Ã¥¯¤¹¤ë¤³¤È¤Ç¤¢¤ë¡£
 223 ¤¿¤È¤¨¤Ð¡¢
 224 .BI tmac. anything
 225 ¤È¤¤¤¦¥Õ¥¡¥¤¥ë¤Ï
 226 .I anything
 227 ¤È¤¤¤¦Ì¾Á°¤Î¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤òÄêµÁ¤·¤Æ¤¤¤ë¡£
 228 .LP
 229 .\"O In
 230 .\"O .IR groff ,
 231 .\"O most macro packages are described in man pages called
 232 .\"O .BR groff_<name> (7),
 233 .\"O with a leading
 234 .\"O .'char m
 235 .\"O for the classical packages.
 236 .I groff
 237 ¤Ç¤Ï¡¢¤Û¤È¤ó¤É¤Î¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤¬
 238 .BR groff_<name> (7)
 239 ¤È¤¤¤¦¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ÇÀâÌÀ¤µ¤ì¤Æ¤ª¤ê¡¢¸ÅÅµÅª¤Ê¥Ñ¥Ã¥±¡¼¥¸¤â
 240 .'char m
 241 ¤òÀè¹Ô¤·¤Æ¤¢¤ë¡£
 242 .\" --------------------------------------------------------------------
 243 .\"O .SH INCLUSION
 244 .SH ¥Þ¥¯¥í¤Î»ÈÍÑÊýË¡
 245 .\" --------------------------------------------------------------------
 246 .\"O There are several ways to use a macro package in documents.  At
 247 .\"O run-time, the groff option
 248 .\"O .option \-m \ \c
 249 .\"O .argument name
 250 .\"O makes the definitions in the macro file
 251 .\"O .BI tmac. name
 252 .\"O available as described in the section
 253 .\"O .BR NAMING .
 254 ¥É¥¥å¥á¥ó¥ÈÃæ¤Ç¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤ò»È¤¦ÊýË¡¤Ï¤¤¤¯¤Ä¤«¤¢¤ë¡£
 255 ¼Â¹Ô»þ¤Î»ØÄêÊýË¡¤Ç¤Ï¡¢groff ¤Î ¥ª¥×¥·¥ç¥ó
 256 .option \-m \ \c
 257 .argument name
 258 ¤Ç¡¢
 259 .B Ì¿Ì¾ÊýË¡
 260 ¤Î¥»¥¯¥·¥ç¥ó¤Çµ½Ò¤·¤¿¤è¤¦¤Ë¥Þ¥¯¥í¥Õ¥¡¥¤¥ë
 261 .BI tmac. name
 262 ¤ÎÄêµÁ¤òÍ¸ú¤Ë¤¹¤ë¡£
 263 .LP
 264 .\"O It is also possible to include the macro file into the document by using
 265 .\"O the groff requests
 266 .\"O .request .so
 267 .\"O or
 268 .\"O .request .mso .
 269 .\"O For
 270 .\"O .request .so
 271 .\"O the full filename of the macro file must be specified \(em including the
 272 .\"O directory where it is kept.
 273 .\"O If the macro file is stored in one of the tmac directories it is more
 274 .\"O convenient to use
 275 .\"O .request .mso
 276 .\"O instead because it additionally searches the tmac path for the filename.
 277 groff ¤Î¥ê¥¯¥¨¥¹¥È
 278 .request .so
 279 ¤ä
 280 .request .mso
 281 ¤ò»È¤Ã¤Æ¥É¥¥å¥á¥ó¥ÈÃæ¤Ç¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤ò»ØÄê¤¹¤ë¤³¤È¤â¤Ç¤¤ë¡£
 282 .request .so
 283 ¤Ç¤Ï¡¢¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤Ï³ÊÇ¼¤µ¤ì¤Æ¤¤¤ë¥Ç¥£¥ì¥¯¥È¥ê¤â´Þ¤á¤¿´°Á´¤Ê¥Õ¥¡¥¤¥ëÌ¾¤Ç
 284 »ØÄê¤¹¤ëÉ¬Í×¤¬¤¢¤ë¡£
 285 ¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤¬ tmac ¥Ç¥£¥ì¥¯¥È¥ê¤Î¤Ò¤È¤Ä¤Ë³ÊÇ¼¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢Âå¤ï¤ê¤Ë
 286 .request .mso
 287 ¤ò»ÈÍÑ¤¹¤ëÊý¤¬ÊØÍø¤Ç¤¢¤ë¡£¤³¤Á¤é¤Ï¥Õ¥¡¥¤¥ëÌ¾¤Ë tmac ¥Ñ¥¹¤òÄÉ²Ã¤·¤Æ
 288 ¸¡º÷¤ò¤¹¤ë¡£
 289 .LP
 290 .\"O Note that in order to resolve the
 291 .\"O .request .so
 292 .\"O and
 293 .\"O .request .mso
 294 .\"O requests the roff preprocessor
 295 .\"O .shellcommand soelim
 296 .\"O must be called.  This can be done either directly by a pipeline on the
 297 .\"O command line or by using the
 298 .\"O .option \-s
 299 .\"O option of
 300 .\"O .shellcommand groff .
 301 .request .so
 302 ¤È
 303 .request .mso
 304 ¤Î¥ê¥¯¥¨¥¹¥È¤ò²ò·è¤¹¤ë¤¿¤á¤Ë roff ¤Î¥×¥ê¥×¥í¥»¥Ã¥µ
 305 .shellcommand soelim
 306 ¤¬¸Æ¤Ó½Ð¤µ¤ì¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¤³¤È¤ËÃí°Õ¤¹¤ë¤³¤È¡£
 307 ¤³¤ì¤Ï¡¢¥³¥Þ¥ó¥É¥é¥¤¥ó¾å¤Î¥Ñ¥¤¥×¥é¥¤¥ó¤ÇÄ¾ÀÜ¼Â¹Ô¤¹¤ëÊýË¡¤È¡¢
 308 .shellcommand groff
 309 ¤Î
 310 .option \-s
 311 ¥ª¥×¥·¥ç¥ó¤ò»È¤Ã¤Æ¸Æ¤Ó½Ð¤¹ÊýË¡¤Î¤É¤Á¤é¤Ç¤â²ÄÇ½¤Ç¤¢¤ë¡£
 312 .LP
 313 .\"O You can also supply the letter
 314 .\"O .'char s
 315 .\"O in the preprocessor word as described in section
 316 .\"O .BR CONVENTION .
 317 .B µ¬Äê
 318 ¤Î¥»¥¯¥·¥ç¥ó¤Çµ½Ò¤·¤Æ¤¢¤ë¤è¤¦¤Ë¡¢¥×¥ê¥×¥í¥»¥Ã¥µ»ØÄê»Ò¤ÎÊ¸»ú
 319 .'char s
 320 ¤Ç»ØÄê¤¹¤ë¤³¤È¤â¤Ç¤¤ë¡£
 321 .LP
 322 .\"O For example, suppose a macro file is stored as
 323 .\"O .I /usr/share/groff/tmac/tmac.macros
 324 .\"O and is used in some document called
 325 .\"O .IR docu.roff .
 326 ¤¿¤È¤¨¤Ð¡¢¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤¬
 327 .I /usr/share/groff/tmac/tmac.macros
 328 ¤Ë³ÊÇ¼¤µ¤ì¤Æ¤¤¤Æ¡¢
 329 .I docu.roff
 330 ¤È¤¤¤¦¥É¥¥å¥á¥ó¥È¤Ç»ÈÍÑ¤¹¤ë¤È²¾Äê¤¹¤ë¡£
 331 .LP
 332 .\"O At run-time, the formatter call for this is
 333 ¼Â¹Ô»þ¤Ç¤Ï¡¢¥Õ¥©¡¼¥Þ¥Ã¥¿¤Î¸Æ¤Ó½Ð¤·ÊýË¡¤Ï°Ê²¼¤Î¤è¤¦¤Ë¤Ê¤ë¡£
 334 .RS
 335 .LP
 336 .ft CR
 337 .shellcommand "groff\ \-m"
 338 .argument macros
 339 .argument docu.roff
 340 .ft P
 341 .RE
 342 .LP
 343 .\"O To include the macro file directly in the document either
 344 ¥É¥¥å¥á¥ó¥ÈÃæ¤Ç¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤òÄ¾ÀÜ»ØÄê¤¹¤ë¤Ë¤Ï¡¢
 345 .RS
 346 .ft CR
 347 \&\.mso tmac.macros
 348 .ft P
 349 .RE
 350 .\"O is used or
 351 ¤òÍÑ¤¤¤ë¤«¡¢
 352 .RS
 353 .ft CR
 354 \&\.so /usr/share/groff/tmac/tmac.macros
 355 .ft P
 356 .RE
 357 ¤È»ØÄê¤¹¤ë¡£
 358 .LP
 359 .\"O In both cases, the formatter is called with
 360 ¤É¤Á¤é¤Î¾ì¹ç¤Ç¤â¡¢¥Õ¥©¡¼¥Þ¥Ã¥¿¤ò
 361 .ft CR
 362 .RS
 363 groff\ \-s docu.roff
 364 .RE
 365 .ft P
 366 ¤Î¤è¤¦¤Ë¤·¤Æ¸Æ¤Ó½Ð¤¹¡£
 367 .
 368 .\" --------------------------------------------------------------------
 369 .\"O .SH CONVENTION
 370 .SH µ¬Äê
 371 .\" --------------------------------------------------------------------
 372 .LP
 373 .\"O There is a convention that is supported by many modern roff
 374 .\"O type-setters: the
 375 .\"O .B preprocessor word
 376 .\"O described in the following.
 377 ºÇ¶á¤ÎÂ¿¤¯¤Î roff À°·Á¥·¥¹¥Æ¥à¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë
 378 .B ¥×¥ê¥×¥í¥»¥Ã¥µ»ØÄê»Ò
 379 ¤Îµ¬Äê¤Ë¤Ä¤¤¤Æ°Ê²¼¤Ëµ½Ò¤¹¤ë¡£
 380 .LP
 381 .\"O If the first line in a document is a comment, the first word (after the
 382 .\"O comment characters and a blank) constitutes the
 383 .\"O .B preprocessor
 384 .\"O .BR word .
 385 ¥É¥¥å¥á¥ó¥È¤ÎÀèÆ¬¹Ô¤¬¥³¥á¥ó¥È¤Î¾ì¹ç¤Ï¡¢¥³¥á¥ó¥ÈÊ¸»ú¤È¶õÇò¤ËÂ³¤¯ºÇ½é¤Î
 386 Ê¸»ú¤Ï
 387 .B ¥×¥ê¥×¥í¥»¥Ã¥µ»ØÄê»Ò
 388 ¤ò¹½À®¤¹¤ë¡£
 389 .\"O That means that the letters of this word are interpreted as
 390 .\"O abbreviations for those preprocessor commands that should be run
 391 .\"O when formatting the document.  Mostly, only the letters corresponding to
 392 .\"O the options for the preprocessors are recognized,
 393 .\"O .'char e ,
 394 .\"O .'char G ,
 395 .\"O .'char g ,
 396 .\"O .'char p ,
 397 .\"O .'char R ,
 398 .\"O .'char s , and
 399 .\"O .'char t
 400 .\"O (see
 401 .\"O .BR roff (7)).
 402 ¤Ä¤Þ¤ê¡¢¤³¤ì¤é¤ÎÊ¸»ú¤Ï¥É¥¥å¥á¥ó¥È¤òÀ°·Á¤¹¤ë¤È¤¤Ëµ¯Æ°¤µ¤ì¤ë
 403 ¥×¥ê¥×¥í¥»¥Ã¥µ¥³¥Þ¥ó¥É¤Î¾ÊÎ¬·Á¤È¤ß¤Ê¤µ¤ì¤ë¡£
 404 ¤¿¤¤¤Æ¤¤¤Ï¡¢¥×¥ê¥×¥í¥»¥Ã¥µ¤Î¸Æ¤Ó½Ð¤·¥ª¥×¥·¥ç¥ó¤È°ìÃ×¤¹¤ëÊ¸»ú¤À¤±¤¬Ç§¼±¤µ¤ì¡¢
 405 °Ê²¼¤Î¤â¤Î¤¬¤¢¤ë¡£
 406 .'char e ,
 407 .'char G ,
 408 .'char g ,
 409 .'char p ,
 410 .'char R ,
 411 .'char s ,
 412 .'char t
 413 .RB ( roff (7)
 414 ¤ò»²¾È¤Î¤³¤È)
 415 .LP
 416 .\"O Besides being a good reminder for the user, some formatters (like the
 417 .\"O .BR man (1)
 418 .\"O program) are even able to automatically start the preprocessors
 419 .\"O specified in the preprocessor word, but do not bet on this.
 420 ¥æ¡¼¥¶¤ËÎÉ¤½õ¸À¤òÍ¿¤¨¤ë¤Ê¤é¤Ð¡¢¤¤¤¯¤Ä¤«¤Î¥Õ¥©¡¼¥Þ¥Ã¥¿ (¤¿¤È¤¨¤Ð
 421 .BR man (1)
 422 ¥×¥í¥°¥é¥à¤Ê¤É) ¤â¥×¥ê¥×¥í¥»¥Ã¥µ»ØÄê»Ò¤Ë¤è¤Ã¤Æ»ØÄê¤µ¤ì¤¿¥×¥ê¥×¥í¥»¥Ã¥µ¤ò
 423 ¼«Æ°Åª¤Ëµ¯Æ°¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£¤·¤«¤·¡¢¤½¤ÎÆ°ºî¤ò´üÂÔ¤¹¤ë¤Ù¤¤Ç¤Ï¤Ê¤¤¡£
 424 .\" --------------------------------------------------------------------
 425 .\"O .SH "WRITING A MACRO FILE"
 426 .SH ¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤Îµ½ÒÊýË¡
 427 .\" --------------------------------------------------------------------
 428 .\"O Writing a groff macro file is easy.  Design a set of macros, strings,
 429 .\"O registers, etc.  Store them in a single file.  Documents that use the
 430 .\"O macros include this macro file with the
 431 .\"O .request .so
 432 .\"O request as described in the
 433 .\"O .B INCLUSION
 434 .\"O section.
 435 groff ¤Î¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤òµ½Ò¤¹¤ë¤³¤È¤Ï´ÊÃ±¤Ç¤¢¤ë¡£
 436 °ìÏ¢¤Î¥Þ¥¯¥í¡¢Ê¸»úÎó¡¢¥ì¥¸¥¹¥¿¤Ê¤É¤ò¥Ç¥¶¥¤¥ó¤·¡¢¤½¤ì¤é¤ò¤Ò¤È¤Ä¤Î¥Õ¥¡¥¤¥ë¤Ë
 437 ³ÊÇ¼¤¹¤ë¡£¤³¤Î¥Þ¥¯¥í¤òÍÑ¤¤¤ë¥É¥¥å¥á¥ó¥È¤Ç
 438 .request .so
 439 ¥ê¥¯¥¨¥¹¥È¤Ë¤è¤Ã¤Æ¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤ò»ØÄê¤¹¤ëÊýË¡¤Ï
 440 .B ¥Þ¥¯¥í¤Î»ÈÍÑÊýË¡
 441 ¤Î¥»¥¯¥·¥ç¥ó¤Ëµ½Ò¤·¤Æ¤¢¤ë¡£
 442 .LP
 443 .\"O To use the tmac functionality, call the macro file
 444 .\"O .BI tmac. whatever
 445 .\"O and put it in some directory of the tmac path, cf. section
 446 .\"O .BR FILES .
 447 .\"O Then documents can include it with the
 448 .\"O .request .mso
 449 .\"O request or the
 450 .\"O .shellcommand "groff\ \-m"
 451 .\"O option as described in the
 452 .\"O .B INCLUSION
 453 .\"O section.
 454 tmac ¤Îµ¡Ç½¤òÍÑ¤¤¤ë¤Ë¤Ï¡¢¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤ò
 455 .BI tmac. whatever
 456 ¤Î¤è¤¦¤ËÌ¿Ì¾¤·¤Æ tmac ¥Ñ¥¹¤Ç»ØÄê¤µ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥ê¤Ë³ÊÇ¼¤¹¤ë
 457 .RB ( ¥Õ¥¡¥¤¥ë
 458 ¤Î¥»¥¯¥·¥ç¥ó¤ò»²¾È)¡£
 459 ¤½¤·¤Æ¡¢¥É¥¥å¥á¥ó¥È¤Ç¤Ï
 460 .B ¥Þ¥¯¥í¤Î»ÈÍÑÊýË¡
 461 ¤Î¥»¥¯¥·¥ç¥ó¤Çµ½Ò¤·¤Æ¤¢¤ë¤è¤¦¤Ë¡¢
 462 .request .mso
 463 ¥ê¥¯¥¨¥¹¥È¤ä
 464 .shellcommand "groff\ \-m"
 465 ¥ª¥×¥·¥ç¥ó¤Ë¤è¤Ã¤Æ¤½¤Î¥Þ¥¯¥í¤ò»ÈÍÑ¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
 466 .LP
 467 .\"O If your macros might be of general usage contact the groff maintainers
 468 .\"O to have them included in the groff
 469 .\"O .I contrib
 470 .\"O source directory.
 471 ¤â¤·¤¢¤Ê¤¿¤Î¥Þ¥¯¥í¤¬°ìÈÌÅª¤ÊÍÑÅÓ¤Ë¸þ¤¤¤Æ¤¤¤ë¤Ê¤é¤Ð¡¢groff ¤Î¥á¥ó¥Æ¥Ê¤Ë
 472 Ï¢Íí¤ò¤È¤Ã¤Æ groff ¤Î
 473 .I contrib
 474 ¥½¡¼¥¹¥Ç¥£¥ì¥¯¥È¥ê¤Ë¤½¤ì¤é¤ò´Þ¤á¤ë¤è¤¦¤Ë¤·¤Æ¤Û¤·¤¤¡£
 475 .LP
 476 .\"O Some general guidelines might be helpful in writing macros.
 477 ¥Þ¥¯¥í¤Îµ½Ò¤Ë¤Ï¡¢°ìÈÌÅª¤Ê¥¬¥¤¥É¥é¥¤¥ó¤Î¤¤¤¯¤Ä¤«¤¬Ìò¤ËÎ©¤Ä¤À¤í¤¦¡£
 478 .IP \(bu 2m
 479 .\"O Double all functional backslashes,
 480 µ¡Ç½Åª¤Ê¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¤Ï¤¹¤Ù¤ÆÆó½Å¤Ë¤¹¤ë¡£
 481 .'char \e
 482 ->
 483 .\"O .'char \e\e .
 484 .'char \e\e
 485 .IP \(bu 2m
 486 .\"O All printable backslashes must be written as
 487 .\"O .'char \ee .
 488 É½¼¨¤¹¤ë¤¿¤á¤Î¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¤Ï¼¡¤Î¤è¤¦¤Ëµ½Ò¤¹¤ë¡£
 489 .'char \ee
 490 .IP \(bu 2m
 491 .\"O Escape all dots,
 492 ¥É¥Ã¥È¤Ï¤¹¤Ù¤Æ¥¨¥¹¥±¡¼¥×¤¹¤ë¡£
 493 .'char .
 494 ->
 495 .\"O .'char \e. .
 496 .'char \e.
 497 .IP \(bu 2m
 498 .\"O Make ample use of the non-printable character
 499 .\"O .'char \e&
 500 .\"O in text parts, esp. before
 501 .\"O .'char \e
 502 .\"O and at the beginning of a line, but not before a delayed command.
 503 ¥Æ¥¥¹¥ÈÉôÊ¬¤Ë¤ÏÈóÉ½¼¨Ê¸»ú¤Ç¤¢¤ë
 504 .'char \e&
 505 ¤ò
 506 .'char \e
 507 ¤ÎÁ°¤È¹Ô¤ÎÀèÆ¬¤Ë¹¤¯ÍÑ¤¤¤ë¤è¤¦¤Ë¤¹¤ë¡£¤¿¤À¤·¸å¤ËÂ³¤¯¥³¥Þ¥ó¥É¤¬¤¢¤ë¾ì¹ç¤Ï
 508 ¤³¤Î¸Â¤ê¤Ç¤Ï¤Ê¤¤¡£
 509 .IP \(bu 2m
 510 .\"O Use the character
 511 .\"O .'char @
 512 .\"O in temporary variable names.
 513 °ì»þÅª¤ÊÊÑ¿ôÌ¾¤Ë¤ÏÊ¸»ú
 514 .'char @
 515 ¤òÍÑ¤¤¤ë¡£
 516 .IP \(bu 2m
 517 .\"O Test your macros for text and graphical devices, e.g.,
 518 .\"O .I latin1
 519 .\"O and
 520 .\"O .IR ps .
 521 ¥Þ¥¯¥í¤Ï¥Æ¥¥¹¥È¤È¥°¥é¥Õ¥£¥Ã¥¯¤Î¥Ç¥Ð¥¤¥¹¤Ç¥Æ¥¹¥È¤¹¤ë¡£¤¿¤È¤¨¤Ð
 522 .I latin1
 523 ¤È
 524 .I ps
 525 ¤Ê¤É¡£
 526 .\" --------------------------------------------------------------------
 527 .\"O .SH FILES
 528 .SH ¥Õ¥¡¥¤¥ë
 529 .\" --------------------------------------------------------------------
 530 .\"O All macro names that want to use the tmac mechanism must be named
 531 .\"O according to the form
 532 .\"O .BIR tmac. name .
 533 tmac ¤Î¥á¥«¥Ë¥º¥à¤ÇÍÑ¤¤¤è¤¦¤È¤¹¤ë¥Þ¥¯¥í¤ÎÌ¾Á°¤Ï
 534 .BI tmac. name
 535 ¤È¤¤¤¦·Á¼°¤ÇÌ¿Ì¾¤µ¤ì¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
 536 .LP
 537 .\"O The macro files are kept in the
 538 .\"O .B tmac
 539 .\"O .BR directories ,
 540 .\"O all of which constitue the
 541 .\"O .B tmac
 542 .\"O .BR path.
 543 ¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤Ï
 544 .B "tmac ¥Ñ¥¹"
 545 ¤ò¹½À®¤¹¤ë
 546 .B "tmac ¥Ç¥£¥ì¥¯¥È¥ê"
 547 ¤Ë³ÊÇ¼¤µ¤ì¤ë¡£
 548 .\"O In accordance with the Filesystem Hierarchy Standard (FHS), the standard
 549 .\"O tmac directory location for groff is
 550 .\"O .IR /usr/share/groff/tmac ,
 551 .\"O a local installation will use
 552 .\"O .IR /usr/local/share/groff/tmac .
 553 Filesystem Hierarchy Standard (FHS) ¤Ë½àµò¤·¤Æ¤¤¤ì¤Ð¡¢
 554 groff ¤ÎÉ¸½àÅª¤Ê tmac ¥Ç¥£¥ì¥¯¥È¥ê¤Î¾ì½ê¤Ï
 555 .I /usr/share/groff/tmac
 556 ¤Ç¤¢¤ê¡¢¥í¡¼¥«¥ë¤ÊÆ³ÆþÀè¤Ï
 557 .I /usr/local/share/groff/tmac
 558 ¤¬ÍÑ¤¤¤é¤ì¤ë¤À¤í¤¦¡£
 559 .\"O Older systems used a subdirectory of
 560 .\"O .IR /usr/lib .
 561 ¸Å¤¤¥·¥¹¥Æ¥à¤Ë¤ª¤¤¤Æ¤Ï¡¢
 562 .I /usr/lib
 563 °Ê²¼¤Î¥µ¥Ö¥Ç¥£¥ì¥¯¥È¥ê¤ò»ÈÍÑ¤·¤Æ¤¤¤¿¡£
 564 .\"O Independently of the default tmac path, the tmac path actually used by a
 565 .\"O document can always be set by a shell environment variable, cf. section
 566 .\"O .BR ENVIRONMENT .
 567 ¥Ç¥Õ¥©¥ë¥È¤Î tmac ¥Ñ¥¹¤È¤ÏÆÈÎ©¤·¤Æ¡¢¼ÂºÝ¤Ë¥É¥¥å¥á¥ó¥È¤ÇÍÑ¤¤¤é¤ì¤ë
 568 tmac ¥Ñ¥¹¤Ï¾ï¤Ë¥·¥§¥ë´Ä¶ÊÑ¿ô¤Ç»ØÄê¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£¥»¥¯¥·¥ç¥ó
 569 .B ´Ä¶ÊÑ¿ô
 570 ¤ò»²¾È¤Î¤³¤È¡£
 571 .\" --------------------------------------------------------------------
 572 .\"O .SH ENVIRONMENT
 573 .SH ´Ä¶ÊÑ¿ô
 574 .\" --------------------------------------------------------------------
 575 .TP
 576 .B GROFF_TMAC_PATH
 577 .\"O A colon separated list of tmac directories in which to search for macro
 578 .\"O files, the
 579 .\"O .B tmac
 580 .\"O .BR path .
 581 .\"O If unset a default path is used as is outlined in the
 582 .\"O .B FILES
 583 .\"O section.
 584 ¥Þ¥¯¥í¥Õ¥¡¥¤¥ë¤ò¸¡º÷¤¹¤ë¤¿¤á¤Î tmac ¥Ç¥£¥ì¥¯¥È¥ê
 585 .RB ( "tmac ¥Ñ¥¹" )
 586 ¤ò¥³¥í¥ó¤Ç¶èÀÚ¤Ã¤¿¥ê¥¹¥È¡£
 587 »ØÄê¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ï¡¢
 588 .B ¥Õ¥¡¥¤¥ë
 589 ¤Î¥»¥¯¥·¥ç¥ó¤Ç¼¨¤·¤¿¥Ç¥Õ¥©¥ë¥È¤Î¥Ñ¥¹¤¬»ÈÍÑ¤µ¤ì¤ë¡£
 590 .\" --------------------------------------------------------------------
 591 .\"O .SH BUGS
 592 .SH ¥Ð¥°
 593 .\" --------------------------------------------------------------------
 594 .\"O The groff documentation is in evolution at the moment.  It is possible
 595 .\"O that small inconsistencies between different documents exist
 596 .\"O temporarily.
 597 ¸½ºß¡¢groff ¥·¥¹¥Æ¥à¤Î¥É¥¥å¥á¥ó¥È¤Ï¿Ê²½¤ÎÅÓ¾å¤Ë¤¢¤ë¡£
 598 °ì»þÅª¤Ë¥É¥¥å¥á¥ó¥ÈÆ±»Î¤Ç¤µ¤µ¤ä¤«¤ÊÌ·½âÅÀ¤¬¸«¤é¤ì¤ë¤À¤í¤¦¡£
 599 .\" --------------------------------------------------------------------
 600 .\"O .SH AUTHOR
 601 .SH Ãø¼Ô
 602 .\" --------------------------------------------------------------------
 603 .\"O This document is part of groff, the GNU roff distribution.  It was
 604 .\"O written by Bernd Warken <bwarken@mayn.de>.
 605 ¤³¤Î¥É¥¥å¥á¥ó¥È¤Ï groff (GNU roff ¥Ñ¥Ã¥±¡¼¥¸) ¤Î°ìÉô¤Ç¤¢¤ë¡£
 606 Bernd Warken <bwarken@mayn.de> ¤Ë¤è¤Ã¤Æµ½Ò¤µ¤ì¤¿¡£
 607 .LP
 608 .\"O It is distributed under the terms of the FDL (GNU Free Documentation
 609 .\"O License) version 1.1 or later.  You should have received a copy of the
 610 .\"O FDL on your system, it is also available on-line under
 611 ¤³¤Î¥É¥¥å¥á¥ó¥È¤Ï FDL (GNU Free Documentation License) ¤Î¥Ð¡¼¥¸¥ç¥ó 1.1
 612 °Ê¹ß¤Î¸µ¤ËÇÛÉÛ¤µ¤ì¤ë¡£¤¢¤Ê¤¿¤Î¥·¥¹¥Æ¥à¤Ë¤â FDL ¤Î¥³¥Ô¡¼¤¬¤¢¤ë¤Ï¤º¤Ç¤¢¤ë¡£
 613 °Ê²¼¤Ç¤â¥ª¥ó¥é¥¤¥ó¤Ç»²¾È¤Ç¤¤ë¡£
 614 .RS
 615 .LP
 616 .IR <http://www.gnu.org/copyleft/fdl.html> .
 617 .RE
 618 .\" --------------------------------------------------------------------
 619 .\"O .SH "SEE ALSO"
 620 .SH ´ØÏ¢¹àÌÜ
 621 .\" --------------------------------------------------------------------
 622 .\"O The authoritative source of information for all details of the groff
 623 .\"O system is the groff
 624 .\"O .BR info (1)
 625 .\"O file.
 626 groff ¥·¥¹¥Æ¥à¤Î¾ÜºÙ¤Ë¤Ä¤¤¤Æ¡¢¿®¤º¤Ù¤¾ðÊó¸»¤Ï¡¢groff ¤Î
 627 .BR info (1)
 628 ¥Õ¥¡¥¤¥ë¤Ç¤¢¤ë¡£
 629 .LP
 630 .\"O For a groff overview, see
 631 .\"O .BR roff (7)
 632 .\"O and the file
 633 .\"O .I README
 634 .\"O in the groff source package.
 635 groff ¤Î³µÍ×¤Ë¤Ä¤¤¤Æ¤Ï
 636 .BR roff (7)
 637 ¤È groff ¥½¡¼¥¹¥Ñ¥Ã¥±¡¼¥¸¤Î
 638 .I README
 639 ¥Õ¥¡¥¤¥ë¤ò»²¾È¤Î¤³¤È¡£
 640 .LP
 641 .\"O The groff tmac macro packages are
 642 .\"O .BR groff_man (7),
 643 .\"O .BR groff_markup (7),
 644 .\"O .BR groff_mdoc (7),
 645 .\"O .BR groff_mdoc.samples (7),
 646 .\"O .BR groff_me (7),
 647 .\"O .BR groff_mm (7),
 648 .\"O .BR groff_mmroff (7),
 649 .\"O .BR groff_ms (7),
 650 .\"O .BR groff_msafer (7).
 651 groff ¤Î tmac ¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸¤Ë¤Ä¤¤¤Æ¤Ï°Ê²¼¤ò»²¾È¤Î¤³¤È¡£
 652 .BR groff_man (7),
 653 .BR groff_markup (7),
 654 .BR groff_mdoc (7),
 655 .BR groff_mdoc.samples (7),
 656 .BR groff_me (7),
 657 .BR groff_mm (7),
 658 .BR groff_mmroff (7),
 659 .BR groff_ms (7),
 660 .BR groff_msafer (7)
 661 .LP
 662 .\"O The groff language is described in
 663 .\"O .BR groff (7)
 664 .\"O and the formatters in
 665 .\"O .BR groff (1),
 666 .\"O .BR troff (1).
 667 groff ¸À¸ì¤Ë¤Ä¤¤¤Æ¤Ï
 668 .BR groff (7)
 669 ¤Ë¡¢¥Õ¥©¡¼¥Þ¥Ã¥¿¤Ë¤Ä¤¤¤Æ¤Ï
 670 .BR groff "(1) ¤È"
 671 .BR troff (1)
 672 ¤Ëµ½Ò¤µ¤ì¤Æ¤¤¤ë¡£
 673 .LP
 674 .\"O The Filesystem Hierarchy Standard (FHS) is available at
 675 .\"O .BR http://www.pathname.com/fhs/ .
 676 .\"O
 677 Filesystem Hierarchy Standard (FHS) ¤Ë¤Ä¤¤¤Æ¤Ï
 678 .B http://www.pathname.com/fhs/
 679 ¤ò»²¾È¤Î¤³¤È¡£
 680
 681