Import translated manuals from JM CVS Repository.

[linuxjm/jm.git] / manual / gnumaniak / draft / man1 / fmt.1

.\" You may copy, distribute and modify under the terms of the LDP General
.\" Public License as specified in the LICENSE file that comes with the
.\" gnumaniak distribution
.\"
.\" The author kindly requests that no comments regarding the "better"
.\" suitability or up-to-date notices of any info documentation alternative
.\" is added without contacting him first.
.\"
.\" (C) 2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
.\"
.\"     GNU fmt man page
.\"     man pages are NOT obsolete!
.\"     <ragnar@ragnar-hojland.com>
.\"
.\" Japanese Version Copyright (c) 2000 NAKANO Takeo all rights reserved.
.\" Translated Sun 12 Mar 2000 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
.TH FMT 1 "7 October 2002" "GNU textutils 2.1"
.\"O .SH NAME
.\"O \fBfmt\fR \- reformat paragraph text
.SH ̾Á°
fmt \- ¥Æ¥­¥¹¥È¤òÃÊÍî¤ËÀ°·Á¤¹¤ë
.\"O .SH SYNOPSIS
.SH ½ñ¼°
.B fmt
.RB [ \-ctsu "] [" -\fIWIDTH\fR "] [" "\-p \fIREFIX\fR" "] [" "\-w \fIWIDTH\fR" ]
.RB [ \-\-crown\-margin ]
.RB [ \-\-split\-only ]
.RB [ \-\-tagged\-paragraph ]
.RB [ \-\-uniform\-spacing ]
.RB [ "\-\-prefix=\fIPREFIX\fR" ] 
.RB [ "\-\-width=\fIWIDTH\fR" ]
.RI [ FILE... ]

.BR fmt " [" \-\-help "] [" \-\-version ]
.\"O .SH DESCRIPTION
.SH ÀâÌÀ
.\"O .B fmt
.\"O inserts and removes newlines to produce output lines of (at most) a
.\"O given number of characters (75 by default).  \fBfmt\fR reads from the
.\"O specified
.\"O .I FILE
.\"O arguments (or from standard input if none is given) and writes to standard
.\"O output.
.B fmt
¤Ï¹Ô¤ò·ë¹ç¤·¤¿¤ê·ä´Ö¤òËä¤á¤¿¤ê¤·¤Æ¡¢
½ÐÎϳƹԤòÍ¿¤¨¤é¤ì¤¿Ê¸»ú¿ô¤Ë·¤¨¤ë (Àµ³Î¤Ë¤Ï±Û¤¨¤Ê¤¤¤è¤¦¤Ë¤¹¤ë)¡£
¥Ç¥Õ¥©¥ë¥È¤Ï 75 ·å¡£
.B fmt
¤Ï
.I FILE
°ú¿ô (¥Õ¥¡¥¤¥ë¤¬°ì¤Ä¤â»ØÄꤵ¤ì¤Ê¤«¤Ã¤¿¾ì¹ç¤Ïɸ½àÆþÎÏ) ¤«¤éÆɤߡ¢
ɸ½à½ÐÎϤ˽ñ¤¯¡£

.\"O By default, blank lines, spaces between words, and indentation are
.\"O preserved in the output; successive input lines with different
.\"O indentation are not joined; tabs are expanded on input and introduced on
.\"O output.
¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï¡¢¶õ¹Ô¡¦Ã±¸ì´Ö¤Î¥¹¥Ú¡¼¥¹¤Î¿ô¡¦¥¤¥ó¥Ç¥ó¥È¤Ï½ÐÎϤËÊݸ¤µ¤ì¤ë¡£
¥¤¥ó¥Ç¥ó¥È¤Î°Û¤Ê¤ëϢ³¹Ô¤Ï·ë¹ç¤·¤Ê¤¤¡£¥¿¥Ö¤ÏÆþÎϤǰìÅÙ¥¹¥Ú¡¼¥¹¤ËÊÑ´¹¤µ¤ì¡¢
½ÐÎϤÇÁÞÆþ¤µ¤ì¤ë¡£

.\"O \fBfmt\fR prefers breaking lines at the end of a sentence, and tries to
.\"O avoid line breaks after the first word of a sentence or before the last
.\"O word of a sentence.  A "sentence break" is defined as either the end of
.\"O a paragraph or a word ending in any of `.?!', followed by two spaces or
.\"O end of line, ignoring any intervening parentheses or quotes.  Like
.\"O \fBTeX\fR(1), \fBfmt\fR reads entire "paragraphs" before choosing line
.\"O breaks; the algorithm is a variant of that in "Breaking Paragraphs Into
.\"O Lines" (Donald E. Knuth and Michael F. Plass, Software--Practice and
.\"O Experience', 11 (1981), 1119-1184).
.B fmt
¤Ïʸ¤ÎºÇ¸å¤Ç²þ¹Ô¤·¤è¤¦¤È¤¹¤ë¡£
¤Þ¤¿Ê¸¤ÎºÇ½é¤Îñ¸ì¤Îľ¸å¤ä¡¢Ê¸¤ÎºÇ¸å¤Îñ¸ì¤ÎľÁ°¤Ç¤Î²þ¹Ô¤ÏÈò¤±¤è¤¦¤È¤¹¤ë¡£
¡Öʸ¤Î¶èÀÚ¤ê¡×¤Ï¡¢ÃÊÍî¤ÎºÇ¸å¤«¡¢`.?!' ¤Î¤É¤ì¤«¤Ç½ª¤ï¤ëñ¸ì¤Ë
2 ¤Ä¤Î¥¹¥Ú¡¼¥¹¤Þ¤¿¤Ï³¤¤¤¿¤â¤Î¤È¤·¤ÆÄêµÁ¤µ¤ì¤ë¡£
¤¿¤À¤·³ç¸Ì¤ä°úÍÑÉä¤ÎÆâÉô¤Ç¤Ïʸ¶èÀÚ¤ê¤È¤Ï¤ß¤Ê¤µ¤ì¤Ê¤¤¡£
.BR TeX (1)
¤ÈƱ¤¸¤¯¡¢
.B fmt
¤â¡ÖÃÊÍî¡×Á´ÂΤòÆɤ߹þ¤ó¤Ç¤«¤é²þ¹Ô°ÌÃÖ¤ò·è¤á¤ë¡£
¤³¤Î¥¢¥ë¥´¥ê¥º¥à¤Ï¡¢
"Breaking Paragraphs into Lines"
(Donald E. Knuth and Michael F. Plass,
Software--Practice and Experience', 11 (1981) 1119-1184)
¤ÇÄó°Æ¤µ¤ì¤¿¤â¤Î¤ò¤Á¤ç¤Ã¤ÈÊѹ¹¤·¤¿¤â¤Î¤Ç¤¢¤ë¡£
.\"O .SH OPTIONS
.SH ¥ª¥×¥·¥ç¥ó
.TP
.B \-c, \-\-crown\-margin
.\"O "Crown margin" mode: preserve the indentation of the first two
.\"O lines within a paragraph, and align the left margin of each
.\"O subsequent line with that of the second line.
¥¯¥é¥¦¥ó¥Þ¡¼¥¸¥ó¥â¡¼¥É (crown margin mode)¡£
ÃÊÍî¤ÎºÇ½é¤ÎÆó¹Ô¤Î¥¤¥ó¥Ç¥ó¥È¤òÊݸ¤·¡¢
°ú¤­Â³¤¯¹Ô¤Îº¸¥Þ¡¼¥¸¥ó¤ò¤½¤ì¤¾¤ìÂèÆó¹Ô¤Î¤â¤Î¤Ë·¤¨¤ë¡£
.TP
.B \-p \fIPREFIX\fB, \-\-prefix=\fIPREFIX
.\"O Only lines beginning with \fIPREFIX\fR (possibly preceded by whitespace)
.\"O are subject to formatting. The \fIPREFIX\fR and any preceding whitespace
.\"O are stripped for the formatting and then re-attached to each
.\"O formatted output line.  One use is to format certain kinds of
.\"O program comments, while leaving the code unchanged.
.I PREFIX
¤Ç»Ï¤Þ¤ë¹Ô (¥¹¥Ú¡¼¥¹¤¬Á°ÃÖ¤µ¤ì¤Æ¤¤¤Æ¤âÎɤ¤) ¤À¤±¤òºÆÇÛÃÖ¤¹¤ë¡£
.I PREFIX
(¤ÈÁ°ÃÖ¤µ¤ì¤ë¥¹¥Ú¡¼¥¹) ¤ÏÀ°·ÁÁ°¤Ë¤¤¤Ã¤¿¤óºï½ü¤µ¤ì¡¢
À°·Á¤µ¤ì¤¿½ÐÎϹԤ˺ƤÓÁÞÆþ¤µ¤ì¤ë¡£
ÍøÍÑË¡¤È¤·¤Æ¤Ï¡¢Î㤨¤Ð¤¢¤ë¼ï¤Î¥×¥í¥°¥é¥à¤Î¥³¥á¥ó¥È¤À¤±¤òÀ°·Á¤·¤Æ¡¢
¥³¡¼¥ÉÉôʬ¤ÏÊѹ¹¤·¤¿¤¯¤Ê¤¤¾ì¹ç¤Ê¤É¤¬¹Í¤¨¤é¤ì¤ë¡£
.TP
.B \-s, \-\-split\-only
.\"O Split lines only.  Do not join short lines to form longer ones.
.\"O This prevents sample lines of code, and other such "formatted"
.\"O text from being unduly combined.
¹Ôʬ³ä¤À¤±¤ò¹Ô¤¦¡£Ã»¤¤¹Ô¤ò·ë¹ç¤·¤ÆŤ¤¹Ô¤òÀ¸À®¤¹¤ëºî¶È¤ò¹Ô¤ï¤Ê¤¤¡£
¥×¥í¥°¥é¥à¥³¡¼¥É¤Ê¤É¤Î¡ÖÀ°·ÁºÑ¤ß¡×¥Æ¥­¥¹¥È¤¬
ÉÔÀµ¤Ë·ë¹ç¤µ¤ì¤ë¤Î¤òÈò¤±¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
.TP
.B \-t, \-\-tagged\-margin
.\"O "Tagged paragraph" mode: like crown margin mode, except that if
.\"O indentation of the first line of a paragraph is the same as the
.\"O indentation of the second, the first line is treated as a one-line
.\"O paragraph.
¥¿¥°ÉÕ¤­ÃÊÍî¥â¡¼¥É (tagged paragraph mode)¡£
¥¯¥é¥¦¥ó¥â¡¼¥É¤È»÷¤Æ¤¤¤ë¤¬¡¢
ÃÊÍî¤ÎºÇ½é¤Î¹Ô¤Î¥¤¥ó¥Ç¥ó¥È¤ÏÂèÆó¹Ô¤Î¤â¤Î¤È¤Ï°Û¤Ê¤Ã¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
Ʊ¤¸¤Ç¤¢¤ë¾ì¹ç¤Ï¡¢ºÇ½é¤Î¹Ô¤Ï°ì¹Ô¤À¤±¤«¤é¤Ê¤ëÃÊÍî¤È¤ß¤Ê¤µ¤ì¤ë¡£
.TP       
.B \-u, \-\-uniform\-spacing
.\"O Uniform spacing.  Reduce spacing between words to one space, and
.\"O spacing between sentences to two spaces.               
°ìÍͤʥ¹¥Ú¡¼¥¹ÇÛÃÖ (uniform spacing)¡£
ñ¸ì´Ö¤Î¥¹¥Ú¡¼¥¹¤ò¥¹¥Ú¡¼¥¹Ê¸»ú¤Ò¤È¤Ä¤Ë¸º¤é¤¹¡£
¤¿¤À¤·Ê¸¤Î´Ö¤Ë¤ÏÆó¤Ä¤Î¥¹¥Ú¡¼¥¹Ê¸»ú¤¬ÍѤ¤¤é¤ì¤ë¡£
.TP
.B \-\fIWIDTH\fB, \-w \fIWIDTH\fB, \-\-width=\fIWIDTH
.\"O Fill output lines up to \fIWIDTH\fR characters (default 75).  \fBfmt\fR
.\"O initially tries to make lines about 7% shorter than this, to give
.\"O it room to balance line lengths.
½ÐÎϹԤò
.I WIDTH
·å¤Þ¤ÇËä¤á¤è¤¦¤È¤¹¤ë (¥Ç¥Õ¥©¥ë¥È¤Ï 75)¡£
.B fmt
¤Ï³Æ¹Ô¤ÎŤµ¤ò·¤¨¤ë¤¿¤á¤Î¶õ´Ö¤ò³ÎÊݤ¹¤ëÌÜŪ¤«¤é¡¢
¤ª¤è¤½ 7% ¤Û¤É¹Ô¤òû¤¯¤¹¤ë·¹¸þ¤Ë¤¢¤ë¡£
.TP
.B "\-\-help"
.\"O Print a usage message on standard output and exit successfully.
ɸ½à½ÐÎϤ˻ÈÍÑÊýË¡¤Î¥á¥Ã¥»¡¼¥¸¤ò½ÐÎϤ·¤ÆÀµ¾ï½ªÎ»¤¹¤ë¡£
.TP
.B "\-\-version"
.\"O Print version information on standard output then exit successfully.
ɸ½à½ÐÎϤ˥С¼¥¸¥ç¥ó¾ðÊó¤ò½ÐÎϤ·¤ÆÀµ¾ï½ªÎ»¤¹¤ë¡£
.\"O .SH NOTES
.SH Ãí°Õ
.\"O Report bugs to bug-textutils@gnu.org.
.\"O .br
.\"O Man page by Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
¥×¥í¥°¥é¥à¤Î¥Ð¥°¤Ë¤Ä¤¤¤Æ¤Ï bug-textutils@gnu.org ¤ËÊó¹ð¤·¤Æ¤¯¤À¤µ¤¤¡£
.br
man ¥Ú¡¼¥¸¤Ï Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com> ¤¬ºîÀ®¤·¤Þ¤·¤¿¡£