File:  [Local Repository] / gnujdoc / coreutils-5.0 / coreutils-ja.texi
Revision 1.2: download - view: text, annotated - select for diffs
Sat Feb 21 16:50:43 2004 UTC (16 years, 8 months ago) by futoshi
Branches: MAIN
CVS tags: HEAD
Bug fix for some Texinfo files.

    1: \input texinfo
    2: @c %**start of header
    3: @setfilename coreutils-ja.info
    4: @settitle @sc{gnu} Coreutils
    5: 
    6: @c %**end of header
    7: 
    8: @c @documentlanguage ja
    9: 
   10: @include coreutils-v.texi
   11: @include constants.texi
   12: 
   13: @c Define new indices.
   14: @defcodeindex op
   15: @defcodeindex fl
   16: 
   17: @c Put everything in one index (arbitrarily chosen to be the concept index).
   18: @syncodeindex fl cp
   19: @syncodeindex fn cp
   20: @syncodeindex ky cp
   21: @syncodeindex op cp
   22: @syncodeindex pg cp
   23: @syncodeindex vr cp
   24: 
   25: @dircategory Basics
   26: @direntry
   27: * Coreutils(ja): (coreutils-ja).       Core GNU (file, text, shell) utilities.
   28: * Common options(ja): (coreutils-ja)Common options.      Common options.
   29: * File permissions(ja): (coreutils-ja)File permissions.  Access modes.
   30: * Date input formats(ja): (coreutils-ja)Date input formats.
   31: @end direntry
   32: 
   33: @dircategory Individual utilities
   34: @direntry
   35: * basename(ja): (coreutils-ja)basename invocation.   Strip directory and suffix.
   36: * cat(ja): (coreutils-ja)cat invocation.             Concatenate and write files.
   37: * chgrp(ja): (coreutils-ja)chgrp invocation.         Change file groups.
   38: * chmod(ja): (coreutils-ja)chmod invocation.         Change file permissions.
   39: * chown(ja): (coreutils-ja)chown invocation.         Change file owners/groups.
   40: * chroot(ja): (coreutils-ja)chroot invocation.       Specify the root directory.
   41: * cksum(ja): (coreutils-ja)cksum invocation.         Print POSIX CRC checksum.
   42: * comm(ja): (coreutils-ja)comm invocation.           Compare sorted files by line.
   43: * cp(ja): (coreutils-ja)cp invocation.               Copy files.
   44: * csplit(ja): (coreutils-ja)csplit invocation.       Split by context.
   45: * cut(ja): (coreutils-ja)cut invocation.             Print selected parts of lines.
   46: * date(ja): (coreutils-ja)date invocation.           Print/set system date and time.
   47: * dd(ja): (coreutils-ja)dd invocation.               Copy and convert a file.
   48: * df(ja): (coreutils-ja)df invocation.               Report filesystem disk usage.
   49: * dir(ja): (coreutils-ja)dir invocation.             List directories briefly.
   50: * dircolors(ja): (coreutils-ja)dircolors invocation. Color setup for ls.
   51: * dirname(ja): (coreutils-ja)dirname invocation.     Strip non-directory suffix.
   52: * du(ja): (coreutils-ja)du invocation.               Report on disk usage.
   53: * echo(ja): (coreutils-ja)echo invocation.           Print a line of text.
   54: * env(ja): (coreutils-ja)env invocation.             Modify the environment.
   55: * expand(ja): (coreutils-ja)expand invocation.       Convert tabs to spaces.
   56: * expr(ja): (coreutils-ja)expr invocation.           Evaluate expressions.
   57: * factor(ja): (coreutils-ja)factor invocation.       Print prime factors
   58: * false(ja): (coreutils-ja)false invocation.         Do nothing, unsuccessfully.
   59: * fmt(ja): (coreutils-ja)fmt invocation.             Reformat paragraph text.
   60: * fold(ja): (coreutils-ja)fold invocation.           Wrap long input lines.
   61: * groups(ja): (coreutils-ja)groups invocation.       Print group names a user is in.
   62: * head(ja): (coreutils-ja)head invocation.           Output the first part of files.
   63: * hostid(ja): (coreutils-ja)hostid invocation.       Print numeric host identifier.
   64: * hostname(ja): (coreutils-ja)hostname invocation.   Print or set system name.
   65: * id(ja): (coreutils-ja)id invocation.               Print real/effective uid/gid.
   66: * install(ja): (coreutils-ja)install invocation.     Copy and change attributes.
   67: * join(ja): (coreutils-ja)join invocation.           Join lines on a common field.
   68: * kill(ja): (coreutils-ja)kill invocation.           Send a signal to processes.
   69: * link(ja): (coreutils-ja)link invocation.           Make hard links between files.
   70: * ln(ja): (coreutils-ja)ln invocation.               Make links between files.
   71: * logname(ja): (coreutils-ja)logname invocation.     Print current login name.
   72: * ls(ja): (coreutils-ja)ls invocation.               List directory contents.
   73: * md5sum(ja): (coreutils-ja)md5sum invocation.       Print or check message-digests.
   74: * mkdir(ja): (coreutils-ja)mkdir invocation.         Create directories.
   75: * mkfifo(ja): (coreutils-ja)mkfifo invocation.       Create FIFOs (named pipes).
   76: * mknod(ja): (coreutils-ja)mknod invocation.         Create special files.
   77: * mv(ja): (coreutils-ja)mv invocation.               Rename files.
   78: * nice(ja): (coreutils-ja)nice invocation.           Modify scheduling priority.
   79: * nl(ja): (coreutils-ja)nl invocation.               Number lines and write files.
   80: * nohup(ja): (coreutils-ja)nohup invocation.         Immunize to hangups.
   81: * od(ja): (coreutils-ja)od invocation.               Dump files in octal, etc.
   82: * paste(ja): (coreutils-ja)paste invocation.         Merge lines of files.
   83: * pathchk(ja): (coreutils-ja)pathchk invocation.     Check file name portability.
   84: * pr(ja): (coreutils-ja)pr invocation.               Paginate or columnate files.
   85: * printenv(ja): (coreutils-ja)printenv invocation.   Print environment variables.
   86: * printf(ja): (coreutils-ja)printf invocation.       Format and print data.
   87: * ptx(ja): (coreutils-ja)ptx invocation.             Produce permuted indexes.
   88: * pwd(ja): (coreutils-ja)pwd invocation.             Print working directory.
   89: * readlink(ja): (coreutils-ja)readlink invocation.   Print referent of a symlink.
   90: * rm(ja): (coreutils-ja)rm invocation.               Remove files.
   91: * rmdir(ja): (coreutils-ja)rmdir invocation.         Remove empty directories.
   92: * seq(ja): (coreutils-ja)seq invocation.             Print numeric sequences
   93: * shred(ja): (coreutils-ja)shred invocation.         Remove files more securely.
   94: * sleep(ja): (coreutils-ja)sleep invocation.         Delay for a specified time.
   95: * sort(ja): (coreutils-ja)sort invocation.           Sort text files.
   96: * split(ja): (coreutils-ja)split invocation.         Split into fixed-size pieces.
   97: * stat(ja): (coreutils-ja)stat invocation.           Report file(system) status.
   98: * stty(ja): (coreutils-ja)stty invocation.           Print/change terminal settings.
   99: * su(ja): (coreutils-ja)su invocation.               Modify user and group id.
  100: * sum(ja): (coreutils-ja)sum invocation.             Print traditional checksum.
  101: * sync(ja): (coreutils-ja)sync invocation.           Synchronize memory and disk.
  102: * tac(ja): (coreutils-ja)tac invocation.             Reverse files.
  103: * tail(ja): (coreutils-ja)tail invocation.           Output the last part of files.
  104: * tee(ja): (coreutils-ja)tee invocation.             Redirect to multiple files.
  105: * test(ja): (coreutils-ja)test invocation.           File/string tests.
  106: * touch(ja): (coreutils-ja)touch invocation.         Change file timestamps.
  107: * tr(ja): (coreutils-ja)tr invocation.               Translate characters.
  108: * true(ja): (coreutils-ja)true invocation.           Do nothing, successfully.
  109: * tsort(ja): (coreutils-ja)tsort invocation.         Topological sort.
  110: * tty(ja): (coreutils-ja)tty invocation.             Print terminal name.
  111: * uname(ja): (coreutils-ja)uname invocation.         Print system information.
  112: * unexpand(ja): (coreutils-ja)unexpand invocation.   Convert spaces to tabs.
  113: * uniq(ja): (coreutils-ja)uniq invocation.           Uniquify files.
  114: * unlink(ja): (coreutils-ja)unlink invocation.       Removal via unlink(2).
  115: * users(ja): (coreutils-ja)users invocation.         Print current user names.
  116: * vdir(ja): (coreutils-ja)vdir invocation.           List directories verbosely.
  117: * wc(ja): (coreutils-ja)wc invocation.               Byte, word, and line counts.
  118: * who(ja): (coreutils-ja)who invocation.             Print who is logged in.
  119: * whoami(ja): (coreutils-ja)whoami invocation.       Print effective user id.
  120: * yes(ja): (coreutils-ja)yes invocation.             Print a string indefinitely.
  121: @end direntry
  122: 
  123: @copying
  124: This manual documents version @value{VERSION} of the @sc{gnu} core
  125: utilities, including the standard programs for text and file manipulation.
  126: 
  127: Copyright @copyright{} 1994, 1995, 1996, 2000, 2001, 2002, 2003
  128: Free Software Foundation, Inc.
  129: 
  130: @quotation
  131: Permission is granted to copy, distribute and/or modify this document
  132: under the terms of the GNU Free Documentation License, Version 1.1 or
  133: any later version published by the Free Software Foundation; with no
  134: Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  135: Texts.  A copy of the license is included in the section entitled ``GNU
  136: Free Documentation License''.
  137: @end quotation
  138: @end copying
  139: 
  140: @titlepage
  141: @title @sc{gnu} @code{Coreutils}
  142: @subtitle Core GNU utilities
  143: @subtitle for version @value{VERSION}, @value{UPDATED}
  144: @author David MacKenzie et al.
  145: @c 翻訳:西尾 太
  146: 
  147: @page
  148: @vskip 0pt plus 1filll
  149: @insertcopying
  150: @end titlepage
  151: 
  152: 
  153: @ifnottex
  154: @node Top
  155: @top GNU Coreutils
  156: 
  157: @insertcopying
  158: @end ifnottex
  159: 
  160: @cindex core utilities
  161: @cindex text utilities
  162: @cindex shell utilities
  163: @cindex file utilities
  164: 
  165: @menu
  166: * Introduction::                       Caveats, overview, and authors.
  167: * Common options::                     Common options.
  168: * Output of entire files::             cat tac nl od
  169: * Formatting file contents::           fmt pr fold
  170: * Output of parts of files::           head tail split csplit
  171: * Summarizing files::                  wc sum cksum md5sum
  172: * Operating on sorted files::          sort uniq comm ptx tsort
  173: * Operating on fields within a line::  cut paste join
  174: * Operating on characters::            tr expand unexpand
  175: * Directory listing::                  ls dir vdir d v dircolors
  176: * Basic operations::                   cp dd install mv rm shred
  177: * Special file types::                 ln mkdir rmdir mkfifo mknod
  178: * Changing file attributes::           chgrp chmod chown touch
  179: * Disk usage::                         df du stat sync
  180: * Printing text::                      echo printf yes
  181: * Conditions::                         false true test expr
  182: * Redirection::                        tee
  183: * File name manipulation::             dirname basename pathchk
  184: * Working context::                    pwd stty printenv tty
  185: * User information::                   id logname whoami groups users who
  186: * System context::                     date uname hostname
  187: * Modified command invocation::        chroot env nice nohup su
  188: * Process control::                    kill
  189: * Delaying::                           sleep
  190: * Numeric operations::                 factor seq
  191: * File permissions::                   Access modes.
  192: * Date input formats::                 Specifying date strings.
  193: * Opening the software toolbox::       The software tools philosophy.
  194: * GNU Free Documentation License::     The license for this documentation.
  195: * Index::                              General index.
  196: 
  197: @detailmenu
  198: @c  --- The Detailed Node Listing ---
  199: @c 
  200:  --- 詳細なノードリスト ---
  201: 
  202: @c Common Options
  203: @c 
  204: 共通のオプション
  205: 
  206: * Exit status::                 Indicating program success or failure.
  207: * Backup options::              Backup options
  208: * Block size::                  Block size
  209: * Target directory::            Target directory
  210: * Trailing slashes::            Trailing slashes
  211: * Standards conformance::       Standards conformance
  212: 
  213: @c Output of entire files
  214: @c 
  215: ファイル全体を出力
  216: 
  217: * cat invocation::              Concatenate and write files.
  218: * tac invocation::              Concatenate and write files in reverse.
  219: * nl invocation::               Number lines and write files.
  220: * od invocation::               Write files in octal or other formats.
  221: 
  222: @c Formatting file contents
  223: @c 
  224: ファイルの内容の書式化
  225: 
  226: * fmt invocation::              Reformat paragraph text.
  227: * pr invocation::               Paginate or columnate files for printing.
  228: * fold invocation::             Wrap input lines to fit in specified width.
  229: 
  230: @c Output of parts of files
  231: @c 
  232: ファイルの一部を出力
  233: 
  234: * head invocation::             Output the first part of files.
  235: * tail invocation::             Output the last part of files.
  236: * split invocation::            Split a file into fixed-size pieces.
  237: * csplit invocation::           Split a file into context-determined pieces.
  238: 
  239: @c Summarizing files
  240: @c 
  241: ファイルの要約
  242: 
  243: * wc invocation::               Print byte, word, and line counts.
  244: * sum invocation::              Print checksum and block counts.
  245: * cksum invocation::            Print CRC checksum and byte counts.
  246: * md5sum invocation::           Print or check message-digests.
  247: 
  248: @c Operating on sorted files
  249: @c 
  250: ソートされたファイルの操作
  251: 
  252: * sort invocation::             Sort text files.
  253: * uniq invocation::             Uniquify files.
  254: * comm invocation::             Compare two sorted files line by line.
  255: * ptx invocation::              Produce a permuted index of file contents.
  256: * tsort invocation::            Topological sort.
  257: 
  258: @c @command{ptx}: Produce permuted indexes
  259: @c 
  260: @command{ptx}: 並べ替えした索引の生成
  261: 
  262: * General options in ptx::      Options which affect general program behavior.
  263: * Charset selection in ptx::    Underlying character set considerations.
  264: * Input processing in ptx::     Input fields, contexts, and keyword selection.
  265: * Output formatting in ptx::    Types of output format, and sizing the fields.
  266: * Compatibility in ptx::        The GNU extensions to @command{ptx}
  267: 
  268: @c Operating on fields within a line
  269: @c 
  270: 行のフィールドの操作
  271: 
  272: * cut invocation::              Print selected parts of lines.
  273: * paste invocation::            Merge lines of files.
  274: * join invocation::             Join lines on a common field.
  275: 
  276: @c Operating on characters
  277: @c 
  278: 文字の操作
  279: 
  280: * tr invocation::               Translate, squeeze, and/or delete characters.
  281: * expand invocation::           Convert tabs to spaces.
  282: * unexpand invocation::         Convert spaces to tabs.
  283: 
  284: @c @command{tr}: Translate, squeeze, and/or delete characters
  285: @c 
  286: @command{tr}: 文字を置換する,まとめる,そして/または削除する
  287: 
  288: * Character sets::              Specifying sets of characters.
  289: * Translating::                 Changing one characters to another.
  290: * Squeezing::                   Squeezing repeats and deleting.
  291: * Warnings in tr::              Warning messages.
  292: 
  293: @c Directory listing
  294: @c 
  295: ディレクトリのリストアップ
  296: 
  297: * ls invocation::               List directory contents
  298: * dir invocation::              Briefly list directory contents
  299: * vdir invocation::             Verbosely list directory contents
  300: * dircolors invocation::        Color setup for @command{ls}
  301: 
  302: @c @command{ls}:  List directory contents
  303: @c 
  304: @command{ls}: ディレクトリの内容をリストアップする
  305: 
  306: * Which files are listed::      Which files are listed
  307: * What information is listed::  What information is listed
  308: * Sorting the output::          Sorting the output
  309: * More details about version sort::  More details about version sort
  310: * General output formatting::   General output formatting
  311: * Formatting the file names::   Formatting the file names
  312: 
  313: @c Basic operations
  314: @c 
  315: 基本操作
  316: 
  317: * cp invocation::               Copy files and directories
  318: * dd invocation::               Convert and copy a file
  319: * install invocation::          Copy files and set attributes
  320: * mv invocation::               Move (rename) files
  321: * rm invocation::               Remove files or directories
  322: * shred invocation::            Remove files more securely
  323: 
  324: @c Special file types
  325: @c 
  326: 特殊なファイル形式
  327: 
  328: * link invocation::             Make a hard link via the link syscall
  329: * ln invocation::               Make links between files
  330: * mkdir invocation::            Make directories
  331: * mkfifo invocation::           Make FIFOs (named pipes)
  332: * mknod invocation::            Make block or character special files
  333: * readlink invocation::         Print the referent of a symbolic link
  334: * rmdir invocation::            Remove empty directories
  335: * unlink invocation::           Remove files via unlink syscall
  336: 
  337: @c Changing file attributes
  338: @c 
  339: ファイルの属性を変更する
  340: 
  341: * chown invocation::            Change file owner and group
  342: * chgrp invocation::            Change group ownership
  343: * chmod invocation::            Change access permissions
  344: * touch invocation::            Change file timestamps
  345: 
  346: @c Disk usage
  347: @c 
  348: ディスクの利用状況
  349: 
  350: * df invocation::               Report filesystem disk space usage
  351: * du invocation::               Estimate file space usage
  352: * stat invocation::             Report file or filesystem status
  353: * sync invocation::             Synchronize data on disk with memory
  354: 
  355: @c Printing text
  356: @c 
  357: テキストの出力
  358: 
  359: * echo invocation::             Print a line of text
  360: * printf invocation::           Format and print data
  361: * yes invocation::              Print a string until interrupted
  362: 
  363: @c Conditions
  364: @c 
  365: 条件文
  366: 
  367: * false invocation::              Do nothing, unsuccessfully
  368: * true invocation::               Do nothing, successfully
  369: * test invocation::               Check file types and compare values
  370: * expr invocation::               Evaluate expressions
  371: 
  372: @c @command{test}: Check file types and compare values
  373: @c 
  374: @command{test}: ファイル形式の調査と値の比較
  375: 
  376: * File type tests::               File type tests
  377: * Access permission tests::       Access permission tests
  378: * File characteristic tests::     File characteristic tests
  379: * String tests::                  String tests
  380: * Numeric tests::                 Numeric tests
  381: 
  382: @c @command{expr}: Evaluate expression
  383: @c 
  384: @command{expr}: 式の評価
  385: 
  386: * String expressions::         + : match substr index length
  387: * Numeric expressions::        + - * / %
  388: * Relations for expr::         | & < <= = == != >= >
  389: * Examples of expr::           Examples of using @command{expr}
  390: 
  391: @c Redirection
  392: @c 
  393: リダイレクト
  394: 
  395: * tee invocation::               Redirect output to multiple files
  396: 
  397: @c File name manipulation
  398: @c 
  399: ファイル名の操作
  400: 
  401: * basename invocation::          Strip directory and suffix from a file name
  402: * dirname invocation::           Strip non-directory suffix from a file name
  403: * pathchk invocation::           Check file name portability
  404: 
  405: @c Working context
  406: @c 
  407: 作業中の状況
  408: 
  409: * pwd invocation::               Print working directory
  410: * stty invocation::              Print or change terminal characteristics
  411: * printenv invocation::          Print all or some environment variables
  412: * tty invocation::               Print file name of terminal on standard input
  413: 
  414: @c @command{stty}: Print or change terminal characteristics
  415: @c 
  416: @command{stty}: 端末の特徴の出力や変更
  417: 
  418: * Control::                     Control settings
  419: * Input::                       Input settings
  420: * Output::                      Output settings
  421: * Local::                       Local settings
  422: * Combination::                 Combination settings
  423: * Characters::                  Special characters
  424: * Special::                     Special settings
  425: 
  426: @c User information
  427: @c 
  428: ユーザの情報
  429: 
  430: * id invocation::                Print real and effective uid and gid
  431: * logname invocation::           Print current login name
  432: * whoami invocation::            Print effective user id
  433: * groups invocation::            Print group names a user is in
  434: * users invocation::             Print login names of users currently logged in
  435: * who invocation::               Print who is currently logged in
  436: 
  437: @c System context
  438: @c 
  439: システムの状況
  440: 
  441: * date invocation::              Print or set system date and time
  442: * uname invocation::             Print system information
  443: * hostname invocation::          Print or set system name
  444: * hostid invocation::            Print numeric host identifier.
  445: 
  446: @c @command{date}: Print or set system date and time
  447: @c 
  448: @command{date}: システムの日時の出力と設定
  449: 
  450: * Time directives::              Time directives
  451: * Date directives::              Date directives
  452: * Literal directives::           Literal directives
  453: * Padding::                      Padding
  454: * Setting the time::             Setting the time
  455: * Options for date::             Options for @command{date}
  456: * Examples of date::             Examples of @command{date}
  457: 
  458: @c Modified command invocation
  459: @c 
  460: コマンドの呼び出しを修正
  461: 
  462: * chroot invocation::            Run a command with a different root directory
  463: * env invocation::               Run a command in a modified environment
  464: * nice invocation::              Run a command with modified scheduling priority
  465: * nohup invocation::             Run a command immune to hangups
  466: * su invocation::                Run a command with substitute user and group id
  467: 
  468: @c Process control
  469: @c 
  470: プロセス制御
  471: 
  472: * kill invocation::              Sending a signal to processes.
  473: 
  474: @c Delaying
  475: @c 
  476: 遅延
  477: 
  478: * sleep invocation::             Delay for a specified time
  479: 
  480: @c Numeric operations
  481: @c 
  482: 数学的操作
  483: 
  484: * factor invocation::            Print prime factors
  485: * seq invocation::               Print numeric sequences
  486: 
  487: @c File permissions
  488: @c 
  489: ファイルの許可
  490: 
  491: * Mode Structure::               Structure of File Permissions
  492: * Symbolic Modes::               Mnemonic permissions representation
  493: * Numeric Modes::                Permissions as octal numbers
  494: 
  495: @c Date input formats
  496: @c 
  497: 日付の入力書式
  498: 
  499: * General date syntax:           General date syntax
  500: * Calendar date items:           Calendar date items
  501: * Time of day items:             Time of day items
  502: * Time zone items:               Time zone items
  503: * Day of week items:             Day of week items
  504: * Relative items in date strings:  Relative items in date strings
  505: * Pure numbers in date strings:  Pure numbers in date strings
  506: * Authors of getdate:            Authors of getdate
  507: 
  508: @c Opening the software toolbox
  509: @c 
  510: ソフトウェアツールボックスを開く
  511: 
  512: * Toolbox introduction::         Toolbox introduction
  513: * I/O redirection::              I/O redirection
  514: * The who command::              The @command{who} command
  515: * The cut command::              The @command{cut} command
  516: * The sort command::             The @command{sort} command
  517: * The uniq command::             The @command{uniq} command
  518: * Putting the tools together::   Putting the tools together
  519: 
  520: @c GNU Free Documentation License
  521: @c 
  522: * How to use this License for your documents::
  523: 
  524: @end detailmenu
  525: @end menu
  526: 
  527: 
  528: @node Introduction
  529: @c @chapter Introduction
  530: @chapter はじめに
  531: 
  532: @c This manual is a work in progress: many sections make no attempt to explain
  533: @c basic concepts in a way suitable for novices.  Thus, if you are interested,
  534: @c please get involved in improving this manual.  The entire @sc{gnu} community
  535: @c will benefit.
  536: @c 
  537: このマニュアルは作業中です.初心者に適した方法で,基本的な概念を説明し
  538: ようとしていないセクションもたくさんあります.そのため,興味があればこ
  539: のマニュアルの改善に係わってください.@sc{gnu}コミュニティ全体が利益を
  540: 得るでしょう.
  541: 
  542: @cindex @acronym{POSIX}
  543: @c The @sc{gnu} utilities documented here are mostly compatible with the
  544: @c @acronym{POSIX} standard.
  545: @c 
  546: @sc{gnu}ユーティリティは,以下のようにほとんど@acronym{POSIX}標準と互
  547: 換性があると説明されています.
  548: @cindex bugs, reporting
  549: @c Please report bugs to @email{bug-coreutils@@gnu.org}.  Remember
  550: @c to include the version number, machine architecture, input files, and
  551: @c any other information needed to reproduce the bug: your input, what you
  552: @c expected, what you got, and why it is wrong.  Diffs are welcome, but
  553: @c please include a description of the problem as well, since this is
  554: @c sometimes difficult to infer. @xref{Bugs, , , gcc, Using and Porting GNU CC}.
  555: @c 
  556: バグを@email{bug-coreutils@@gnu.org}に報告してください.バージョンナン
  557: バー,マシンアーキテクチャ,入力ファイル,そしてバグの再現に必要なその
  558: 他のあらゆる情報含めることを忘れないでください.入力,期待したもの,得
  559: たもの,そして間違っている理由です.差分は歓迎しますが,推測が難しいと
  560: きもあるので,問題の記述も含めてください.@xref{Bugs, , , gcc, Using
  561: and Porting GNU CC}.
  562: 
  563: @cindex Berry, K.
  564: @cindex Paterson, R.
  565: @cindex Stallman, R.
  566: @cindex Pinard, F.
  567: @cindex MacKenzie, D.
  568: @cindex Meyering, J.
  569: @cindex Youmans, B.
  570: @c This manual was originally derived from the Unix man pages in the
  571: @c distributions, which were written by David MacKenzie and updated by Jim
  572: @c Meyering.  What you are reading now is the authoritative documentation
  573: @c for these utilities; the man pages are no longer being maintained.  The
  574: @c original @command{fmt} man page was written by Ross Paterson.  Fran@,{c}ois
  575: @c Pinard did the initial conversion to Texinfo format.  Karl Berry did the
  576: @c indexing, some reorganization, and editing of the results.  Brian
  577: @c Youmans of the Free Software Foundation office staff combined the
  578: @c manuals for textutils, fileutils, and sh-utils to produce the present
  579: @c omnibus manual.  Richard Stallman contributed his usual invaluable
  580: @c insights to the overall process.
  581: @c 
  582: このマニュアルは配布物のUNIX man pageを元にしていて,それは,元々David
  583: MacKenzieによって書かれ,Jim Meyeringによって更新されました.現在読ん
  584: でいるものは,これらのユーティリティの権威のあるドキュメントです.man
  585: pageは,既に管理されていません.元となる@command{fmt}のman pageは,
  586: Ross Patersonによって書かれました.Fran@,{c}ois Pinardは,Texinfo書式
  587: への最初の変換を行いました.Karl Berryは索引の追加,いくつかの再編成,
  588: そして結果の編集を行いました.Free Software Foundationの事務所のスタッ
  589: フBrian Youmansは,現在のオムニバスのマニュアルを生成するため,
  590: textutils,fileutils,そしてsh-utilsのマニュアルを統合しました.
  591: Richard Stallmanは,全体的なプロセスに,彼のいつもの貴重な洞察を寄稿し
  592: ました.
  593: 
  594: @node Common options
  595: @c @chapter Common options
  596: @chapter 共通のオプション
  597: 
  598: @cindex common options
  599: 
  600: @c Certain options are available in all of these programs.  Rather than
  601: @c writing identical descriptions for each of the programs, they are
  602: @c described here.  (In fact, every @sc{gnu} program accepts (or should accept)
  603: @c these options.)
  604: @c 
  605: 特定のオプションは,以下のすべてのプログラムで利用可能です.それぞれの
  606: プログラムで同一の記述を書く代わりに以下で記述します.(実際,すべての
  607: @sc{gnu}プログラムが,これらのオプションを受け入れる(あるいは受け入れ
  608: るべき)です.)
  609: 
  610: @vindex POSIXLY_CORRECT
  611: @c Normally options and operands can appear in any order, and programs act
  612: @c as if all the options appear before any operands.  For example,
  613: @c @samp{sort -r passwd -t :} acts like @samp{sort -r -t : passwd}, since
  614: @c @samp{:} is an option-argument of @option{-t}.  However, if the
  615: @c @env{POSIXLY_CORRECT} environment variable is set, options must appear
  616: @c before operands, unless otherwise specified for a particular command.
  617: @c 
  618: 通常,オプションとオペランドは任意の順序で書くことが可能で,プログラムは
  619: すべてのオプションがあらゆるオペランドの前に書かれているかのように動作し
  620: ます.例えば,@samp{sort -r passwd -t :}は@samp{sort -r -t : passwd}のよ
  621: うに動作し,それは@samp{:}が@option{-t}のオプション引数であるためです.
  622: しかし,@env{POSIXLY_CORRECT}環境変数が設定されている場合,特定のコマン
  623: ドで指定ない場合,オプションをオペランドの前に書く必要があります.
  624: 
  625: @c Some of these programs recognize the @option{--help} and @option{--version}
  626: @c options only when one of them is the sole command line argument.
  627: @c 
  628: これらのプログラムには,@option{--help}と@option{--version}が単一のコ
  629: マンドライン引数のときだけ,それを認識するものもあります.
  630: 
  631: @table @samp
  632: 
  633: @item --help
  634: @opindex --help
  635: @cindex help, online
  636: @c Print a usage message listing all available options, then exit successfully.
  637: @c 
  638: すべての利用可能なオプションをリストアップした使用方法のメッセージを出
  639: 力し,正しく終了します.
  640: 
  641: @item --version
  642: @opindex --version
  643: @cindex version number, finding
  644: @c Print the version number, then exit successfully.
  645: @c 
  646: バージョンナンバーを出力して,正しく終了します.
  647: 
  648: @item --
  649: @opindex --
  650: @cindex option delimiter
  651: @c Delimit the option list.  Later arguments, if any, are treated as
  652: @c operands even if they begin with @samp{-}.  For example, @samp{sort --
  653: @c -r} reads from the file named @file{-r}.
  654: @c 
  655: オプションリストを区切ります.それ以降の引数は何であろうと,たとえ
  656: @samp{-}で始まる場合でもオペランドとして扱われます.例えば,@samp{sort
  657: -- -r}は@file{-r}という名前のファイルから読み込みます.
  658: 
  659: @end table
  660: 
  661: @cindex standard input
  662: @cindex standard output
  663: @c A single @samp{-} is not really an option, though it looks like one.  It
  664: @c stands for standard input, or for standard output if that is clear from
  665: @c the context, and it can be used either as an operand or as an
  666: @c option-argument.  For example, @samp{sort -o - -} outputs to standard
  667: @c output and reads from standard input, and is equivalent to plain
  668: @c @samp{sort}.  Unless otherwise specified, @samp{-} can appear in any
  669: @c context that requires a file name.
  670: @c 
  671: 単一の@samp{-}は,オプションのように見えても本当のオプションではありま
  672: せん.状況から明らかな場合は,それは標準入力や標準出力を意味し,オペラ
  673: ンドやオプション引数として使用可能です.例えば,@samp{sort -o - -}は標
  674: 準出力に書き出し,標準入力から読み込み,そしてそれは単なる
  675: @command{sort}と等価です.他で指定されない限り,ファイル名が要求される
  676: あらゆる状況で@samp{-}を書くことが可能です.
  677: 
  678: @menu
  679: * Exit status::                 Indicating program success or failure.
  680: * Backup options::              -b -S -V, in some programs.
  681: * Block size::                  BLOCK_SIZE and --block-size, in some programs.
  682: * Target directory::            --target-directory, in some programs.
  683: * Trailing slashes::            --strip-trailing-slashes, in some programs.
  684: * Standards conformance::       Conformance to the @acronym{POSIX} standard.
  685: @end menu
  686: 
  687: 
  688: @node Exit status
  689: @c @section Exit status
  690: @section 終了ステータス
  691: 
  692: @c Nearly every command invocation yields an integral @dfn{exit status}
  693: @c that can be used to change how other commands work.
  694: @c For the vast majority of commands, an exit status of zero indicates
  695: @c success, and a value of @samp{1} indicates failure.
  696: @c However, some of the programs documented here do produce
  697: @c other exit status values and a few associate different
  698: @c meanings with the values @samp{0} and @samp{1}.
  699: @c Here are some of the exceptions:
  700: @c @command{expr}, @command{false}, @command{nohup}, @command{printenv},
  701: @c @command{sort}, @command{test}, @command{true}, @command{tty},
  702: @c @command{uniq}.
  703: @c 
  704: ほとんどすべてのコマンドの呼び出しは,他のコマンドの動作を変更するため
  705: にしよう可能な,正規の@dfn{終了ステータス(exit status)}を生成します.
  706: コマンドの大半は,ゼロの終了ステータスは成功を示し,@samp{1}の値は失敗
  707: を示します.しかし,以下で説明されているプログラムには,それ以外の終了
  708: ステータスの値を生成するものや,@samp{0}と@samp{1}の値に異なる意味を割
  709: り当てているものもあります.例外は以下の通りです.@command{expr},
  710: @command{false},@command{nohup},@command{printenv},@command{sort},
  711: @command{test},@command{true},@command{tty},@command{uniq}.
  712: 
  713: @node Backup options
  714: @c @section Backup options
  715: @section バックアップオプション
  716: 
  717: @cindex backup options
  718: 
  719: @c Some @sc{gnu} programs (at least @command{cp}, @command{install},
  720: @c @command{ln}, and @command{mv}) optionally make backups of files
  721: @c before writing new versions.
  722: @c These options control the details of these backups.  The options are also
  723: @c briefly mentioned in the descriptions of the particular programs.
  724: @c 
  725: @sc{gnu}プログラムには(少なくとも,@command{cp},@command{install},
  726: @command{ln},そして@command{mv}には)オプションで,新しいバージョンの
  727: ファイルを書き出す前に,ファイルのバックアップを作成するものもあります.
  728: 以下のオプションは,これらのバックアップを細かく制御します.オプション
  729: は,特定のプログラムの説明でも簡単に記述します.
  730: 
  731: @table @samp
  732: 
  733: @item -b
  734: @itemx @w{@kbd{--backup}[=@var{method}]}
  735: @opindex -b
  736: @opindex --backup
  737: @vindex VERSION_CONTROL
  738: @cindex backups, making
  739: @c Make a backup of each file that would otherwise be overwritten or removed.
  740: @c Without this option, the original versions are destroyed.
  741: @c Use @var{method} to determine the type of backups to make.
  742: @c When this option is used but @var{method} is not specified,
  743: @c then the value of the @env{VERSION_CONTROL}
  744: @c environment variable is used.  And if @env{VERSION_CONTROL} is not set,
  745: @c the default backup type is @samp{existing}.
  746: @c 
  747: バックアップを作成しないと上書きされたり削除されたりするそれぞれのファ
  748: イルのバックアップを作成します.このオプションを用いないと,オリジナル
  749: のバージョンは破棄されます.作成するバックアップの形式を決定するために,
  750: @var{method}を使用してください.このオプションが使用されていて,
  751: @var{method}が指定されていないとき,@env{VERSION_CONTROL}環境変数の値
  752: が使用されます.そして@env{VERSION_CONTROL}が設定されていない場合は,
  753: デフォルトのバックアップ形式は@samp{existing}になります.
  754: 
  755: @c Note that the short form of this option, @option{-b} does not accept any
  756: @c argument.  Using @option{-b} is equivalent to using @option{--backup=existing}.
  757: @c 
  758: このオプションの短い形式@option{-b}は,引数を全く受け入れないことに注
  759: 意してください.@option{-b}の使用は,@option{--backup=existing}の使用
  760: と等価です.
  761: 
  762: @vindex version-control @r{Emacs variable}
  763: @c This option corresponds to the Emacs variable @samp{version-control};
  764: @c the values for @var{method} are the same as those used in Emacs.
  765: @c This option also accepts more descriptive names.
  766: @c The valid @var{method}s are (unique abbreviations are accepted):
  767: @c 
  768: このオプションは,Emacs変数の@samp{version-control}に対応します.
  769: @var{method}に対する値は,Emacsで使用されるものと同じです.このオプショ
  770: ンも,より記述的な名前を受け入れます.有効な@var{method}は以下の通りで
  771: す(ユニークに識別できる省略も受け入れます).
  772: 
  773: @table @samp
  774: @item none
  775: @itemx off
  776: @opindex none @r{backup method}
  777: @c Never make backups.
  778: @c 
  779: バックアップを作成しません.
  780: 
  781: @item numbered
  782: @itemx t
  783: @opindex numbered @r{backup method}
  784: @c Always make numbered backups.
  785: @c 
  786: 常に番号付のバックアップを作成します.
  787: 
  788: @item existing
  789: @itemx nil
  790: @opindex existing @r{backup method}
  791: @c Make numbered backups of files that already have them, simple backups
  792: @c of the others.
  793: @c 
  794: 既に番号付のバックアップファイルがある場合,番号付のバックアップを作成
  795: し,それ以外では単純にバックアップします.
  796: 
  797: @item simple
  798: @itemx never
  799: @opindex simple @r{backup method}
  800: @c Always make simple backups.  Please note @samp{never} is not to be
  801: @c confused with @samp{none}.
  802: @c 
  803: 常に単純なバックアップを作成します.@samp{never}と@samp{none}を混同し
  804: ないように注意してください.
  805: 
  806: @end table
  807: 
  808: @item -S @var{suffix}
  809: @itemx --suffix=@var{suffix}
  810: @opindex -S
  811: @opindex --suffix
  812: @cindex backup suffix
  813: @vindex SIMPLE_BACKUP_SUFFIX
  814: @c Append @var{suffix} to each backup file made with @option{-b}.  If this
  815: @c option is not specified, the value of the @env{SIMPLE_BACKUP_SUFFIX}
  816: @c environment variable is used.  And if @env{SIMPLE_BACKUP_SUFFIX} is not
  817: @c set, the default is @samp{~}, just as in Emacs.
  818: @c 
  819: @option{-b}で作成されるそれぞれのバックアップファイルに@var{suffix}を
  820: 追加します.このオプションが指定されていない場合,
  821: @env{SIMPLE_BACKUP_SUFFIX}環境変数の値が使用されます.そして
  822: @env{SIMPLE_BACKUP_SUFFIX}が設定されていない場合,デフォルトで@samp{~}
  823: となり,それはちょうどEmacsと同じです.
  824: 
  825: @itemx --version-control=@var{method}
  826: @opindex --version-control
  827: @c FIXME: remove this block one or two releases after the actual
  828: @c removal from the code.
  829: @c This option is obsolete and will be removed in a future release.
  830: @c It has been replaced with @w{@kbd{--backup}}.
  831: @c 
  832: このオプションは時代遅れで,将来のリリースで削除されるでしょう.それは,
  833: @w{@kbd{--backup}}で置き換えられました.
  834: 
  835: @end table
  836: 
  837: @node Block size
  838: @c @section Block size
  839: @section ブロックサイズ
  840: 
  841: @cindex block size
  842: 
  843: @c Some @sc{gnu} programs (at least @command{df}, @command{du}, and
  844: @c @command{ls}) display sizes in ``blocks''.  You can adjust the block size
  845: @c and method of display to make sizes easier to read.  The block size
  846: @c used for display is independent of any filesystem block size.
  847: @c Fractional block counts are rounded up to the nearest integer.
  848: @c 
  849: @sc{gnu}プログラム(少なくとも,@command{df},@command{du},そして
  850: @command{ls})には,ファイルサイズを``ブロック''で表示するものもありま
  851: す.ファイルサイズをより読みやすくするため,ブロックサイズを調整するこ
  852: とが可能です.表示で使用するブロックサイズは,あらゆるファイルシステム
  853: のブロックサイズから独立しています.分数のブロック数は最も近い整数に切
  854: り上げられます.
  855: 
  856: @opindex --block-size=@var{size}
  857: @vindex BLOCK_SIZE
  858: @vindex DF_BLOCK_SIZE
  859: @vindex DU_BLOCK_SIZE
  860: @vindex LS_BLOCK_SIZE
  861: @vindex POSIXLY_CORRECT@r{, and block size}
  862: 
  863: @c The default block size is chosen by examining the following environment
  864: @c variables in turn; the first one that is set determines the block size.
  865: @c 
  866: デフォルトのブロックサイズは,以下の環境変数を順番に調べることで選択さ
  867: れます.最初に設定されていたものでブロックサイズを決定します.
  868: 
  869: @table @code
  870: 
  871: @item DF_BLOCK_SIZE
  872: @c This specifies the default block size for the @command{df} command.
  873: @c Similarly, @env{DU_BLOCK_SIZE} specifies the default for @command{du} and
  874: @c @env{LS_BLOCK_SIZE} for @command{ls}.
  875: @c 
  876: これは,@command{df}コマンドに対するデフォルトのブロックサイズを指定し
  877: ます.同様に,@env{DU_BLOCK_SIZE}は@command{du}に対するデフォルト,そ
  878: して@env{LS_BLOCK_SIZE}は@command{ls}に対するデフォルトを指定します.
  879: 
  880: @item BLOCK_SIZE
  881: @c This specifies the default block size for all three commands, if the
  882: @c above command-specific environment variables are not set.
  883: @c 
  884: 上記のコマンド指定の環境変数が設定されていない場合,これは,三つのコマ
  885: ンド全てに対するデフォルトのブロックサイズを指定します.
  886: 
  887: @item POSIXLY_CORRECT
  888: @c If neither the @env{@var{command}_BLOCK_SIZE} nor the @env{BLOCK_SIZE}
  889: @c variables are set, but this variable is set, the block size defaults to 512.
  890: @c 
  891: @env{@var{command}_BLOCK_SIZE}も@env{BLOCK_SIZE}変数も設定されておらず,
  892: この変数が設定されている場合,ブロックサイズのデフォルトは512になりま
  893: す.
  894: 
  895: @end table
  896: 
  897: @c If none of the above environment variables are set, the block size
  898: @c currently defaults to 1024 bytes in most contexts, but this number may
  899: @c change in the future.  For @command{ls} file sizes, the block size
  900: @c defaults to 1 byte.
  901: @c 
  902: 上記の環境変数がどれも設定されていない場合,ほとんどの状況でブロックサ
  903: イズは現在のデフォルトの1024バイトですが,この数は将来変更されるかもし
  904: れません.@command{ls}のファイルサイズに対して,ブロックサイズのデフォ
  905: ルトは1バイトです.
  906: 
  907: @cindex human-readable output
  908: @cindex SI output
  909: 
  910: @c A block size specification can be a positive integer specifying the number
  911: @c of bytes per block, or it can be @code{human-readable} or @code{si} to
  912: @c select a human-readable format.  Integers may be followed by suffixes
  913: @c that are upward compatible with the
  914: @c @uref{http://www.bipm.fr/enus/3_SI/si-prefixes.html, SI prefixes}
  915: @c for decimal multiples and with the
  916: @c @uref{http://physics.nist.gov/cuu/Units/binary.html, IEC 60027-2
  917: @c prefixes for binary multiples}.
  918: @c 
  919: ブロックサイズの指定は,ブロックごとのバイト数の指定で正の整数にしたり,
  920: 人間が可読な書式を選択して@code{human-readable}や@code{si}にしたりする
  921: ことが可能です.整数には,十進数の倍数となる
  922: @uref{http://www.bipm.fr/enus/3_SI/si-prefixes.html, SI prefixes}の上
  923: 位互換の接尾子を続けたり,
  924: @uref{http://physics.nist.gov/cuu/Units/binary.html, IEC 60027-2
  925: prefixes for binary multiples}が続けてもかまいません.
  926: 
  927: @c With human-readable formats, output sizes are followed by a size letter
  928: @c such as @samp{M} for megabytes.  @code{BLOCK_SIZE=human-readable} uses
  929: @c powers of 1024; @samp{M} stands for 1,048,576 bytes.
  930: @c @code{BLOCK_SIZE=si} is similar, but uses powers of 1000 and appends
  931: @c @samp{B}; @samp{MB} stands for 1,000,000 bytes.
  932: @c 
  933: 人間が可読な書式を用いると,出力サイズにはメガバイトに対する@samp{M}の
  934: ような大きさを示す文字が続きます.@code{BLOCK_SIZE=human-readable}は
  935: 1024乗を使用します.@samp{M}は1,048,576バイトを意味します.
  936: @code{BLOCK_SIZE=si}は似ていますが,それは1000乗を使用し@samp{B}が後置
  937: されます.@samp{MB}は1,000,000を意味します.
  938: 
  939: @vindex LC_NUMERIC
  940: @c A block size specification preceded by @samp{'} causes output sizes to
  941: @c be displayed with thousands separators.  The @env{LC_NUMERIC} locale
  942: @c specifies the thousands separator and grouping.  For example, in an
  943: @c American English locale, @samp{--block-size="'1kB"} would cause a size
  944: @c of 1234000 bytes to be displayed as @samp{1,234}.  In the default C
  945: @c locale, there is no thousands separator so a leading @samp{'} has no
  946: @c effect.
  947: @c 
  948: @samp{'}が前置されているブロックサイズの指定で,千単位で区切られた大き
  949: さを表示するようになります.@env{LC_NUMERIC}ロケールは,千の分離子とグ
  950: ループ分けを指定します.例えば,アメリカ英語のロケールでは,
  951: @samp{--block-size="'1kB"}で1234000バイトの大きさを@samp{1,234}と表示
  952: するようになるでしょう.デフォルトのCロケールでは,千単位の区切りが無
  953: いので,@samp{'}には効果がありません.
  954: 
  955: @c An integer block size can be followed by a suffix to specify a
  956: @c multiple of that size.  A bare size letter,
  957: @c or one followed by @samp{iB}, specifies
  958: @c a multiple using powers of 1024.  A size letter followed by @samp{B}
  959: @c specifies powers of 1000 instead.  For example, @samp{1M} and
  960: @c @samp{1MiB} are equivalent to @samp{1048576}, whereas @samp{1MB} is
  961: @c equivalent to @samp{1000000}.
  962: @c 
  963: 整数のブロックサイズは,そのサイズの倍数を指定する接尾子を続けることが
  964: 可能です.そのままの大きさを示す文字や@samp{iB}が続くものは,1024倍を
  965: 指定します.@samp{B}が続く大きさを示す文字は,代わりに1000倍を指定しま
  966: す.例えば,@samp{1M}と@samp{1MiB}は@samp{1048576}と等価で,@samp{1MB}
  967: は@samp{1000000}と等価です.
  968: 
  969: @c A plain suffix without a preceding integer acts as if @samp{1} were
  970: @c prepended, except that it causes a size indication to be appended to
  971: @c the output.  For example, @samp{--block-size="kB"} displays 3000 as
  972: @c @samp{3kB}.
  973: @c 
  974: 前置する整数が無い普通のサフィックスでは,@samp{1}が前置されているかの
  975: ように動作しますが,大きさを示す文字が出力に後置されます.例えば,
  976: @samp{--block-size="kB"}は3000を@samp{3kB}と表示します.
  977: 
  978: @c The following suffixes are defined.  Large sizes like @code{1Y}
  979: @c may be rejected by your computer due to limitations of its arithmetic.
  980: @c 
  981: 以下の大きさを示す文字が定義されています.@code{1Y}のような大きなサイ
  982: ズは,その計算の限界のためコンピュータに拒絶されるかもしれません.
  983: 
  984: @table @samp
  985: @item kB
  986: @cindex kilobyte, definition of
  987: @c kilobyte: @math{10^3 = 1000}.
  988: @c 
  989: キロバイト:@math{10^3 = 1000}.
  990: @item k
  991: @itemx K
  992: @itemx KiB
  993: @cindex kibibyte, definition of
  994: @c kibibyte: @math{2^10 = 1024}.  @samp{K} is special: the SI prefix is
  995: @c @samp{k} and the IEC 60027-2 prefix is @samp{Ki}, but tradition and
  996: @c @acronym{POSIX} use @samp{k} to mean @samp{KiB}.
  997: @c 
  998: キビバイト:@math{2^10 = 1024}.@samp{K}は特殊です.SIの接頭辞は
  999: @samp{k} で,IEC 60027-2の接頭辞は@samp{Ki}ですが,伝統的なものと
 1000: @acronym{POSIX}では,@samp{k}を@samp{KiB}の意味で使用します.
 1001: @item MB
 1002: @cindex megabyte, definition of
 1003: @c megabyte: @math{10^6 = 1,000,000}.
 1004: @c 
 1005: メガバイト:@math{10^6 = 1,000,000}.
 1006: @item M
 1007: @itemx MiB
 1008: @cindex mebibyte, definition of
 1009: @c mebibyte: @math{2^20 = 1,048,576}.
 1010: @c 
 1011: メビバイト:@math{2^20 = 1,048,576}.
 1012: @item GB
 1013: @cindex gigabyte, definition of
 1014: @c gigabyte: @math{10^9 = 1,000,000,000}.
 1015: @c 
 1016: ギガバイト:@math{10^9 = 1,000,000,000}.
 1017: @item G
 1018: @itemx GiB
 1019: @cindex gibibyte, definition of
 1020: @c gibibyte: @math{2^30 = 1,073,741,824}.
 1021: @c 
 1022: ギビバイト:@math{2^30 = 1,073,741,824}.
 1023: @item TB
 1024: @cindex terabyte, definition of
 1025: @c terabyte:  @math{10^12 = 1,000,000,000,000}.
 1026: @c 
 1027: テラバイト:@math{10^12 = 1,000,000,000,000}.
 1028: @item T
 1029: @itemx TiB
 1030: @cindex tebibyte, definition of
 1031: @c tebibyte: @math{2^40 = 1,099,511,627,776}.
 1032: @c 
 1033: テビバイト:@math{2^40 = 1,099,511,627,776}.
 1034: @item PB
 1035: @cindex petabyte, definition of
 1036: @c petabyte: @math{10^15 = 1,000,000,000,000,000}.
 1037: @c 
 1038: ペタバイト:@math{10^15 = 1,000,000,000,000,000}.
 1039: @item P
 1040: @itemx PiB
 1041: @cindex pebibyte, definition of
 1042: @c pebibyte: @math{2^50 = 1,125,899,906,842,624}.
 1043: @c 
 1044: ペビバイト:@math{2^50 = 1,125,899,906,842,624}.
 1045: @item EB
 1046: @cindex exabyte, definition of
 1047: @c exabyte: @math{10^18 = 1,000,000,000,000,000,000}.
 1048: @c 
 1049: エクサバイト:@math{10^18 = 1,000,000,000,000,000,000}.
 1050: @item E
 1051: @itemx EiB
 1052: @cindex exbibyte, definition of
 1053: @c exbibyte: @math{2^60 = 1,152,921,504,606,846,976}.
 1054: @c 
 1055: エクシビバイト:@math{2^60 = 1,152,921,504,606,846,976}.
 1056: @item ZB
 1057: @cindex zettabyte, definition of
 1058: @c zettabyte: @math{10^21 = 1,000,000,000,000,000,000,000}
 1059: @c 
 1060: ゼータバイト:@math{10^21 = 1,000,000,000,000,000,000,000}.
 1061: @item Z
 1062: @itemx ZiB
 1063: @c @math{2^70 = 1,180,591,620,717,411,303,424}.
 1064: @c (@samp{Zi} is a GNU extension to IEC 60027-2.)
 1065: @c 
 1066: @math{2^70 = 1,180,591,620,717,411,303,424}.(@samp{Zi}はIEC 60027-2へ
 1067: の@sc{gnu}の拡張です.)
 1068: @item YB
 1069: @cindex yottabyte, definition of
 1070: @c yottabyte: @math{10^24 = 1,000,000,000,000,000,000,000,000}.
 1071: @c 
 1072: ヨッタバイト:@math{10^24 = 1,000,000,000,000,000,000,000,000}.
 1073: @item Y
 1074: @itemx YiB
 1075: @c @math{2^80 = 1,208,925,819,614,629,174,706,176}.
 1076: @c (@samp{Yi} is a GNU extension to IEC 60027-2.)
 1077: @c 
 1078: @math{2^80 = 1,208,925,819,614,629,174,706,176}.(@samp{Yi}はIEC
 1079: 60027-2への@sc{gnu}の拡張です.)
 1080: @end table
 1081: 
 1082: @opindex -k
 1083: @opindex -h
 1084: @opindex --block-size
 1085: @opindex --human-readable
 1086: @opindex --si
 1087: 
 1088: @c Block size defaults can be overridden by an explicit
 1089: @c @option{--block-size=@var{size}} option.  The @option{-k}
 1090: @c option is equivalent to @option{--block-size=1K}, which
 1091: @c is the default unless the @env{POSIXLY_CORRECT} environment variable is
 1092: @c set.  The @option{-h} or @option{--human-readable} option is equivalent to
 1093: @c @option{--block-size=human-readable}.  The @option{--si} option is
 1094: @c equivalent to @option{--block-size=si}.
 1095: @c 
 1096: ブロックサイズのデフォルトは,@option{--block-size=@var{size}}オプショ
 1097: ンを明示することで優先することが可能です.@option{-k}オプションは,
 1098: @option{--block-size=1k}と等価で,それは@env{POSIXLY_CORRECT}環境変数
 1099: が指定されていない場合のデフォルトです.@option{-h}や
 1100: @option{--human-readable}オプションは,
 1101: @option{--block-size=human-readable}と等価です.@option{--si}オプショ
 1102: ンは,@option{--block-size=si}と等価です.
 1103: 
 1104: @node Target directory
 1105: @c @section Target directory
 1106: @section ターゲットディレクトリ
 1107: 
 1108: @cindex target directory
 1109: 
 1110: @c Some @sc{gnu} programs (at least @command{cp}, @command{install},
 1111: @c @command{ln}, and @command{mv}) allow you to specify the target directory
 1112: @c via this option:
 1113: @c 
 1114: @sc{gnu}プログラム(少なくとも@command{cp},@command{install},
 1115: @command{ln},そして@command{mv})には,このオプションでターゲットディ
 1116: レクトリの指定を可能にするものもあります.
 1117: 
 1118: @table @samp
 1119: 
 1120: @itemx @w{@kbd{--target-directory}=@var{directory}}
 1121: @opindex --target-directory
 1122: @cindex target directory
 1123: @cindex destination directory
 1124: @c Specify the destination @var{directory}.
 1125: @c 
 1126: 対象となる@var{directory}を指定します.
 1127: 
 1128: @c The interface for most programs is that after processing options and a
 1129: @c finite (possibly zero) number of fixed-position arguments, the remaining
 1130: @c argument list is either expected to be empty, or is a list of items
 1131: @c (usually files) that will all be handled identically.  The @command{xargs}
 1132: @c program is designed to work well with this convention.
 1133: @c 
 1134: ほとんどのプログラムのインターフェースは,オプションと有限数の(おそら
 1135: くゼロの)固定した位置の引数を処理した後,残りの引数リストは空である,
 1136: または同じように処理される(通常ファイルとなる)項目のリストになっている
 1137: ことが期待されています.@command{xargs}プログラムは,この慣習を用いて
 1138: より良く動作するように設計されています.
 1139: 
 1140: @c The commands in the @command{mv}-family are unusual in that they take
 1141: @c a variable number of arguments with a special case at the @emph{end}
 1142: @c (namely, the target directory).  This makes it nontrivial to perform some
 1143: @c operations, e.g., ``move all files from here to ../d/'', because
 1144: @c @code{mv * ../d/} might exhaust the argument space, and @code{ls | xargs ...}
 1145: @c doesn't have a clean way to specify an extra final argument for each
 1146: @c invocation of the subject command.  (It can be done by going through a
 1147: @c shell command, but that requires more human labor and brain power than
 1148: @c it should.)
 1149: @c 
 1150: 様々な数の引数の@emph{最後}に特例(すなわち,ターゲットディレクトリ)が
 1151: あるため,@command{mv}の類のコマンドは普通のものとは言えません.例えば
 1152: ``全てのファイルをここから@file{../d/}に移動する''ような処理を実行する
 1153: ために,@code{mv * ../d/}では引数の空間を使い果すかもしれませんし,
 1154: @code{ls | xargs ...}では,それぞれの従属コマンドの呼び出しへの特別な
 1155: 最後の引数を指定する方法がないため,明確ではなくなります.(それは,シェ
 1156: ルコマンドで動作させることが可能ですが,人間の労働と能力が余分に必要と
 1157: なります.)
 1158: 
 1159: @c The @w{@kbd{--target-directory}} option allows the @command{cp},
 1160: @c @command{install}, @command{ln}, and @command{mv} programs to be used
 1161: @c conveniently with @command{xargs}.  For example, you can move the files
 1162: @c from the current directory to a sibling directory, @code{d} like this:
 1163: @c (However, this doesn't move files whose names begin with @samp{.}.)
 1164: @c 
 1165: @w{@kbd{--target-directory}}オプションによって,@command{cp},
 1166: @command{install},@command{ln},そして@command{mv}プログラムで,
 1167: @command{xargs}を用いて便利に使用することが可能になります.例えば,現
 1168: 在のディレクトリから同じ階層のディレクトリ,ここでは@code{d}に,ファイ
 1169: ルを移動することが可能です.(しかし,これは@samp{.}で始まる名前のファ
 1170: イルを移動しません.)
 1171: 
 1172: @smallexample
 1173: ls |xargs mv --target-directory=../d
 1174: @end smallexample
 1175: 
 1176: @c If you use the @sc{gnu} @command{find} program, you can move @emph{all}
 1177: @c files with this command:
 1178: @c 
 1179: @sc{gnu} @command{find}プログラムを使用している場合,以下のコマンドで
 1180: @emph{全ての}ファイルを移動することが可能です.
 1181: @example
 1182: find . -mindepth 1 -maxdepth 1 \
 1183:   | xargs mv --target-directory=../d
 1184: @end example
 1185: 
 1186: @c But that will fail if there are no files in the current directory
 1187: @c or if any file has a name containing a newline character.
 1188: @c The following example removes those limitations and requires both
 1189: @c @sc{gnu} @command{find} and @sc{gnu} @command{xargs}:
 1190: @c 
 1191: しかし,現在のディレクトリにファイルがない場合や,改行文字を含む名前の
 1192: ファイルがある場合,それは失敗するでしょう.以下の例は,これらの制限を
 1193: 取り除きますが,@sc{gnu} @command{find}と@sc{gnu} @command{xargs}の両
 1194: 方を必要とします.
 1195: @example
 1196: find . -mindepth 1 -maxdepth 1 -print0 \
 1197:   | xargs --null --no-run-if-empty \
 1198:       mv --target-directory=../d
 1199: @end example
 1200: 
 1201: @end table
 1202: 
 1203: @node Trailing slashes
 1204: @c @section Trailing slashes
 1205: @section 末尾のスラッシュ
 1206: 
 1207: @cindex trailing slashes
 1208: 
 1209: @c Some @sc{gnu} programs (at least @command{cp} and @command{mv}) allow you to
 1210: @c remove any trailing slashes from each @var{source} argument before
 1211: @c operating on it.  The @w{@kbd{--strip-trailing-slashes}} option enables
 1212: @c this behavior.
 1213: @c 
 1214: @sc{gnu}プログラム(少なくとも@command{cp}と@command{mv})には,それぞれ
 1215: の@var{source}引数を処理する前に末尾のスラッシュを取り除くことが可能な
 1216: ものもあります.@w{@kbd{--strip-trailing-slashes}}オプションはこの動作
 1217: を可能にします.
 1218: 
 1219: @c This is useful when a @var{source} argument may have a trailing slash and
 1220: @c @c FIXME: mv's behavior in this case is system-dependent
 1221: @c specify a symbolic link to a directory.  This scenario is in fact rather
 1222: @c common because some shells can automatically append a trailing slash when
 1223: @c performing file name completion on such symbolic links.  Without this
 1224: @c option, @command{mv}, for example, (via the system's rename function) must
 1225: @c interpret a trailing slash as a request to dereference the symbolic link
 1226: @c and so must rename the indirectly referenced @emph{directory} and not
 1227: @c the symbolic link.  Although it may seem surprising that such behavior
 1228: @c be the default, it is required by @acronym{POSIX} and is consistent with
 1229: @c other parts of that standard.
 1230: @c 
 1231: @var{source}引数の末尾にスラッシュがあり,ディレクトリへのシンボリック
 1232: リンクを指定しているとき,これは役に立ちます.シェルにはシンボリックリ
 1233: ンクのようなものに対してファイル名の補完を実行しているとき,末尾のスラッ
 1234: シュを自動的に追加することが可能なものもあるので,このシナリオは現実と
 1235: なります.このオプションがない場合,例えば(システムの名前変更機能のた
 1236: め)@command{mv}は,末尾のスラッシュをシンボリックリンク先を参照しない
 1237: ように要求するよう解釈する必要があり,そして,そのためシンボリックリン
 1238: クではなく,間接的に参照される@emph{ディレクトリ}の名前を変更するはず
 1239: です.そのような動作がデフォルトということにびっくりするかもしれません
 1240: が,それは@acronym{POSIX}で要求されていて,その標準のそれ以外の部分と
 1241: 一貫しています.
 1242: 
 1243: @node Standards conformance
 1244: @c @section Standards conformance
 1245: @section 標準への準拠
 1246: 
 1247: @vindex POSIXLY_CORRECT
 1248: @c In a few cases, the @sc{gnu} utilities' default behavior is
 1249: @c incompatible with the @acronym{POSIX} standard.  To suppress these
 1250: @c incompatibilities, define the @env{POSIXLY_CORRECT} environment
 1251: @c variable.  Unless you are checking for @acronym{POSIX} conformance, you
 1252: @c probably do not need to define @env{POSIXLY_CORRECT}.
 1253: @c 
 1254: 状況によっては,@sc{gnu}のユーティリティのデフォルトの動作は
 1255: @acronym{POSIX}の標準と互換性がありません.これらの非互換性を抑制する
 1256: ため,@env{POSIXLY_CORRECT}環境変数を定義してください.@acronym{POSIX}
 1257: 準拠を調査していない限り,@env{POSIXLY_CORRECT}を定義する必要はありま
 1258: せん.
 1259: 
 1260: @c Newer versions of @acronym{POSIX} are occasionally incompatible with older
 1261: @c versions.  For example, older versions of @acronym{POSIX} required the
 1262: @c command @samp{sort +1} to sort based on the second and succeeding
 1263: @c fields in each input line, but starting with @acronym{POSIX} 1003.1-2001
 1264: @c the same command is required to sort the file named @file{+1}, and you
 1265: @c must instead use the command @samp{sort -k 2} to get the field-based
 1266: @c sort.
 1267: @c 
 1268: 新しいバージョンの@acronym{POSIX}には,古いバージョンのものと互換性が
 1269: 無いものもあります.例えば,古いバージョンの@acronym{POSIX}では,それ
 1270: ぞれの入力ファイルの二番目とそれ以降のフィールドをもとにソートするコマ
 1271: ンド@samp{sort +1}を要求していますが,@acronym{POSIX} 1003.1-2001から
 1272: は同じコマンドで@file{+1}という名前のファイルをソートすることを要求し
 1273: ていて,フィールドをもとにしたソートを行なうため,コマンド@samp{sort
 1274: -k 2}を代わりに使用する必要があります.
 1275: 
 1276: @vindex _POSIX2_VERSION
 1277: @c The @sc{gnu} utilities normally conform to the version of @acronym{POSIX}
 1278: @c that is standard for your system.  To cause them to conform to a
 1279: @c different version of @acronym{POSIX}, define the @env{_POSIX2_VERSION}
 1280: @c environment variable to a value of the form @var{yyyymm} specifying
 1281: @c the year and month the standard was adopted.  Two values are currently
 1282: @c supported for @env{_POSIX2_VERSION}: @samp{199209} stands for
 1283: @c @acronym{POSIX} 1003.2-1992, and @samp{200112} stands for @acronym{POSIX}
 1284: @c 1003.1-2001.  For example, if you are running older software that
 1285: @c assumes an older version of @acronym{POSIX} and uses @samp{sort +1}, you
 1286: @c can work around the compatibility problems by setting
 1287: @c @samp{_POSIX2_VERSION=199209} in your environment.
 1288: @c 
 1289: @sc{gnu}のユーティリティは通常,システム標準の@acronym{POSIX}のバージョ
 1290: ンに準拠しています.異なる@acronym{POSIX}のバージョンに準拠させるため,
 1291: 適用させる標準の年月を指定する@var{yyyymm}の形式の値に
 1292: @env{_POSIX2_VERSION}環境変数を設定してください.現在,
 1293: @env{_POSIX2_VERSION}に対して二つの値がサポートされています.
 1294: @samp{199209}は@acronym{POSIX} 1003.2-1992を意味し,@samp{200112}は
 1295: @acronym{POSIX} 1003.1-2001を意味します.例えば,古いバージョンの
 1296: @acronym{POSIX}を仮定する古いソフトウェアを実行し,@samp{sort +1}を使
 1297: 用している場合,環境変数で@samp{_POSIX2_VERSION=199209}を設定すること
 1298: で,互換性の問題を回避することが可能です.
 1299: 
 1300: @node Output of entire files
 1301: @c @chapter Output of entire files
 1302: @chapter ファイル全体の出力
 1303: 
 1304: @cindex output of entire files
 1305: @cindex entire files, output of
 1306: 
 1307: @c These commands read and write entire files, possibly transforming them
 1308: @c in some way.
 1309: @c 
 1310: 以下のコマンドは,いくつかの方法で,おそらくファイルを変換しながら,ファ
 1311: イル全体を読み込み,そして書き出します.
 1312: 
 1313: @menu
 1314: * cat invocation::              Concatenate and write files.
 1315: * tac invocation::              Concatenate and write files in reverse.
 1316: * nl invocation::               Number lines and write files.
 1317: * od invocation::               Write files in octal or other formats.
 1318: @end menu
 1319: 
 1320: @node cat invocation
 1321: @c @section @command{cat}: Concatenate and write files
 1322: @section @command{cat}: ファイルを連結し書き込む
 1323: 
 1324: @pindex cat
 1325: @cindex concatenate and write files
 1326: @cindex copying files
 1327: 
 1328: @c @command{cat} copies each @var{file} (@samp{-} means standard input), or
 1329: @c standard input if none are given, to standard output.  Synopsis:
 1330: @c 
 1331: @command{cat}は,それぞれの@var{file}(@samp{-}は標準入力を意味します)
 1332: や,与えられない場合は標準入力を標準出力へコピーします.概要です.
 1333: 
 1334: @example
 1335: cat [@var{option}] [@var{file}]@dots{}
 1336: @end example
 1337: 
 1338: @c The program accepts the following options.  Also see @ref{Common options}.
 1339: @c 
 1340: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 1341: してください.
 1342: 
 1343: @table @samp
 1344: 
 1345: @item -A
 1346: @itemx --show-all
 1347: @opindex -A
 1348: @opindex --show-all
 1349: @c Equivalent to @option{-vET}.
 1350: @c 
 1351: @option{-vET}と等価です.
 1352: 
 1353: @item -B
 1354: @itemx --binary
 1355: @opindex -B
 1356: @opindex --binary
 1357: @cindex binary and text I/O in cat
 1358: @c On MS-DOS and MS-Windows only, read and write the files in binary mode.
 1359: @c By default, @command{cat} on MS-DOS/MS-Windows uses binary mode only when
 1360: @c standard output is redirected to a file or a pipe; this option overrides
 1361: @c that.  Binary file I/O is used so that the files retain their format
 1362: @c (Unix text as opposed to DOS text and binary), because @command{cat} is
 1363: @c frequently used as a file-copying program.  Some options (see below)
 1364: @c cause @command{cat} to read and write files in text mode because in those
 1365: @c cases the original file contents aren't important (e.g., when lines are
 1366: @c numbered by @command{cat}, or when line endings should be marked).  This is
 1367: @c so these options work as DOS/Windows users would expect; for example,
 1368: @c DOS-style text files have their lines end with the CR-LF pair of
 1369: @c characters, which won't be processed as an empty line by @option{-b} unless
 1370: @c the file is read in text mode.
 1371: @c 
 1372: MS-DOSとMS-Windowsのみで,ファイルをバイナリモードで読み書きします.デ
 1373: フォルトで,MS-DOS/MS-Windowsでの@command{cat}は,標準出力がファイルや
 1374: パイプにリダイレクトされているときだけ,バイナリモードを使用します.こ
 1375: のオプションはそれに優先します.バイナリファイルのI/Oでは,
 1376: @command{cat}はファイルのコピープログラムとして使用されることが多いの
 1377: で,それらの書式(DOSテキストとバイナリに対するUnixテキスト)を保つため
 1378: に使われます.(以下の)オプションには,元ファイルの内容が重要でないとき
 1379: には,@command{cat}にテキストモードでファイルを読み書きさせるものもあ
 1380: ります(例えば,行が@command{cat}で番号付けされるときや行の終りに印を付
 1381: けるとき).これは,これらのオプションをDOS/Windowsユーザが期待したよう
 1382: に動作させるためのものです.例えば,DOS形式のテキストファイルは,テキ
 1383: ストモードで読まれない場合,@option{-b}で空の行として扱われない,CR-LF 
 1384: というペアの文字が行末にあります.
 1385: 
 1386: @item -b
 1387: @itemx --number-nonblank
 1388: @opindex -b
 1389: @opindex --number-nonblank
 1390: @c Number all nonblank output lines, starting with 1.  On MS-DOS and
 1391: @c MS-Windows, this option causes @command{cat} to read and write files in
 1392: @c text mode.
 1393: @c 
 1394: 空白でない全ての出力行に,1で始まる番号を付けます.MS-DOSとMS-Windows
 1395: では,このオプションで,@command{cat}はテキストモードでファイルを読み
 1396: 書きします.
 1397: 
 1398: @item -e
 1399: @opindex -e
 1400: @c Equivalent to @option{-vE}.
 1401: @c 
 1402: @option{-vE}と等価です.
 1403: 
 1404: @item -E
 1405: @itemx --show-ends
 1406: @opindex -E
 1407: @opindex --show-ends
 1408: @c Display a @samp{$} after the end of each line.  On MS-DOS and
 1409: @c MS-Windows, this option causes @command{cat} to read and write files in
 1410: @c text mode.
 1411: @c 
 1412: それぞれの行末の後に@samp{$}を表示します.MS-DOSとMS-Windowsでは,
 1413: @command{cat}はこのオプションでテキストモードでファイルを読み書きしま
 1414: す.
 1415: 
 1416: @item -n
 1417: @itemx --number
 1418: @opindex -n
 1419: @opindex --number
 1420: @c Number all output lines, starting with 1.  On MS-DOS and MS-Windows,
 1421: @c this option causes @command{cat} to read and write files in text mode.
 1422: @c 
 1423: 全ての出力行に,1で始まる番号を付けます.MS-DOSとMS-Windowsでは,
 1424: @command{cat}はこのオプションでテキストモードでファイルを読み書きしま
 1425: す.
 1426: 
 1427: @item -s
 1428: @itemx --squeeze-blank
 1429: @opindex -s
 1430: @opindex --squeeze-blank
 1431: @cindex squeezing blank lines
 1432: @c Replace multiple adjacent blank lines with a single blank line.  On
 1433: @c MS-DOS and MS-Windows, this option causes @command{cat} to read and write
 1434: @c files in text mode.
 1435: @c 
 1436: 複数の隣接した空白行を,一行のブランク行に置換します.MS-DOSと
 1437: MS-Windowsでは,@command{cat}はこのオプションでテキストモードでファイ
 1438: ルを読み書きします.
 1439: 
 1440: @item -t
 1441: @opindex -t
 1442: @c Equivalent to @option{-vT}.
 1443: @c 
 1444: @option{-vT}と等価です.
 1445: 
 1446: @item -T
 1447: @itemx --show-tabs
 1448: @opindex -T
 1449: @opindex --show-tabs
 1450: @c Display TAB characters as @samp{^I}.
 1451: @c 
 1452: TAB文字を @samp{^I}として表示します.
 1453: 
 1454: @item -u
 1455: @opindex -u
 1456: @c Ignored; for Unix compatibility.
 1457: @c 
 1458: 無視されます.Unix互換性のためです.
 1459: 
 1460: @item -v
 1461: @itemx --show-nonprinting
 1462: @opindex -v
 1463: @opindex --show-nonprinting
 1464: @c Display control characters except for LFD and TAB using
 1465: @c @samp{^} notation and precede characters that have the high bit set with
 1466: @c @samp{M-}.  On MS-DOS and MS-Windows, this option causes @command{cat} to
 1467: @c read files and standard input in DOS binary mode, so the CR
 1468: @c characters at the end of each line are also visible.
 1469: @c 
 1470: LFDとTAB以外のコントロール文字を,@samp{^}表記法を使用して表示し,
 1471: @samp{M-}を使用したハイビットセットがある文字に前置します.MS-DOSと
 1472: MS-Windowsでは,@command{cat}はこのオプションでDOSバイナリモードでファ
 1473: イルと標準入力を読み込むので,それぞれの行末のCR文字が表示されます.
 1474: 
 1475: @end table
 1476: 
 1477: 
 1478: @node tac invocation
 1479: @c @section @command{tac}: Concatenate and write files in reverse
 1480: @section @command{tac}: 逆順にファイルを連結し書き込む
 1481: 
 1482: @pindex tac
 1483: @cindex reversing files
 1484: 
 1485: @c @command{tac} copies each @var{file} (@samp{-} means standard input), or
 1486: @c standard input if none are given, to standard output, reversing the
 1487: @c records (lines by default) in each separately.  Synopsis:
 1488: @c 
 1489: @command{tac}は,それぞれの@var{file}(@samp{-}は,標準入力を意味します) 
 1490: や,与えられない場合は標準入力を,個々に分割されたレコード(デフォルト
 1491: は行)を逆順にしながら,標準出力へコピーします.概要です.
 1492: 
 1493: @example
 1494: tac [@var{option}]@dots{} [@var{file}]@dots{}
 1495: @end example
 1496: 
 1497: @c @dfn{Records} are separated by instances of a string (newline by
 1498: @c default).  By default, this separator string is attached to the end of
 1499: @c the record that it follows in the file.
 1500: @c 
 1501: @dfn{レコード(record)}は,文字列のインスタンス(デフォルトは改行)で分け
 1502: られています.デフォルトで,このセパレータ文字列はファイルのレコードの
 1503: 終りに続けて付加されます.
 1504: 
 1505: @c The program accepts the following options.  Also see @ref{Common options}.
 1506: @c 
 1507: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 1508: してください.
 1509: 
 1510: @table @samp
 1511: 
 1512: @item -b
 1513: @itemx --before
 1514: @opindex -b
 1515: @opindex --before
 1516: @c The separator is attached to the beginning of the record that it
 1517: @c precedes in the file.
 1518: @c 
 1519: セパレータを,ファイルのレコードの最初に前置して付加します.
 1520: 
 1521: @item -r
 1522: @itemx --regex
 1523: @opindex -r
 1524: @opindex --regex
 1525: @c Treat the separator string as a regular expression.  Users of @command{tac}
 1526: @c on MS-DOS/MS-Windows should note that, since @command{tac} reads files in
 1527: @c binary mode, each line of a text file might end with a CR/LF pair
 1528: @c instead of the Unix-style LF.
 1529: @c 
 1530: セパレータ文字列を正規表現として扱います.MS-DOS/MS-Windowsでの
 1531: @command{tac}ユーザは,@command{tac}がファイルをバイナリモードで読むた
 1532: め,テキストファイルのそれぞれの行はUnixスタイルのLFの代わりにCR/LFの
 1533: ペアで終ることに注意すべきです.
 1534: 
 1535: @item -s @var{separator}
 1536: @itemx --separator=@var{separator}
 1537: @opindex -s
 1538: @opindex --separator
 1539: @c Use @var{separator} as the record separator, instead of newline.
 1540: @c 
 1541: @var{separator}を,改行の代わりにセパレータ文字列として用います.
 1542: 
 1543: @end table
 1544: 
 1545: 
 1546: @node nl invocation
 1547: @c @section @command{nl}: Number lines and write files
 1548: @section @command{nl}: 行に番号を付けファイルに書き込む
 1549: 
 1550: @pindex nl
 1551: @cindex numbering lines
 1552: @cindex line numbering
 1553: 
 1554: @c @command{nl} writes each @var{file} (@samp{-} means standard input), or
 1555: @c standard input if none are given, to standard output, with line numbers
 1556: @c added to some or all of the lines.  Synopsis:
 1557: @c 
 1558: @command{nl}は,それぞれの@var{file}(@samp{-}は標準入力を意味します)や,
 1559: 与えられない場合は標準入力を,いくつかの行や全ての行に行番号を加えて標
 1560: 準出力へ書き出します.概要です.
 1561: 
 1562: @example
 1563: nl [@var{option}]@dots{} [@var{file}]@dots{}
 1564: @end example
 1565: 
 1566: @cindex logical pages, numbering on
 1567: @c @command{nl} decomposes its input into (logical) pages; by default, the
 1568: @c line number is reset to 1 at the top of each logical page.  @command{nl}
 1569: @c treats all of the input files as a single document; it does not reset
 1570: @c line numbers or logical pages between files.
 1571: @c 
 1572: @command{nl}は,入力を(論理)ページに分解します.デフォルトで,それぞれ
 1573: の論理ページのトップで,行番号が1にリセットされます.@command{nl}は全
 1574: ての入力ファイルを単一のドキュメントとして扱います.行番号や論理ページ
 1575: をファイル間でリセットしません.
 1576: 
 1577: @cindex headers, numbering
 1578: @cindex body, numbering
 1579: @cindex footers, numbering
 1580: @c A logical page consists of three sections: header, body, and footer.
 1581: @c Any of the sections can be empty.  Each can be numbered in a different
 1582: @c style from the others.
 1583: @c 
 1584: 論理ページは三つのセクションから成立ちます.ヘッダ,ボディ,そしてフッ
 1585: タです.任意のセクションを,空にすることも可能です.それぞれ異なるスタ
 1586: イルで番号を付けることが可能です.
 1587: 
 1588: @c The beginnings of the sections of logical pages are indicated in the
 1589: @c input file by a line containing exactly one of these delimiter strings:
 1590: @c 
 1591: 論理ページのセクションの最初は,以下のデリミタ文字列の一つを入力ファイ
 1592: ルに単一行で含めることで示されます.
 1593: 
 1594: @table @samp
 1595: @item \:\:\:
 1596: @c start of header;
 1597: @c 
 1598: ヘッダの始まり.
 1599: @item \:\:
 1600: @c start of body;
 1601: @c 
 1602: ボディの始まり.
 1603: @item \:
 1604: @c start of footer.
 1605: @c 
 1606: フッタの始まり.
 1607: @end table
 1608: 
 1609: @c The two characters from which these strings are made can be changed from
 1610: @c @samp{\} and @samp{:} via options (see below), but the pattern and
 1611: @c length of each string cannot be changed.
 1612: @c 
 1613: これらの文字列を構成する二つの文字を,@samp{\}と@samp{:}から変更するこ
 1614: とはオプション(以下を参照)で可能ですが,パターンと文字列の長さの変更は
 1615: 不可能です.
 1616: 
 1617: @c A section delimiter is replaced by an empty line on output.  Any text
 1618: @c that comes before the first section delimiter string in the input file
 1619: @c is considered to be part of a body section, so @command{nl} treats a
 1620: @c file that contains no section delimiters as a single body section.
 1621: @c 
 1622: セクションデリミタは,出力では空行に置換されます.入力ファイルの,最初
 1623: のセクションのデリミタ文字列より前のあらゆるテキストは,ボディセクショ
 1624: ンの一部と考えられるので,@command{nl}は,セクションデリミタが無いファ
 1625: イルを,一つのボディセクションとして扱います.
 1626: 
 1627: @c The program accepts the following options.  Also see @ref{Common options}.
 1628: @c 
 1629: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 1630: してください.
 1631: 
 1632: @table @samp
 1633: 
 1634: @item -b @var{style}
 1635: @itemx --body-numbering=@var{style}
 1636: @opindex -b
 1637: @opindex --body-numbering
 1638: @c Select the numbering style for lines in the body section of each
 1639: @c logical page.  When a line is not numbered, the current line number
 1640: @c is not incremented, but the line number separator character is still
 1641: @c prepended to the line.  The styles are:
 1642: @c 
 1643: それぞれの論理ページのボディセクションの行に対する番号付けのスタイルを
 1644: 選択します.行が番号付けされないとき,現在の行番号は増加しませんが,行
 1645: 番号と分離する文字列が行に前置されます.スタイルは以下のとおりです.
 1646: 
 1647: @table @samp
 1648: @item a
 1649: @c number all lines,
 1650: @c 
 1651: 全ての行に番号を付けます.
 1652: @item t
 1653: @c number only nonempty lines (default for body),
 1654: @c 
 1655: (デフォルトでボディに対し)空でない行だけ,番号を付けます.
 1656: @item n
 1657: @c do not number lines (default for header and footer),
 1658: @c 
 1659: (デフォルトでヘッダやフッタに対し)番号を付けません.
 1660: @item p@var{regexp}
 1661: @c number only lines that contain a match for @var{regexp}.
 1662: @c 
 1663: @var{regexp}にマッチしたものを含む行だけ番号を付けます.
 1664: @end table
 1665: 
 1666: @item -d @var{cd}
 1667: @itemx --section-delimiter=@var{cd}
 1668: @opindex -d
 1669: @opindex --section-delimiter
 1670: @cindex section delimiters of pages
 1671: @c Set the section delimiter characters to @var{cd}; default is
 1672: @c @samp{\:}. If only @var{c} is given, the second remains @samp{:}.
 1673: @c (Remember to protect @samp{\} or other metacharacters from shell
 1674: @c expansion with quotes or extra backslashes.)
 1675: @c 
 1676: セクションを分離する文字を@var{cd}に設定します.デフォルトは@samp{\:}
 1677: です.@var{c}のみ与えられた場合,二番目の@samp{:}はそのままです.(シェ
 1678: ルが展開する@samp{\}やその他のメタ文字を,引用符やバックスラッシュの追
 1679: 加で保護することを忘れないでください.)
 1680: 
 1681: @item -f @var{style}
 1682: @itemx --footer-numbering=@var{style}
 1683: @opindex -f
 1684: @opindex --footer-numbering
 1685: @c Analogous to @option{--body-numbering}.
 1686: @c 
 1687: @option{--body-numbering}の同類です.
 1688: 
 1689: @item -h @var{style}
 1690: @itemx --header-numbering=@var{style}
 1691: @opindex -h
 1692: @opindex --header-numbering
 1693: @c Analogous to @option{--body-numbering}.
 1694: @c 
 1695: @option{--body-numbering}の同類です.
 1696: 
 1697: @item -i @var{number}
 1698: @itemx --page-increment=@var{number}
 1699: @opindex -i
 1700: @opindex --page-increment
 1701: @c Increment line numbers by @var{number} (default 1).
 1702: @c 
 1703: 行番号を@var{number}ずつ(デフォルトは1)増加します.
 1704: 
 1705: @item -l @var{number}
 1706: @itemx --join-blank-lines=@var{number}
 1707: @opindex -l
 1708: @opindex --join-blank-lines
 1709: @cindex empty lines, numbering
 1710: @cindex blank lines, numbering
 1711: @c Consider @var{number} (default 1) consecutive empty lines to be one
 1712: @c logical line for numbering, and only number the last one.  Where fewer
 1713: @c than @var{number} consecutive empty lines occur, do not number them.
 1714: @c An empty line is one that contains no characters, not even spaces
 1715: @c or tabs.
 1716: @c 
 1717: @var{number}(デフォルトは1)連続した空行を,番号付としては一つの論理行
 1718: だと考え,最後のものだけに番号付けします.@var{number}より少ない行の連
 1719: 続した空行があるところでは番号付けをしません.空行とは,文字を含まずス
 1720: ペースやタグも含まないものです.
 1721: 
 1722: @item -n @var{format}
 1723: @itemx --number-format=@var{format}
 1724: @opindex -n
 1725: @opindex --number-format
 1726: @c Select the line numbering format (default is @code{rn}):
 1727: @c 
 1728: 行の番号付けの書式を選択します(デフォルトは@code{rn}です).
 1729: 
 1730: @table @samp
 1731: @item ln
 1732: @opindex ln @r{format for @command{nl}}
 1733: @c left justified, no leading zeros;
 1734: @c 
 1735: 左寄せで,先頭にゼロを書きません.
 1736: @item rn
 1737: @opindex rn @r{format for @command{nl}}
 1738: @c right justified, no leading zeros;
 1739: @c 
 1740: 右寄せで,先頭にゼロを書きません.
 1741: @item rz
 1742: @opindex rz @r{format for @command{nl}}
 1743: @c right justified, leading zeros.
 1744: @c 
 1745: 右寄せで,先頭にゼロを書きます.
 1746: @end table
 1747: 
 1748: @item -p
 1749: @itemx --no-renumber
 1750: @opindex -p
 1751: @opindex --no-renumber
 1752: @c Do not reset the line number at the start of a logical page.
 1753: @c 
 1754: 論理ページの最初で,行番号をリセットしません.
 1755: 
 1756: @item -s @var{string}
 1757: @itemx --number-separator=@var{string}
 1758: @opindex -s
 1759: @opindex --number-separator
 1760: @c Separate the line number from the text line in the output with
 1761: @c @var{string} (default is the TAB character).
 1762: @c 
 1763: 出力で,@var{string}を使って(デフォルトはTAB文字)テキスト行と行番号を
 1764: 分離します.
 1765: 
 1766: @item -v @var{number}
 1767: @itemx --starting-line-number=@var{number}
 1768: @opindex -v
 1769: @opindex --starting-line-number
 1770: @c Set the initial line number on each logical page to @var{number} (default 1).
 1771: @c 
 1772: それぞれの論理ページの行番号の初期値を,@var{number}(デフォルトは1)に
 1773: 設定します.
 1774: 
 1775: @item -w @var{number}
 1776: @itemx --number-width=@var{number}
 1777: @opindex -w
 1778: @opindex --number-width
 1779: @c Use @var{number} characters for line numbers (default 6).
 1780: @c 
 1781: 行番号に,@var{number}文字使います(デフォルトは6).
 1782: 
 1783: @end table
 1784: 
 1785: 
 1786: @node od invocation
 1787: @c @section @command{od}: Write files in octal or other formats
 1788: @section @command{od}: 八進数やその他の書式でファイルを書き出す
 1789: 
 1790: @pindex od
 1791: @cindex octal dump of files
 1792: @cindex hex dump of files
 1793: @cindex ASCII dump of files
 1794: @cindex file contents, dumping unambiguously
 1795: 
 1796: @c @command{od} writes an unambiguous representation of each @var{file}
 1797: @c (@samp{-} means standard input), or standard input if none are given.
 1798: @c Synopses:
 1799: @c 
 1800: @command{od}は,それぞれの@var{file}(@samp{-}は標準入力を意味します)や,
 1801: 与えられない場合は標準入力を明瞭な表現で書き出します.概要です.
 1802: 
 1803: @example
 1804: od [@var{option}]@dots{} [@var{file}]@dots{}
 1805: od --traditional [@var{file}] [[+]@var{offset} [[+]@var{label}]]
 1806: @end example
 1807: 
 1808: @c Each line of output consists of the offset in the input, followed by
 1809: @c groups of data from the file. By default, @command{od} prints the offset in
 1810: @c octal, and each group of file data is two bytes of input printed as a
 1811: @c single octal number.
 1812: @c 
 1813: それぞれの出力行は,入力オフセットとそれに続くファイルデータのグループ
 1814: から成り立ちます.デフォルトで,@command{od}は八進数でオフセットを出力
 1815: し,それぞれのファイルのデータグループは,一つの八進数として出力される
 1816: 入力からの二バイトです.
 1817: 
 1818: @c The program accepts the following options.  Also see @ref{Common options}.
 1819: @c 
 1820: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 1821: してください.
 1822: 
 1823: @table @samp
 1824: 
 1825: @item -A @var{radix}
 1826: @itemx --address-radix=@var{radix}
 1827: @opindex -A
 1828: @opindex --address-radix
 1829: @cindex radix for file offsets
 1830: @cindex file offset radix
 1831: @c Select the base in which file offsets are printed.  @var{radix} can
 1832: @c be one of the following:
 1833: @c 
 1834: 出力するファイルオフセットの基数を選択します.@var{radix}は,以下の一
 1835: つが使用可能です.
 1836: 
 1837: @table @samp
 1838: @item d
 1839: @c decimal;
 1840: @c 
 1841: 十進数.
 1842: @item o
 1843: @c octal;
 1844: @c 
 1845: 八進数.
 1846: @item x
 1847: @c hexadecimal;
 1848: @c 
 1849: 16進数.
 1850: @item n
 1851: @c none (do not print offsets).
 1852: @c 
 1853: なし(出力オフセットを出力しません).
 1854: @end table
 1855: 
 1856: @c The default is octal.
 1857: @c 
 1858: デフォルトは八進数です.
 1859: 
 1860: @item -j @var{bytes}
 1861: @itemx --skip-bytes=@var{bytes}
 1862: @opindex -j
 1863: @opindex --skip-bytes
 1864: @c Skip @var{bytes} input bytes before formatting and writing.  If
 1865: @c @var{bytes} begins with @samp{0x} or @samp{0X}, it is interpreted in
 1866: @c hexadecimal; otherwise, if it begins with @samp{0}, in octal; otherwise,
 1867: @c in decimal.  Appending @samp{b} multiplies @var{bytes} by 512, @samp{k}
 1868: @c by 1024, and @samp{m} by 1048576.
 1869: @c 
 1870: 書式化と書き出しの前に,入力バイトの@var{bytes}スキップします.
 1871: @var{bytes}が@samp{0x}や@samp{0X}で始まる場合,16進数と解釈されます.
 1872: それ以外で@samp{0}で始まる場合は八進数.それ以外では十進数です.
 1873: @samp{b}の追加で@var{bytes}を512倍し,@samp{k}は1024倍,そして@samp{m}
 1874: は1048576倍します.
 1875: 
 1876: @item -N @var{bytes}
 1877: @itemx --read-bytes=@var{bytes}
 1878: @opindex -N
 1879: @opindex --read-bytes
 1880: @c Output at most @var{bytes} bytes of the input.  Prefixes and suffixes on
 1881: @c @code{bytes} are interpreted as for the @option{-j} option.
 1882: @c 
 1883: 入力の最大@var{bytes}バイトを出力します.@code{bytes}に対する接頭辞と
 1884: 接尾子は,@option{-j}のものと同じように解釈されます.
 1885: 
 1886: @item -s @var{n}
 1887: @itemx --strings[=@var{n}]
 1888: @opindex -s
 1889: @opindex --strings
 1890: @cindex string constants, outputting
 1891: @c Instead of the normal output, output only @dfn{string constants}: at
 1892: @c least @var{n} consecutive @acronym{ASCII} graphic characters,
 1893: @c followed by a null (zero) byte.
 1894: @c 
 1895: 通常の出力の代わりに,@dfn{文字列定数(string constants)}だけを出力しま
 1896: す.それは,少なくとも@var{n}個の連続した@acronym{ASCII}の印字可能な文
 1897: 字で,それにはnull(ゼロ)バイトが続きます.
 1898: 
 1899: @c If @var{n} is omitted with @option{--strings}, the default is 3.  On
 1900: @c older systems, @sc{gnu} @command{od} instead supports an obsolete
 1901: @c option @option{-s[@var{n}]}, where @var{n} also defaults to 3.
 1902: @c @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance}) does not allow
 1903: @c @option{-s} without an argument; use @option{--strings} instead.
 1904: @c 
 1905: @option{--strings}で@var{n}が省略されている場合,デフォルトは3です.古
 1906: いシステムでは,@sc{gnu} @command{od}は時代遅れのオプション
 1907: @option{-s[@var{n}]}をサポートしていて,そこでの@var{n}のデフォルトも3
 1908: です.@acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance})では,
 1909: 引数を用いない@option{-s}は許可されません.代わりに@option{--strings}
 1910: を使用してください.
 1911: 
 1912: @item -t @var{type}
 1913: @itemx --format=@var{type}
 1914: @opindex -t
 1915: @opindex --format
 1916: @c Select the format in which to output the file data.  @var{type} is a
 1917: @c string of one or more of the below type indicator characters.  If you
 1918: @c include more than one type indicator character in a single @var{type}
 1919: @c string, or use this option more than once, @command{od} writes one copy
 1920: @c of each output line using each of the data types that you specified,
 1921: @c in the order that you specified.
 1922: @c 
 1923: ファイルデータの出力書式を選択します.@var{type}は,以下の形式を示す文
 1924: 字の一つ以上の文字列です.単一の@var{type}文字列に,一つ以上の形式を示
 1925: す文字を含めたり,一回以上このオプションを使用した場合,@command{od}は,
 1926: それぞれの指定したデータ形式を用いて,それぞれの出力行のコピーを,指定
 1927: した順番で書き出します.
 1928: 
 1929: @c Adding a trailing ``z'' to any type specification appends a display
 1930: @c of the @acronym{ASCII} character representation of the printable characters
 1931: @c to the output line generated by the type specification.
 1932: @c 
 1933: あらゆる形式指定の終りに``z''を加えることで,形式指定で生成された出力
 1934: 行に,印刷可能な文字に存在する@acronym{ASCII}文字の表示を加えます.
 1935: 
 1936: @table @samp
 1937: @item a
 1938: @c named character
 1939: @c 
 1940: 指名された文字.
 1941: @item c
 1942: @c @acronym{ASCII} character or backslash escape,
 1943: @c 
 1944: @acronym{ASCII}文字,またはバックスラッシュエスケープ.
 1945: @item d
 1946: @c signed decimal
 1947: @c 
 1948: 符号付き十進数.
 1949: @item f
 1950: @c floating point
 1951: @c 
 1952: 浮動小数点.
 1953: @item o
 1954: @c octal
 1955: @c 
 1956: 八進数.
 1957: @item u
 1958: @c unsigned decimal
 1959: @c 
 1960: 符号無し十進数.
 1961: @item x
 1962: @c hexadecimal
 1963: @c 
 1964: 16進数.
 1965: @end table
 1966: 
 1967: @c The type @code{a} outputs things like @samp{sp} for space, @samp{nl} for
 1968: @c newline, and @samp{nul} for a null (zero) byte.  Type @code{c} outputs
 1969: @c @samp{ }, @samp{\n}, and @code{\0}, respectively.
 1970: @c 
 1971: 形式@code{a}は,スペースに対し@samp{sp},改行に対し@samp{nl},そして
 1972: null(ゼロ)バイトに対し@samp{nul}のようなものを出力します.形式@code{c} 
 1973: は,それぞれ@samp{ },@samp{\n},そして@code{\0}を出力します.
 1974: 
 1975: @cindex type size
 1976: @c Except for types @samp{a} and @samp{c}, you can specify the number
 1977: @c of bytes to use in interpreting each number in the given data type
 1978: @c by following the type indicator character with a decimal integer.
 1979: @c Alternately, you can specify the size of one of the C compiler's
 1980: @c built-in data types by following the type indicator character with
 1981: @c one of the following characters.  For integers (@samp{d}, @samp{o},
 1982: @c @samp{u}, @samp{x}):
 1983: @c 
 1984: @samp{a}と@samp{c}以外の形式に対し,それぞれの数字の解釈に使用するバイ
 1985: ト数を,以下の十進の整数を用いた形式を示す文字で与えられているデータ形
 1986: 式で指定することができます.代わりに,以下の文字の一つを用いた形式を示
 1987: す文字で,Cコンパイラ組込みのデータ形式を指定することも可能です.整数
 1988: (@samp{d},@samp{o},@samp{u},@samp{x})に対しては以下のようになります.
 1989: 
 1990: @table @samp
 1991: @item C
 1992: char
 1993: @item S
 1994: short
 1995: @item I
 1996: int
 1997: @item L
 1998: long
 1999: @end table
 2000: 
 2001: @c For floating point (@code{f}):
 2002: @c 
 2003: 浮動小数点(@code{f})に対しては以下のようになります.
 2004: 
 2005: @table @asis
 2006: @item F
 2007: float
 2008: @item D
 2009: double
 2010: @item L
 2011: long double
 2012: @end table
 2013: 
 2014: @item -v
 2015: @itemx --output-duplicates
 2016: @opindex -v
 2017: @opindex --output-duplicates
 2018: @c Output consecutive lines that are identical.  By default, when two or
 2019: @c more consecutive output lines would be identical, @command{od} outputs only
 2020: @c the first line, and puts just an asterisk on the following line to
 2021: @c indicate the elision.
 2022: @c 
 2023: 同一の連続した行を出力します.デフォルトで,二行以上連続した出力行が同
 2024: 一のとき,@command{od}は最初の行のみ出力し,それ以下の行には省略を示す
 2025: ためアスタリスクだけを書きます.
 2026: 
 2027: @item -w @var{n}
 2028: @itemx --width[=@var{n}]
 2029: @opindex -w
 2030: @opindex --width
 2031: @c Dump @code{n} input bytes per output line.  This must be a multiple of
 2032: @c the least common multiple of the sizes associated with the specified
 2033: @c output types.
 2034: @c 
 2035: 出力行ごとに,@code{n}入力バイトをダンプします.これは,出力形式で指定
 2036: したものに関連するサイズの最小公倍数の倍数にする必要があります.
 2037: 
 2038: @c If this option is not given at all, the default is 16.  If @var{n} is
 2039: @c omitted with @option{--width}, the default is 32.  On older systems,
 2040: @c @sc{gnu} @command{od} instead supports an obsolete option
 2041: @c @option{-w[@var{n}]}, where @var{n} also defaults to 32.  @acronym{POSIX}
 2042: @c 1003.1-2001 (@pxref{Standards conformance}) does not allow @option{-w}
 2043: @c without an argument; use @option{--width} instead.
 2044: @c 
 2045: このオプションが全く指定されていない場合,デフォルトは16です.
 2046: @option{--width}で@var{n}が省略されている場合,デフォルトは32です.古
 2047: いシステムでは,@sc{gnu} @command{od}は時代遅れのオプション
 2048: @option{-w[@var{n}]}を代わりにサポートしていて,そこでの@var{n}のデフォ
 2049: ルトも32です.@acronym{POSIX} 1003.1-2001 (@pxref{Standards
 2050: conformance})では,引数を用いない@option{-w}を許可していません.代わり
 2051: に@option{--width}を使用してください.
 2052: 
 2053: @end table
 2054: 
 2055: @c The next several options are shorthands for format specifications.
 2056: @c @sc{gnu} @command{od} accepts any combination of shorthands and format
 2057: @c specification options.  These options accumulate.
 2058: @c 
 2059: 次のいくつかのオプションは,書式指定の短いものです.@sc{gnu}
 2060: @command{od}は,短いものと書式指定のオプションのあらゆる組み合わせを受
 2061: け入れます.これらのオプションは累積されます.
 2062: 
 2063: @table @samp
 2064: 
 2065: @item -a
 2066: @opindex -a
 2067: @c Output as named characters.  Equivalent to @option{-ta}.
 2068: @c 
 2069: 指名された文字として出力します.@option{-ta}と等価です.
 2070: 
 2071: @item -b
 2072: @opindex -b
 2073: @c Output as octal bytes.  Equivalent to @option{-toC}.
 2074: @c 
 2075: 八進数のバイトとして出力します.@option{-toC}と等価です.
 2076: 
 2077: @item -c
 2078: @opindex -c
 2079: @c Output as @acronym{ASCII} characters or backslash escapes.  Equivalent to
 2080: @c @option{-tc}.
 2081: @c 
 2082: @acronym{ASCII}文字やバックスラッシュエスケープとして出力します.
 2083: @option{-tc}と等価です.
 2084: 
 2085: @item -d
 2086: @opindex -d
 2087: @c Output as unsigned decimal shorts.  Equivalent to @option{-tu2}.
 2088: @c 
 2089: 符号無しの十進数のshortとして出力します.@option{-tu2}と等価です.
 2090: 
 2091: @item -f
 2092: @opindex -f
 2093: @c Output as floats.  Equivalent to @option{-tfF}.
 2094: @c 
 2095: 浮動小数点として出力します.@option{-tfF}と等価です.
 2096: 
 2097: @item -h
 2098: @opindex -h
 2099: @c Output as hexadecimal shorts.  Equivalent to @option{-tx2}.
 2100: @c 
 2101: 16進数のshortとして出力します.@option{-tx2}と等価です.
 2102: 
 2103: @item -i
 2104: @opindex -i
 2105: @c Output as decimal shorts.  Equivalent to @option{-td2}.
 2106: @c 
 2107: 十進数のshortとして出力します.@option{-td2}と等価です.
 2108: 
 2109: @item -l
 2110: @opindex -l
 2111: @c Output as decimal longs.  Equivalent to @option{-td4}.
 2112: @c 
 2113: 十進数のlongとして出力します.@option{-td4}と等価です.
 2114: 
 2115: @item -o
 2116: @opindex -o
 2117: @c Output as octal shorts.  Equivalent to @option{-to2}.
 2118: @c 
 2119: 八進数のshortとして出力します.@option{-to2}と等価です.
 2120: 
 2121: @item -x
 2122: @opindex -x
 2123: @c Output as hexadecimal shorts.  Equivalent to @option{-tx2}.
 2124: @c 
 2125: 16進数のshortとして出力します.@option{-tx2}と等価です.
 2126: 
 2127: @item --traditional
 2128: @opindex --traditional
 2129: @c Recognize the non-option arguments that traditional @command{od}
 2130: @c accepted.  The following syntax:
 2131: @c 
 2132: 伝統的な@command{od}が受け入れる,オプション引数が無いものとして認識し
 2133: ます.以下の構文です.
 2134: 
 2135: @smallexample
 2136: od --traditional [@var{file}] [[+]@var{offset}[.][b] [[+]@var{label}[.][b]]]
 2137: @end smallexample
 2138: 
 2139: @noindent
 2140: @c can be used to specify at most one file and optional arguments
 2141: @c specifying an offset and a pseudo-start address, @var{label}.  By
 2142: @c default, @var{offset} is interpreted as an octal number specifying how
 2143: @c many input bytes to skip before formatting and writing.  The optional
 2144: @c trailing decimal point forces the interpretation of @var{offset} as a
 2145: @c decimal number.  If no decimal is specified and the offset begins with
 2146: @c @samp{0x} or @samp{0X} it is interpreted as a hexadecimal number.  If
 2147: @c there is a trailing @samp{b}, the number of bytes skipped will be
 2148: @c @var{offset} multiplied by 512.  The @var{label} argument is interpreted
 2149: @c just like @var{offset}, but it specifies an initial pseudo-address.  The
 2150: @c pseudo-addresses are displayed in parentheses following any normal
 2151: @c address.
 2152: @c 
 2153: これは,最大一つのファイルと,オプション引数で指定しているオフセットと
 2154: 疑似スタートアドレス,@var{label}を指定するために使用することが可能で
 2155: す.デフォルトで,@var{offset}は,書式化と書き出しの前にスキップする入
 2156: 力バイトの量が八進数で指定されていると解釈されます.オプションで十進数
 2157: の位置を後置すると,@var{offset}の解釈は強制的に十進数とします.十進数
 2158: が指定されておらず,オフセットが@samp{0x}や@samp{0X}で始まる場合,それ
 2159: は16進数として解釈されます.@samp{b}の後置がある場合,スキップされるバ
 2160: イト数は@var{offset} の512倍になります.@var{label}引数は,
 2161: @var{offset}のように解釈されますが,それは初期の疑似アドレスを指定しま
 2162: す.疑似アドレスは,通常のアドレスに続くカッコ内に表示されます.
 2163: 
 2164: @end table
 2165: 
 2166: 
 2167: @node Formatting file contents
 2168: @c @chapter Formatting file contents
 2169: @chapter ファイルの内容の書式化
 2170: 
 2171: @cindex formatting file contents
 2172: 
 2173: @c These commands reformat the contents of files.
 2174: @c 
 2175: 以下のコマンドは,ファイルの内容を再書式化します.
 2176: 
 2177: @menu
 2178: * fmt invocation::              Reformat paragraph text.
 2179: * pr invocation::               Paginate or columnate files for printing.
 2180: * fold invocation::             Wrap input lines to fit in specified width.
 2181: @end menu
 2182: 
 2183: 
 2184: @node fmt invocation
 2185: @c @section @command{fmt}: Reformat paragraph text
 2186: @section @command{fmt}: 段落のテキストを再書式化する.
 2187: 
 2188: @pindex fmt
 2189: @cindex reformatting paragraph text
 2190: @cindex paragraphs, reformatting
 2191: @cindex text, reformatting
 2192: 
 2193: @c @command{fmt} fills and joins lines to produce output lines of (at most)
 2194: @c a given number of characters (75 by default).  Synopsis:
 2195: @c 
 2196: @command{fmt}は,与えられた(最大)文字数(デフォルトは75)の出力行を生成
 2197: するために行を補充し繋げます.概要です.
 2198: 
 2199: @example
 2200: fmt [@var{option}]@dots{} [@var{file}]@dots{}
 2201: @end example
 2202: 
 2203: @c @command{fmt} reads from the specified @var{file} arguments (or standard
 2204: @c input if none are given), and writes to standard output.
 2205: @c 
 2206: @command{fmt}は,指定された@var{file}引数(または,与えられない場合は標
 2207: 準入力)からファイルを読み込み,標準出力に書き出します.
 2208: 
 2209: @c By default, blank lines, spaces between words, and indentation are
 2210: @c preserved in the output; successive input lines with different
 2211: @c indentation are not joined; tabs are expanded on input and introduced on
 2212: @c output.
 2213: @c 
 2214: デフォルトで,空白行,単語間のスペース,そして字下げは出力で維持されま
 2215: す.連続した入力行で字下げが異なるものは連結されません.入力のタブは展
 2216: 開され,出力に書き込まれます.
 2217: 
 2218: @cindex line-breaking
 2219: @cindex sentences and line-breaking
 2220: @cindex Knuth, Donald E.
 2221: @cindex Plass, Michael F.
 2222: @c @command{fmt} prefers breaking lines at the end of a sentence, and tries to
 2223: @c avoid line breaks after the first word of a sentence or before the last
 2224: @c word of a sentence.  A @dfn{sentence break} is defined as either the end
 2225: @c of a paragraph or a word ending in any of @samp{.?!}, followed by two
 2226: @c spaces or end of line, ignoring any intervening parentheses or quotes.
 2227: @c Like @TeX{}, @command{fmt} reads entire ``paragraphs'' before choosing line
 2228: @c breaks; the algorithm is a variant of that in ``Breaking Paragraphs Into
 2229: @c Lines'' (Donald E. Knuth and Michael F. Plass, @cite{Software---Practice
 2230: @c and Experience}, 11 (1981), 1119--1184).
 2231: @c 
 2232: @command{fmt}は,文の終りで改行しようとし,文の最初の単語の後や文の最
 2233: 後の単語の前での改行を避けようとします.@dfn{文の切れ目(sentence
 2234: break)}は段落の終り,または,@samp{.?!}で終るすべて単語に,二つのスペー
 2235: スまたは行末が続くものと定義されていて,カッコや引用符の内部は無視され
 2236: ます.@TeX{}のように,@command{fmt}は行の分割を選択する前に``段落''全
 2237: 体を読み込みます.アルゴリズムは``Breaking Paragraphs Into Lines(段落
 2238: を行に区切る)''の変種です(Donald E. Knuth and Michael F. Plass,
 2239: @cite{Software---Practice and Experience}, 11 (1981), 1119--1184).
 2240: 
 2241: @c The program accepts the following options.  Also see @ref{Common options}.
 2242: @c 
 2243: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 2244: してください.
 2245: 
 2246: @table @samp
 2247: 
 2248: @item -c
 2249: @itemx --crown-margin
 2250: @opindex -c
 2251: @opindex --crown-margin
 2252: @cindex crown margin
 2253: @c @dfn{Crown margin} mode: preserve the indentation of the first two
 2254: @c lines within a paragraph, and align the left margin of each subsequent
 2255: @c line with that of the second line.
 2256: @c 
 2257: @dfn{Crown margin}モード: 段落の最初の二行の字下げを保存し,それに続く
 2258: それぞれの行の左の余白を,二行目の余白に揃えます.
 2259: 
 2260: @item -t
 2261: @itemx --tagged-paragraph
 2262: @opindex -t
 2263: @opindex --tagged-paragraph
 2264: @cindex tagged paragraphs
 2265: @c @dfn{Tagged paragraph} mode: like crown margin mode, except that if
 2266: @c indentation of the first line of a paragraph is the same as the
 2267: @c indentation of the second, the first line is treated as a one-line
 2268: @c paragraph.
 2269: @c 
 2270: @dfn{Tagged paragraph}モード: crown marginモードに似ていますが,段落の
 2271: 最初の行の字下が二行目の字下げと同じ場合,最初の行は一行の段落として扱
 2272: われます.
 2273: 
 2274: @item -s
 2275: @itemx --split-only
 2276: @opindex -s
 2277: @opindex --split-only
 2278: @c Split lines only.  Do not join short lines to form longer ones.  This
 2279: @c prevents sample lines of code, and other such ``formatted'' text from
 2280: @c being unduly combined.
 2281: @c 
 2282: 行の分割のみです.短い行を長い形式に連結しません.これはコードのサンプ
 2283: ル行と,その他の``書式化された''テキストが醜く連結されることを妨げます.
 2284: 
 2285: @item -u
 2286: @itemx --uniform-spacing
 2287: @opindex -u
 2288: @opindex --uniform-spacing
 2289: @c Uniform spacing.  Reduce spacing between words to one space, and spacing
 2290: @c between sentences to two spaces.
 2291: @c 
 2292: スペースの付け方を統一します.単語の間のスペースを一つのスペースに,そ
 2293: して文の間のスペースを二つのスペースに減らします.
 2294: 
 2295: @item -@var{width}
 2296: @itemx -w @var{width}
 2297: @itemx --width=@var{width}
 2298: @opindex -@var{width}
 2299: @opindex -w
 2300: @opindex --width
 2301: @c Fill output lines up to @var{width} characters (default 75).  @command{fmt}
 2302: @c initially tries to make lines about 7% shorter than this, to give it
 2303: @c room to balance line lengths.
 2304: @c 
 2305: 出力ファイルを@var{width}文字(デフォルトは75)まで補充します.
 2306: @command{fmt}は最初に,これより7%短い行にし,行の長さのバランスのため
 2307: の空間を与えようとします.
 2308: 
 2309: @item -p @var{prefix}
 2310: @itemx --prefix=@var{prefix}
 2311: @c Only lines beginning with @var{prefix} (possibly preceded by whitespace)
 2312: @c are subject to formatting. The prefix and any preceding whitespace are
 2313: @c stripped for the formatting and then re-attached to each formatted output
 2314: @c line.  One use is to format certain kinds of program comments, while
 2315: @c leaving the code unchanged.
 2316: @c 
 2317: @var{prefix}(空白で始めることも可能です)で始まる行のみ,書式化を適用し
 2318: ます.prefixと前置されたあらゆる空白は,書式化のため取り除かれ,それぞ
 2319: れの出力行に再び取り付けられます.一つの使用方法としては,ある種のプロ
 2320: グラムのコメントの書式化があげられ,そこではコードは変化しません.
 2321: 
 2322: @end table
 2323: 
 2324: 
 2325: @node pr invocation
 2326: @c @section @command{pr}: Paginate or columnate files for printing
 2327: @section @command{pr}: 印刷のためのファイルのページ化とコラム化
 2328: 
 2329: @pindex pr
 2330: @cindex printing, preparing files for
 2331: @cindex multicolumn output, generating
 2332: @cindex merging files in parallel
 2333: 
 2334: @c @command{pr} writes each @var{file} (@samp{-} means standard input), or
 2335: @c standard input if none are given, to standard output, paginating and
 2336: @c optionally outputting in multicolumn format; optionally merges all
 2337: @c @var{file}s, printing all in parallel, one per column.  Synopsis:
 2338: @c 
 2339: @command{pr}は,それぞれの@var{file}(@samp{-}は標準入力を意味します)や,
 2340: 与えられない場合は標準入力をページ化し,オプションで複数列の書式での出
 2341: 力を標準出力に書き出します.オプションで,全ての@var{file}を結合し一列
 2342: ごとに並列に全てを出力します.概要です.
 2343: 
 2344: @example
 2345: pr [@var{option}]@dots{} [@var{file}]@dots{}
 2346: @end example
 2347: 
 2348: @vindex LC_MESSAGES
 2349: @c By default, a 5-line header is printed at each page: two blank lines;
 2350: @c a line with the date, the filename, and the page count; and two more
 2351: @c blank lines.  A footer of five blank lines is also printed.
 2352: @c With the @option{-F}
 2353: @c option, a 3-line header is printed: the leading two blank lines are
 2354: @c omitted; no footer is used.  The default @var{page_length} in both cases is 66
 2355: @c lines.  The default number of text lines changes from 56 (without @option{-F})
 2356: @c to 63 (with @option{-F}).  The text line of the header takes the form
 2357: @c @samp{@var{date} @var{string} @var{page}}, with spaces inserted around
 2358: @c @var{string} so that the line takes up the full @var{page_width}.  Here,
 2359: @c @var{date} is the date (see the @option{-D} or @option{--date-format}
 2360: @c option for details), @var{string} is the centered header string, and
 2361: @c @var{page} identifies the page number.  The @env{LC_MESSAGES} locale
 2362: @c category affects the spelling of @var{page}; in the default C locale, it
 2363: @c is @samp{Page @var{number}} where @var{number} is the decimal page
 2364: @c number.
 2365: @c 
 2366: デフォルトで,五行のヘッダがそれぞれのページに出力されます.二行の空白
 2367: 行.日付,ファイル名,そしてページ番号がある行.さらに二行は空白行です.
 2368: また,五行の空白行を持つフッタも出力します.@option{-F}オプションで,
 2369: 三行のヘッダを出力します.最初の二行の空白行は削除されます.フッタは使
 2370: 用されません.どちらの場合でもデフォルトの@var{page_length}は66行です.
 2371: テキスト行のデフォルト数は56(@option{-F}が無い場合)から63(@option{-F}
 2372: がある場合)まで変化します.ヘッダのテキスト行は,@samp{@var{date}
 2373: @var{string} @var{page}}の形式で,行が@var{page_width}いっぱいになるよ
 2374: うに@var{string}の周りにスペースが挿入されます.ここで,@var{date}は日
 2375: 付(詳細は,@option{-D}や@option{--date-format}オプションを参照してくだ
 2376: さい),@var{string}はセンタリングされたヘッダ文字列,そして@var{page}
 2377: はページ番号を示します.@env{LC_MESSAGES}ロケールカテゴリは@var{page}
 2378: の綴りに影響します.デフォルトのCロケールでは@samp{Page @var{number}}
 2379: になり,@var{number}は十進数のページ番号です.
 2380: 
 2381: @c Form feeds in the input cause page breaks in the output.  Multiple form
 2382: @c feeds produce empty pages.
 2383: @c 
 2384: 入力のフォームフィードは,出力で改ページとなります.複数のフォームフィー
 2385: ドは空のページを生成します.
 2386: 
 2387: @c Columns are of equal width, separated by an optional string (default
 2388: @c is @samp{space}).  For multicolumn output, lines will always be truncated to
 2389: @c @var{page_width} (default 72), unless you use the @option{-J} option.
 2390: @c For single
 2391: @c column output no line truncation occurs by default.  Use @option{-W} option to
 2392: @c truncate lines in that case.
 2393: @c 
 2394: 列は同じ幅で,オプションの文字列(デフォルトは@samp{space})で分けられて
 2395: います.複数列の出力では,@option{-J}オプションを使用していない場合,
 2396: 行は常に@var{page_width}(デフォルトで72)で切り詰められます.単一列での
 2397: 出力は,デフォルトでは切り詰められません.その場合,行を切り詰めるため
 2398: @option{-W}オプションを使用してください.
 2399: 
 2400: @c The following changes were made in version 1.22i and apply to later
 2401: @c versions of @command{pr}:
 2402: @c 
 2403: 以下の変更は,version 1.22iでなされ,それ以降の@command{pr}のバージョ
 2404: ンに適用されています.
 2405: @c FIXME: this whole section here sounds very awkward to me. I
 2406: @c made a few small changes, but really it all needs to be redone. - Brian
 2407: @c OK, I fixed another sentence or two, but some of it I just don't understand.
 2408: @ - Brian
 2409: @itemize @bullet
 2410: 
 2411: @item
 2412: @c Some small @var{letter options} (@option{-s}, @option{-w}) have been
 2413: @c redefined for better @acronym{POSIX} compliance.  The output of some further
 2414: @c cases has been adapted to other Unix systems.  These changes are not
 2415: @c compatible with earlier versions of the program.
 2416: @c 
 2417: 小文字の@var{letter options}(@option{-s},@option{-w})には,より良い
 2418: @acronym{POSIX}準拠のもので再定義されているものもあります.それ以外の
 2419: 場合での出力は,他のUnixに適合されたものもあります.これらの変更は,プ
 2420: ログラムの以前のバージョンと互換性がありません.
 2421: 
 2422: @item
 2423: @c Some @var{new capital letter} options (@option{-J}, @option{-S}, @option{-W})
 2424: @c have been introduced to turn off unexpected interferences of small letter
 2425: @c options.  The @option{-N} option and the second argument @var{last_page}
 2426: @c of @samp{+FIRST_PAGE} offer more flexibility.  The detailed handling of
 2427: @c form feeds set in the input files requires the @option{-T} option.
 2428: @c 
 2429: @var{new capital letter}オプション(@option{-J},@option{-S},
 2430: @option{-W})には,小文字のオプションでの予期せぬインターフェースを取り
 2431: 消すために導入されたものもあります.@option{-N}オプションと二番目の引
 2432: 数@samp{+FIRST_PAGE}の@var{last_page}で,より柔軟性が高くなります.入
 2433: 力ファイルのフォームフィード設定を詳細に扱うため,@option{-T}オプショ
 2434: ンが必要になります.
 2435: 
 2436: @item
 2437: @c Capital letter options override small letter ones.
 2438: @c 
 2439: 大文字のオプションは,小文字のものに優先します.
 2440: 
 2441: @item
 2442: @c Some of the option-arguments (compare @option{-s}, @option{-e},
 2443: @c @option{-i}, @option{-n}) cannot be specified as separate arguments from the
 2444: @c preceding option letter (already stated in the @acronym{POSIX} specification).
 2445: @c 
 2446: オプション引数には(@option{-s},@option{-S},@option{-e},@option{-i},
 2447: @option{-n}と比較して),(@acronym{POSIX}仕様で既に述べられた)前置され
 2448: ているオプション文字と分離されている引数を指定することが不可能なものも
 2449: あります.
 2450: @end itemize
 2451: 
 2452: @c The program accepts the following options.  Also see @ref{Common options}.
 2453: @c 
 2454: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 2455: してください.
 2456: 
 2457: @table @samp
 2458: 
 2459: @item +@var{first_page}[:@var{last_page}]
 2460: @itemx --pages=@var{first_page}[:@var{last_page}]
 2461: @c The two following @opindex lines evoke warnings because they contain `:'
 2462: @c The `info' spec does not permit that.  If we use those lines, we end
 2463: @c up with truncated index entries that don't work.
 2464: @c @opindex +@var{first_page}[:@var{last_page}]
 2465: @c @opindex --pages=@var{first_page}[:@var{last_page}]
 2466: @opindex +@var{page_range}
 2467: @opindex --pages=@var{page_range}
 2468: @c Begin printing with page @var{first_page} and stop with @var{last_page}.
 2469: @c Missing @samp{:@var{last_page}} implies end of file.  While estimating
 2470: @c the number of skipped pages each form feed in the input file results
 2471: @c in a new page.  Page counting with and without @samp{+@var{first_page}}
 2472: @c is identical.  By default, counting starts with the first page of input
 2473: @c file (not first page printed).  Line numbering may be altered by @option{-N}
 2474: @c option.
 2475: @c 
 2476: ページ@var{first_page}から出力を開始し,@var{last_page}で停止します.
 2477: @samp{:@var{last_page}}が無い場合は,ファイルの終りを暗黙に指定します.
 2478: 飛ばされたページ数を計算している間,入力ファイルのそれぞれのフォーム
 2479: フィードは,結果として新しいページになります.@samp{+@var{first_page}} 
 2480: がある場合と無い場合のページの数え方は同じです.デフォルトで,入力ファ
 2481: イルの最初のページでカウントを開始します(最初のページは出力されません).
 2482: 行の番号付けは,@option{-N}オプションで変更してもかまいません.
 2483: 
 2484: @item -@var{column}
 2485: @itemx --columns=@var{column}
 2486: @opindex -@var{column}
 2487: @opindex --columns
 2488: @cindex down columns
 2489: @c With each single @var{file}, produce @var{column} columns of output
 2490: @c (default is 1) and print columns down, unless @option{-a} is used.  The
 2491: @c column width is automatically decreased as @var{column} increases; unless
 2492: @c you use the @option{-W/-w} option to increase @var{page_width} as well.
 2493: @c This option might well cause some lines to be truncated.  The number of
 2494: @c lines in the columns on each page are balanced.  The options @option{-e}
 2495: @c and @option{-i} are on for multiple text-column output.  Together with
 2496: @c @option{-J} option column alignment and line truncation is turned off.
 2497: @c Lines of full length are joined in a free field format and @option{-S}
 2498: @c option may set field separators.  @option{-@var{column}} may not be used
 2499: @c with @option{-m} option.
 2500: @c 
 2501: それぞれ単一@var{file}を用いて,@option{-a}が使用されない場合は
 2502: @var{column}列(デフォルトで1)の出力を生成し列を下へ向かって出力します.
 2503: 列の幅は,@var{column}が増加するに従い,自動的に減少します.
 2504: @var{page_width}を増加させるため,@option{-W/-w}を使用していない場合も
 2505: 同様です.このオプションは,いくつかの行を切り詰める可能性があります.
 2506: それぞれのページの列の行数は平均化されます.オプション@option{-e}と
 2507: @option{-i}は,複数のテキスト列の出力のためにあります.@option{-J}をと
 2508: もに用いると,列の整列と行の切り詰めは停止します.十分な長さの行は,フ
 2509: リーフィールド書式に組み込まれ,@option{-S}オプションはフィールドを分
 2510: ける可能性があります.@option{-@var{column}}は@option{-m}オプションと
 2511: ともに使用してはいけません.
 2512: 
 2513: @item -a
 2514: @itemx --across
 2515: @opindex -a
 2516: @opindex --across
 2517: @cindex across columns
 2518: @c With each single @var{file}, print columns across rather than down.  The
 2519: @c @option{-@var{column}} option must be given with @var{column} greater than one.
 2520: @c If a line is too long to fit in a column, it is truncated.
 2521: @c 
 2522: それぞれ単一@var{file}を用い,列を下ではなく横に出力します.
 2523: @option{-@var{column}}オプションは,一列以上の@var{column}で与える必要
 2524: があります.列に適さないほど余りに長い場合,それは切り詰められます.
 2525: 
 2526: @item -c
 2527: @itemx --show-control-chars
 2528: @opindex -c
 2529: @opindex --show-control-chars
 2530: @c Print control characters using hat notation (e.g., @samp{^G}); print
 2531: @c other nonprinting characters in octal backslash notation.  By default,
 2532: @c nonprinting characters are not changed.
 2533: @c 
 2534: ハット表記で(例えば,@samp{^G})を使用して制御文字を出力します.八進数
 2535: のバックスラッシュ表記で,その他の印刷不可能な文字を表示します.デフォ
 2536: ルトで,印刷不可能な文字は変更されません.
 2537: 
 2538: @item -d
 2539: @itemx --double-space
 2540: @opindex -d
 2541: @opindex --double-space
 2542: @cindex double spacing
 2543: @c Double space the output.
 2544: @c 
 2545: ダブルスペースを出力です.
 2546: 
 2547: @item -D @var{format}
 2548: @itemx --date-format=@var{format}
 2549: @cindex time formats
 2550: @cindex formatting times
 2551: @c Format header dates using @var{format}, using the same conventions as
 2552: @c for the the command @samp{date +@var{format}}; @xref{date invocation}.
 2553: @c Except for directives, which start with
 2554: @c @samp{%}, characters in @var{format} are printed unchanged.  You can use
 2555: @c this option to specify an arbitrary string in place of the header date,
 2556: @c e.g., @option{--date-format="Monday morning"}.
 2557: @c 
 2558: @var{format}を使用してヘッダの日付を書式化し,それはコマンド@samp{date
 2559: +@var{format}}と同じ慣習を使用します.@xref{date invocation}.
 2560: @samp{%}で始まる指示語以外,@var{format}内の文字は変更されずに出力され
 2561: ます.ヘッダの日付の場所に,例えば@option{--date-format="Monday
 2562: morning"}のような,任意の文字列を指定するために,このオプションを使用
 2563: することが可能です.
 2564: 
 2565: @vindex POSIXLY_CORRECT
 2566: @vindex LC_TIME
 2567: @c If the @env{POSIXLY_CORRECT} environment variable is not set, the date
 2568: @c format defaults to @samp{%Y-%m-%d %H:%M} (for example, @samp{2001-12-04
 2569: @c 23:59}); otherwise, the format depends on the @env{LC_TIME} locale
 2570: @c category, with the default being @samp{%b %e %H:%M %Y} (for example,
 2571: @c @samp{Dec@ @ 4 23:59 2001}.
 2572: @c 
 2573: @env{POSIXLY_CORRECT}環境変数が設定されていない場合,日付の書式はデフォ
 2574: ルトで@samp{%Y-%m-%d %H:%M}です(例えば,@samp{2001-12-04 23:59}).それ
 2575: 以外の場合,書式は@env{LC_TIME}ロケールカテゴリに依存し,デフォルトは
 2576: @samp{%b %e %H:%M %Y}(例えば,@samp{Dec@ @ 4 23:59 2001})になります.
 2577: 
 2578: @item -e[@var{in-tabchar}[@var{in-tabwidth}]]
 2579: @itemx --expand-tabs[=@var{in-tabchar}[@var{in-tabwidth}]]
 2580: @opindex -e
 2581: @opindex --expand-tabs
 2582: @cindex input tabs
 2583: @c Expand @var{tab}s to spaces on input.  Optional argument @var{in-tabchar} is
 2584: @c the input tab character (default is the TAB character).  Second optional
 2585: @c argument @var{in-tabwidth} is the input tab character's width (default
 2586: @c is 8).
 2587: @c 
 2588: 入力の@var{tab}をスペースに展開します.オプションの引数
 2589: @var{in-tabchar}は,入力のタブ文字(デフォルトはTAB文字)です.二番目の
 2590: オプション引数@var{in-tabwidth}は,入力タブ文字の幅(デフォルトは8)です.
 2591: 
 2592: @item -f
 2593: @itemx -F
 2594: @itemx --form-feed
 2595: @opindex -F
 2596: @opindex -f
 2597: @opindex --form-feed
 2598: @c Use a form feed instead of newlines to separate output pages.  The default
 2599: @c page length of 66 lines is not altered.  But the number of lines of text
 2600: @c per page changes from default 56 to 63 lines.
 2601: @c 
 2602: 出力ページを分けるため,改行の代わりにフォームフィードを使用します.デ
 2603: フォルトページの長さの66行は変更されません.しかし,ページごとのテキス
 2604: トの行数はデフォルトの56行から63行に変更されます.
 2605: 
 2606: @item -h @var{HEADER}
 2607: @itemx --header=@var{HEADER}
 2608: @opindex -h
 2609: @opindex --header
 2610: @c Replace the filename in the header with the centered string @var{header}.
 2611: @c When using the shell, @var{header} should be quoted and should be
 2612: @c separated from @option{-h} by a space.
 2613: @c 
 2614: ヘッダのファイル名を中央揃えされた文字列@var{header}で置換します.シェ
 2615: ルを使用しているとき,@var{header}を引用符で囲むべきで,@option{-h}と
 2616: はスペースで分離すべきです.
 2617: 
 2618: @item -i[@var{out-tabchar}[@var{out-tabwidth}]]
 2619: @itemx --output-tabs[=@var{out-tabchar}[@var{out-tabwidth}]]
 2620: @opindex -i
 2621: @opindex --output-tabs
 2622: @cindex output tabs
 2623: @c Replace spaces with @var{tab}s on output.  Optional argument @var{out-tabchar}
 2624: @c is the output tab character (default is the TAB character).  Second optional
 2625: @c argument @var{out-tabwidth} is the output tab character's width (default
 2626: @c is 8).
 2627: @c 
 2628: 出力上でスペースを@var{tab}に置換します.オプション引数
 2629: @var{out-tabchar}は出力されるタブ文字です(デフォルトはTAB文字です).二
 2630: 番目のオプション引数@var{out-tabwidth}は出力されるタブ文字の幅(デフォ
 2631: ルトで8)です.
 2632: 
 2633: @item -J
 2634: @itemx --join-lines
 2635: @opindex -J
 2636: @opindex --join-lines
 2637: @c Merge lines of full length.  Used together with the column options
 2638: @c @option{-@var{column}}, @option{-a -@var{column}} or @option{-m}.  Turns off
 2639: @c @option{-W/-w} line truncation;
 2640: @c no column alignment used; may be used with
 2641: @c @option{--sep-string[=@var{string}]}.  @option{-J} has been introduced
 2642: @c (together with @option{-W} and @option{--sep-string})
 2643: @c to disentangle the old (@acronym{POSIX}-compliant) options @option{-w} and
 2644: @c @option{-s} along with the three column options.
 2645: @c 
 2646: 十分な長さの行に統合します.列オプション@option{-@var{column}},
 2647: @option{-a -@var{column}},または@option{-m}とともに使用します.
 2648: @option{-W/-w}の行の切り詰めを停止します.列の整列は使用されません.
 2649: @samp{-S[@var{string}]}とともに使用してもかまいません.@option{-J}は
 2650: (@option{-W}と@option{-S}とともに),三列オプションの古い
 2651: (@acronym{POSIX} 準拠の)オプション@option{-w}と@option{-s}を解決するた
 2652: めに導入されました.
 2653: 
 2654: @item -l @var{page_length}
 2655: @itemx --length=@var{page_length}
 2656: @opindex -l
 2657: @opindex --length
 2658: @c Set the page length to @var{page_length} (default 66) lines, including
 2659: @c the lines of the header [and the footer].  If @var{page_length} is less
 2660: @c than or equal to 10 (or <= 3 with @option{-F}), the header and footer are
 2661: @c omitted, and all form feeds set in input files are eliminated, as if
 2662: @c the @option{-T} option had been given.
 2663: @c 
 2664: ページの長さを,ヘッダ[とフッタ]の行を含めて,@var{page_length}行(デフォ
 2665: ルトで66)に設定します.@var{page_length}が10以下(または@option{-F}が3
 2666: 以下)の場合,ヘッダとフッタは取り除かれ,入力ファイルの全てのフォーム
 2667: フィード設定は,@option{-T}オプションが指定されたかのように無視されま
 2668: す.
 2669: 
 2670: @item -m
 2671: @itemx --merge
 2672: @opindex -m
 2673: @opindex --merge
 2674: @c Merge and print all @var{file}s in parallel, one in each column.  If a
 2675: @c line is too long to fit in a column, it is truncated, unless the @option{-J}
 2676: @c option is used.  @option{--sep-string[=@var{string}]} may be used.
 2677: @c Empty pages in
 2678: @c some @var{file}s (form feeds set) produce empty columns, still marked
 2679: @c by @var{string}.  The result is a continuous line numbering and column
 2680: @c marking throughout the whole merged file.  Completely empty merged pages
 2681: @c show no separators or line numbers.  The default header becomes
 2682: @c @samp{@var{date} @var{page}} with spaces inserted in the middle; this
 2683: @c may be used with the @option{-h} or @option{--header} option to fill up
 2684: @c the middle blank part.
 2685: @c 
 2686: 全ての@var{file}を並列に,それぞれの列に一つに統合して出力します.列に
 2687: 適さないほど行が長すぎる場合,それは@option{-J}オプションが使用されて
 2688: いない限り切り詰められます.@option{--sep-string[=@var{string}]}を使用
 2689: してもかまいません.@var{file}の(フォームフィード設定の)空のページは空
 2690: の列を生成しますが,@var{string}で印は付いたままです.結果として,連続
 2691: した行の番号付けと,統合されたファイル全体を通じて印が付いた列になりま
 2692: す.統合されても完全に空のページになるものは,区切りも行番号もありませ
 2693: ん.デフォルトヘッダは@samp{@var{date} @var{page}}になり,真中にスペー
 2694: スが挿入されます.これで中間の空白部分を満たすため,@option{-h}や
 2695: @option{--header}オプションとともに使用してもかまいません.
 2696: 
 2697: @item -n[@var{number-separator}[@var{digits}]]
 2698: @itemx --number-lines[=@var{number-separator}[@var{digits}]]
 2699: @opindex -n
 2700: @opindex --number-lines
 2701: @c Provide @var{digits} digit line numbering (default for @var{digits} is
 2702: @c 5).  With multicolumn output the number occupies the first @var{digits}
 2703: @c column positions of each text column or only each line of @option{-m}
 2704: @c output.  With single column output the number precedes each line just as
 2705: @c @option{-m} does.  Default counting of the line numbers starts with the
 2706: @c first line of the input file (not the first line printed, compare the
 2707: @c @option{--page} option and @option{-N} option).
 2708: @c Optional argument @var{number-separator} is the character appended to
 2709: @c the line number to separate it from the text followed.  The default
 2710: @c separator is the TAB character.  In a strict sense a TAB is always
 2711: @c printed with single column output only.  The @var{TAB}-width varies
 2712: @c with the @var{TAB}-position, e.g. with the left @var{margin} specified
 2713: @c by @option{-o} option.  With multicolumn output priority is given to
 2714: @c @samp{equal width of output columns} (a @acronym{POSIX} specification).
 2715: @c The @var{TAB}-width is fixed to the value of the first column and does
 2716: @c not change with different values of left @var{margin}.  That means a
 2717: @c fixed number of spaces is always printed in the place of the
 2718: @c @var{number-separator tab}.  The tabification depends upon the output
 2719: @c position.
 2720: @c 
 2721: @var{digits}桁の行の番号付けを提供します(デフォルトの@var{digits}は5で
 2722: す).複数列の出力では,番号はそれぞれのテキスト列の最初の@var{digits} 
 2723: 列の位置や,@option{-m}出力のそれぞれの行だけに生成されます.単一列の
 2724: 出力では,番号はそれぞれの行に@option{-m}が行うように生成します.デフォ
 2725: ルトの行カウントの開始は,入力ファイルの最初の行で始まります
 2726: (@option{--page}オプションと@option{-N}オプションとは異なり,最初に印
 2727: 刷される行ではありません).オプション引数@var{number-separator}は,以
 2728: 下に続くテキストと分離するために行数に後置される文字です.デフォルトの
 2729: 分離文字はTAB文字です.厳密な意味で,TABは常に単一の列の出力だけに出力
 2730: されます.@var{TAB}幅は@var{TAB}位置で変化し,例えば,左の@var{margin} 
 2731: が@option{-o}オプションで指定された場合は変化します.複数列出力のプロ
 2732: パティは,@samp{equal width of output columns} (@acronym{POSIX}指定) 
 2733: で与えられます.@var{TAB}幅は,最初の列の値で固定され,左の
 2734: @var{margin}の値の違いでは変更されません.それは,固定数のスペースが常
 2735: に@var{number-separator tab}の位置に出力されることを意味します.タブ機
 2736: 能は出力位置に依存します.
 2737: 
 2738: @item -N @var{line_number}
 2739: @itemx --first-line-number=@var{line_number}
 2740: @opindex -N
 2741: @opindex --first-line-number
 2742: @c Start line counting with the number @var{line_number} at first line of
 2743: @c first page printed (in most cases not the first line of the input file).
 2744: @c 
 2745: 最初のページに出力される最初の行(ほとんどの場合,入力ファイルの最初で
 2746: はありません)を,数字の@var{line_number}で行のカウントを開始します.
 2747: 
 2748: @item -o @var{margin}
 2749: @itemx --indent=@var{margin}
 2750: @opindex -o
 2751: @opindex --indent
 2752: @cindex indenting lines
 2753: @cindex left margin
 2754: @c Indent each line with a margin @var{margin} spaces wide (default is zero).
 2755: @c The total page width is the size of the margin plus the @var{page_width}
 2756: @c set with the @option{-W/-w} option.  A limited overflow may occur with
 2757: @c numbered single column output (compare @option{-n} option).
 2758: @c 
 2759: それぞれの行を@var{margin}スペースのマージン幅(デフォルトはゼロ)で字下
 2760: げします.ページ全体の幅はマージンに@option{-W/-w}オプションの
 2761: @var{page_width}設定を加えたものになります.数字付の単一列の出力では
 2762: (@option{-n}オプションとは異なり)制限されることによるオーバーフローが
 2763: 発生するかもしれません.
 2764: 
 2765: @item -r
 2766: @itemx --no-file-warnings
 2767: @opindex -r
 2768: @opindex --no-file-warnings
 2769: @c Do not print a warning message when an argument @var{file} cannot be
 2770: @c opened.  (The exit status will still be nonzero, however.)
 2771: @c 
 2772: 引数@var{file}が開けなかったとき,警告メッセージを出力しません.(しか
 2773: し,終了ステータスはゼロではありません.)
 2774: 
 2775: @item -s[@var{char}]
 2776: @itemx --separator[=@var{char}]
 2777: @opindex -s
 2778: @opindex --separator
 2779: @c Separate columns by a single character @var{char}.  The default for
 2780: @c @var{char} is the TAB character without @option{-w} and @samp{no
 2781: @c character} with @option{-w}.  Without @option{-s} the default separator
 2782: @c @samp{space} is set.  @option{-s[char]} turns off line truncation of all
 2783: @c three column options (@option{-COLUMN}|@option{-a -COLUMN}|@option{-m}) unless
 2784: @c @option{-w} is set.  This is a @acronym{POSIX}-compliant formulation.
 2785: @c 
 2786: 単一文字@var{char}で列を分けます.@var{char}のデフォルトは,
 2787: @option{-w}を用いないとTAB文字で,@option{-w}を用いると@samp{no
 2788: character}になります.@option{-s}が無い場合のデフォルトの分離文字は
 2789: @samp{space}に設定されます.@option{-s[char]}は,@option{-w}が設定され
 2790: ていない場合,全ての三列オプション(@option{-COLUMN}|@samp{-a
 2791: -COLUMN}|@option{-m})の行の切り詰めを停止します.それは,
 2792: @acronym{POSIX}準拠の公式なものです.
 2793: 
 2794: @item -S @var{string}
 2795: @itemx --sep-string[=@var{string}]
 2796: @opindex -S
 2797: @opindex --sep-string
 2798: @c Use @var{string} to separate output columns.  The @option{-S} option doesn't
 2799: @c affect the @option{-W/-w} option, unlike the @option{-s} option which does.  It
 2800: @c does not affect line truncation or column alignment.
 2801: @c Without @option{-S}, and with @option{-J}, @command{pr} uses the default output
 2802: @c separator, TAB.
 2803: @c Without @option{-S} or @option{-J}, @command{pr} uses a @samp{space}
 2804: @c (same as @option{-S"@w{ }"}).  With @option{-S@var{string}},
 2805: @c @var{string} must be nonempty; @option{--sep-string} with no
 2806: @c @var{string} is equivalent to @option{--sep-string=""}.
 2807: @c 
 2808: 出力の列を分けるため@var{string}を使用します.@option{-S}オプションは
 2809: @option{-s}オプションと異なり,@option{-W/-w}オプションに対し効果があ
 2810: りません.それは行の切り詰めや列の整列に効果がありません.@option{-S} 
 2811: を用いず,@option{-J}を用いると,@command{pr}はデフォルトの出力の分離
 2812: 文字のTABを使用します.@option{-S}や@option{-J}を用いないと,
 2813: @command{pr} は@samp{space}を使用します(@samp{-S" "}と同じです).
 2814: @option{-S@var{string}}を用るとき,@var{string}を空にしてはいけません.
 2815: @var{string}が無い@option{--sep-string}は@option{--sep-string=""}と等
 2816: 価です.
 2817: 
 2818: @c On older systems, @command{pr} instead supports an obsolete option
 2819: @c @option{-S[@var{string}]}, where @var{string} is optional.  @acronym{POSIX}
 2820: @c 1003.1-2001 (@pxref{Standards conformance}) does not allow this older
 2821: @c usage.  To specify an empty @var{string} portably, use
 2822: @c @option{--sep-string}.
 2823: @c 
 2824: 古いシステムでは,@command{pr}は時代遅れのオプション
 2825: @option{-S[@var{string}]}を代わりにサポートし,@var{string}はオプショ
 2826: ンになります.@acronym{POSIX} 1003.1-2001 (@pxref{Standards
 2827: conformance})ではこの古い使用方法を許可していません.移植性がある空の
 2828: @var{string}を指定するため,@option{--sep-string}を使用してください.
 2829: 
 2830: @item -t
 2831: @itemx --omit-header
 2832: @opindex -t
 2833: @opindex --omit-header
 2834: @c Do not print the usual header [and footer] on each page, and do not fill
 2835: @c out the bottom of pages (with blank lines or a form feed).  No page
 2836: @c structure is produced, but form feeds set in the input files are retained.
 2837: @c The predefined pagination is not changed.  @option{-t} or @option{-T} may be
 2838: @c useful together with other options; e.g.: @option{-t -e4}, expand TAB characters
 2839: @c in the input file to 4 spaces but don't make any other changes.  Use of
 2840: @c @option{-t} overrides @option{-h}.
 2841: @c 
 2842: それぞれのページに,通常のヘッダ[とフッタ]を出力せず,ページの底まで補
 2843: 充しません(空白行またはフォームフィードを用います).ページ構造は生成さ
 2844: れませんが,入力ファイルで設定されているフォームフィードは維持されます.
 2845: 前もって定義されたページ化は変更されません.@option{-t}や@option{-T}は,
 2846: 他のオプションとともに使用すると便利かもしれません.例えば,@samp{-t
 2847: -e4}は,入力ファイルのTAB文字を四つのスペースに展開しますが,それ以外
 2848: の変更を行いません.@option{-t}の使用は@option{-h}に優先します.
 2849: 
 2850: @item -T
 2851: @itemx --omit-pagination
 2852: @opindex -T
 2853: @opindex --omit-pagination
 2854: @c Do not print header [and footer].  In addition eliminate all form feeds
 2855: @c set in the input files.
 2856: @c 
 2857: ヘッダ[とフッタ]を出力しません.更に,入力ファイルのフォームフィード設
 2858: 定を全て削除します.
 2859: 
 2860: @item -v
 2861: @itemx --show-nonprinting
 2862: @opindex -v
 2863: @opindex --show-nonprinting
 2864: @c Print nonprinting characters in octal backslash notation.
 2865: @c 
 2866: 出力できない文字を,八進数のバックスラッシュ表記で出力します.
 2867: 
 2868: @item -w @var{page_width}
 2869: @itemx --width=@var{page_width}
 2870: @opindex -w
 2871: @opindex --width
 2872: @c Set page width to @var{page_width} characters for multiple text-column
 2873: @c output only (default for @var{page_width} is 72).  @option{-s[CHAR]} turns
 2874: @c off the default page width and any line truncation and column alignment.
 2875: @c Lines of full length are merged, regardless of the column options
 2876: @c set.  No @var{page_width} setting is possible with single column output.
 2877: @c A @acronym{POSIX}-compliant formulation.
 2878: @c 
 2879: 複数のテキスト列出力に対してのみ,ページ幅を@var{page_width}文字数に設
 2880: 定します(@var{page_width}のデフォルトは72です).@option{-s[CHAR]}は,
 2881: デフォルトページ幅を停止し,すべての行を切り詰め,列を整列します.十分
 2882: な長さの行は,列オプションの設定にかかわらずマージされます.
 2883: @var{page_width}設定が無い場合,おそらく単一列の出力になります.
 2884: @acronym{POSIX}準拠の公式なものです.
 2885: 
 2886: @item -W @var{page_width}
 2887: @itemx --page_width=@var{page_width}
 2888: @opindex -W
 2889: @opindex --page_width
 2890: @c Set the page width to @var{page_width} characters.  That's valid with and
 2891: @c without a column option.  Text lines are truncated, unless @option{-J}
 2892: @c is used.  Together with one of the three column options
 2893: @c (@option{-@var{column}}, @option{-a -@var{column}} or @option{-m}) column
 2894: @c alignment is always used.  The separator options @option{-S} or @option{-s}
 2895: @c don't affect the @option{-W} option.  Default is 72 characters.  Without
 2896: @c @option{-W @var{page_width}} and without any of the column options NO line
 2897: @c truncation is used (defined to keep downward compatibility and to meet
 2898: @c most frequent tasks).  That's equivalent to @option{-W 72 -J}.  The header
 2899: @c line is never truncated.
 2900: @c 
 2901: ページ幅を@var{page_width}文字に設定します.それは列オプションによらず
 2902: 有効です.@option{-J}が使用されない場合,テキスト行は切り詰められます.
 2903: 三列オプション(@option{-@var{column}},@samp{-a -@var{column}},または
 2904: @option{-m})の一つとともに用いた場合,列の整列は常に使用されます.セパ
 2905: レータオプションの@option{-S}や@option{-s}は,@option{-W}オプションに
 2906: 効果がありません.デフォルトは72文字です.@samp{-W @var{page_width}}が
 2907: 無く,あらゆる列オプションが無い場合,行の切り詰めは行われません(下位
 2908: 互換を保つためと,よくある仕事に合わせるために定義されています).それ
 2909: は,@samp{-W 72 -J}と等価です.ヘッダ行は常に切り詰められません.
 2910: 
 2911: @end table
 2912: 
 2913: 
 2914: @node fold invocation
 2915: @c @section @command{fold}: Wrap input lines to fit in specified width
 2916: @section @command{fold}: 指定された幅に合わせるため,入力行を折り曲げる
 2917: 
 2918: @pindex fold
 2919: @cindex wrapping long input lines
 2920: @cindex folding long input lines
 2921: 
 2922: @c @command{fold} writes each @var{file} (@option{-} means standard input), or
 2923: @c standard input if none are given, to standard output, breaking long
 2924: @c lines.  Synopsis:
 2925: @c 
 2926: @command{fold}は,それぞれの@var{file}(@samp{-}は標準入力を意味します)
 2927: や,与えられない場合は標準入力を,長い行を改行しながら標準出力に書き出
 2928: します.概要です.
 2929: 
 2930: @example
 2931: fold [@var{option}]@dots{} [@var{file}]@dots{}
 2932: @end example
 2933: 
 2934: @c By default, @command{fold} breaks lines wider than 80 columns.  The output
 2935: @c is split into as many lines as necessary.
 2936: @c 
 2937: デフォルトで,@command{fold}は80列以上の幅の行を改行します.出力は必要
 2938: な行数に分けられます.
 2939: 
 2940: @cindex screen columns
 2941: @c @command{fold} counts screen columns by default; thus, a tab may count more
 2942: @c than one column, backspace decreases the column count, and carriage
 2943: @c return sets the column to zero.
 2944: @c 
 2945: @command{fold}はデフォルトで画面の列を数えます.このため,タブは一列以
 2946: 上に数えられ,バックスペースは列のカウント数を減らし,そして,キャリッ
 2947: ジリターンは列をゼロに設定します.
 2948: 
 2949: @c The program accepts the following options.  Also see @ref{Common options}.
 2950: @c 
 2951: プログラムは,以下のオプションも受け入れます.@ref{Common options}も参
 2952: 照してください.
 2953: 
 2954: @table @samp
 2955: 
 2956: @item -b
 2957: @itemx --bytes
 2958: @opindex -b
 2959: @opindex --bytes
 2960: @c Count bytes rather than columns, so that tabs, backspaces, and carriage
 2961: @c returns are each counted as taking up one column, just like other
 2962: @c characters.
 2963: @c 
 2964: 列ではなくバイトを数え,そのため,タブ,バックスペースと,キャリッジリ
 2965: ターンは,他の文字同様にそれぞれ一列カウント数を上げます.
 2966: 
 2967: @item -s
 2968: @itemx --spaces
 2969: @opindex -s
 2970: @opindex --spaces
 2971: @c Break at word boundaries: the line is broken after the last blank before
 2972: @c the maximum line length.  If the line contains no such blanks, the line
 2973: @c is broken at the maximum line length as usual.
 2974: @c 
 2975: 単語の境界で改行します.列は最後の空白の後で,最大の列の長さの前で改行
 2976: されます.そのような空白行が行に含まれていない場合,行は最大の行幅で通
 2977: 常通り改行されます.
 2978: 
 2979: @item -w @var{width}
 2980: @itemx --width=@var{width}
 2981: @opindex -w
 2982: @opindex --width
 2983: @c Use a maximum line length of @var{width} columns instead of 80.
 2984: @c 
 2985: 80の代わりに,@var{width}列の最大行幅を使用します.
 2986: 
 2987: @c On older systems, @command{fold} supports an obsolete option
 2988: @c @option{-@var{width}}.  @acronym{POSIX} 1003.1-2001 (@pxref{Standards
 2989: @c conformance}) does not allow this; use @option{-w @var{width}}
 2990: @c instead.
 2991: @c 
 2992: 古いシステムでは,@command{fold}は時代遅れのオプション
 2993: @option{-@var{width}}をサポートしています.@acronym{POSIX} 1003.1-2001
 2994: (@pxref{Standards conformance})では,これは許可されていません.代わり
 2995: に@option{-w @var{width}}を使用してください.
 2996: 
 2997: @end table
 2998: 
 2999: 
 3000: @node Output of parts of files
 3001: @c @chapter Output of parts of files
 3002: @chapter ファイルの一部の出力
 3003: 
 3004: @cindex output of parts of files
 3005: @cindex parts of files, output of
 3006: 
 3007: @c These commands output pieces of the input.
 3008: @c 
 3009: 以下のコマンドは,入力の一部を出力します.
 3010: 
 3011: @menu
 3012: * head invocation::             Output the first part of files.
 3013: * tail invocation::             Output the last part of files.
 3014: * split invocation::            Split a file into fixed-size pieces.
 3015: * csplit invocation::           Split a file into context-determined pieces.
 3016: @end menu
 3017: 
 3018: @node head invocation
 3019: @c @section @command{head}: Output the first part of files
 3020: @section @command{head}: ファイルの最初の部分を出力
 3021: 
 3022: @pindex head
 3023: @cindex initial part of files, outputting
 3024: @cindex first part of files, outputting
 3025: 
 3026: @c @command{head} prints the first part (10 lines by default) of each
 3027: @c @var{file}; it reads from standard input if no files are given or
 3028: @c when given a @var{file} of @option{-}.  Synopsis:
 3029: @c 
 3030: @command{head}は,それぞれの@var{file}の最初の部分(デフォルトで十行)出
 3031: 力します.ファイルが与えられていない場合や,@samp{-}という@var{file}が
 3032: 与えられているときは標準入力から読み込みます.概要です.
 3033: 
 3034: @example
 3035: head [@var{option}]@dots{} [@var{file}]@dots{}
 3036: @end example
 3037: 
 3038: @c If more than one @var{file} is specified, @command{head} prints a
 3039: @c one-line header consisting of
 3040: @c 
 3041: 一つ以上の@var{file}が指定されている場合,@command{head}は以下から成り
 3042: 立つ一行のヘッダを出力します.
 3043: @example
 3044: ==> @var{file name} <==
 3045: @end example
 3046: @noindent
 3047: @c before the output for each @var{file}.
 3048: @c 
 3049: それはそれぞれの@var{file}に対する出力の前になります.
 3050: 
 3051: @c The program accepts the following options.  Also see @ref{Common options}.
 3052: @c 
 3053: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 3054: してください.
 3055: 
 3056: @table @samp
 3057: 
 3058: @item -c @var{bytes}
 3059: @itemx --bytes=@var{bytes}
 3060: @opindex -c
 3061: @opindex --bytes
 3062: @c Print the first @var{bytes} bytes, instead of initial lines.  Appending
 3063: @c @samp{b} multiplies @var{bytes} by 512, @samp{k} by 1024, and @samp{m}
 3064: @c by 1048576.
 3065: @c 
 3066: 最初の行の代わりに,最初の@var{bytes}バイトを出力します.後置される
 3067: @samp{b}は@var{bytes}の512倍,@samp{k}は1024倍,そして@samp{m}は
 3068: 1048576倍になります.
 3069: 
 3070: @itemx -n @var{n}
 3071: @itemx --lines=@var{n}
 3072: @opindex -n
 3073: @opindex --lines
 3074: @c Output the first @var{n} lines.
 3075: @c 
 3076: 最初の@var{n}行を出力します.
 3077: 
 3078: @item -q
 3079: @itemx --quiet
 3080: @itemx --silent
 3081: @opindex -q
 3082: @opindex --quiet
 3083: @opindex --silent
 3084: @c Never print file name headers.
 3085: @c 
 3086: ファイル名のヘッダを出力しません.
 3087: 
 3088: @item -v
 3089: @itemx --verbose
 3090: @opindex -v
 3091: @opindex --verbose
 3092: @c Always print file name headers.
 3093: @c 
 3094: 常にファイル名のヘッダを出力します.
 3095: 
 3096: @end table
 3097: 
 3098: @c On older systems, @command{head} supports an obsolete option
 3099: @c @option{-@var{count}@var{options}}, which is recognized only if it is
 3100: @c specified first.  @var{count} is a decimal number optionally followed
 3101: @c by a size letter (@samp{b}, @samp{k}, @samp{m}) as in @code{-c}, or
 3102: @c @samp{l} to mean count by lines, or other option letters (@samp{cqv}).
 3103: @c @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance}) does not allow
 3104: @c this; use @option{-c @var{count}} or @option{-n @var{count}} instead.
 3105: @c 
 3106: 古いシステムでは,@command{head}は時代遅れのオプション
 3107: @option{-@var{count}@var{options}}をサポートし,それは最初に指定されて
 3108: いる場合だけ認識されます.@var{count}は十進数の数値で,オプションで
 3109: @option{-c}でのサイズ指定文字(@samp{b}, @samp{k}, @samp{m})や,行数を
 3110: 意味する@samp{l},またはそれ以外のオプション文字(@samp{cqv})が続きます.
 3111: @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance})ではこれを
 3112: 許可していません.代わりに@option{-c @var{count}}や@option{-n
 3113: @var{count}} を使用してください.
 3114: 
 3115: @node tail invocation
 3116: @c @section @command{tail}: Output the last part of files
 3117: @section @command{tail}: ファイルの最後の部分を出力
 3118: 
 3119: @pindex tail
 3120: @cindex last part of files, outputting
 3121: 
 3122: @c @command{tail} prints the last part (10 lines by default) of each
 3123: @c @var{file}; it reads from standard input if no files are given or
 3124: @c when given a @var{file} of @samp{-}.  Synopsis:
 3125: @c 
 3126: @command{tail}は,それぞれの@var{file}の最後の部分(デフォルトで十行)出
 3127: 力します.ファイルが与えられていない場合や,@samp{-}という@var{file}が
 3128: 与えられているときは標準入力から読み込みます.概要です.
 3129: 
 3130: @example
 3131: tail [@var{option}]@dots{} [@var{file}]@dots{}
 3132: @end example
 3133: 
 3134: @c If more than one @var{file} is specified, @command{tail} prints a
 3135: @c one-line header consisting of
 3136: @c 
 3137: 一つ以上の@var{file}が指定されている場合,@command{tail}は以下から成り
 3138: 立つ一行のヘッダを出力します.
 3139: @example
 3140: ==> @var{file name} <==
 3141: @end example
 3142: @noindent
 3143: @c before the output for each @var{file}.
 3144: @c 
 3145: それはそれぞれの@var{file}に対する出力の前になります.
 3146: 
 3147: @cindex BSD @command{tail}
 3148: @c @sc{gnu} @command{tail} can output any amount of data (some other versions of
 3149: @c @command{tail} cannot).  It also has no @option{-r} option (print in
 3150: @c reverse), since reversing a file is really a different job from printing
 3151: @c the end of a file; BSD @command{tail} (which is the one with @code{-r}) can
 3152: @c only reverse files that are at most as large as its buffer, which is
 3153: @c typically 32 KiB.  A more reliable and versatile way to reverse files is
 3154: @c the @sc{gnu} @command{tac} command.
 3155: @c 
 3156: @sc{gnu} @command{tail}は,任意の量のデータを出力することが可能です
 3157: (@command{tail}の他のバージョンにはできないものもあります).ファイルを
 3158: 逆順にすることはファイルの終りを出力する作業とは全く異なるので,
 3159: @option{-r}オプション(逆順に出力)もありません.BSD @command{tail}
 3160: (@option{-r}があるものの一つ)は,最大でそのバッファの大きさまで,通常
 3161: 32KiBのファイルを逆順にすることが可能なだけです.ファイルを逆順にする
 3162: より信頼性のある用途が広い方法は,@sc{gnu} @command{tac}コマンドです.
 3163: 
 3164: @c If any option-argument is a number @var{n} starting with a @samp{+},
 3165: @c @command{tail} begins printing with the @var{n}th item from the start of
 3166: @c each file, instead of from the end.
 3167: @c 
 3168: あらゆるオプション引数が,@samp{+}で始まる数字@var{n}の場合,
 3169: @command{tail}はファイルの終りの代わりに,それぞれのファイルの最初から
 3170: @var{n}番目の項目で出力を開始します.
 3171: 
 3172: @c The program accepts the following options.  Also see @ref{Common options}.
 3173: @c 
 3174: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 3175: してください.
 3176: 
 3177: @table @samp
 3178: 
 3179: @item -c @var{bytes}
 3180: @itemx --bytes=@var{bytes}
 3181: @opindex -c
 3182: @opindex --bytes
 3183: @c Output the last @var{bytes} bytes, instead of final lines.  Appending
 3184: @c @samp{b} multiplies @var{bytes} by 512, @samp{k} by 1024, and @samp{m}
 3185: @c by 1048576.
 3186: @c 
 3187: 最後の行の代わりに,最後の@var{bytes}バイトを出力します.後置される
 3188: @samp{b}は@var{bytes}の512倍,@samp{k}は1024倍,そして@samp{m}は
 3189: 1048576倍になります.
 3190: 
 3191: @item -f
 3192: @itemx --follow[=@var{how}]
 3193: @opindex -f
 3194: @opindex --follow
 3195: @cindex growing files
 3196: @vindex name @r{follow option}
 3197: @vindex descriptor @r{follow option}
 3198: @c Loop forever trying to read more characters at the end of the file,
 3199: @c presumably because the file is growing.  This option is ignored when
 3200: @c reading from a pipe.
 3201: @c If more than one file is given, @command{tail} prints a header whenever it
 3202: @c gets output from a different file, to indicate which file that output is
 3203: @c from.
 3204: @c 
 3205: ファイルが増大している可能性があるため,ファイルの終りから,それ以降の
 3206: 文字を読み込むことを永久に繰り返します.このオプションは,パイプから読
 3207: み込まれているとき無視されます.一つ以上のファイルが与えられている場合,
 3208: 出力されてるファイルを示すため,異なるファイルから出力を得るときはいつ
 3209: でも,@command{tail}がヘッダを出力します.
 3210: 
 3211: @c There are two ways to specify how you'd like to track files with this option,
 3212: @c but that difference is noticeable only when a followed file is removed or
 3213: @c renamed.
 3214: @c If you'd like to continue to track the end of a growing file even after
 3215: @c it has been unlinked, use @option{--follow=descriptor}.  This is the default
 3216: @c behavior, but it is not useful if you're tracking a log file that may be
 3217: @c rotated (removed or renamed, then reopened).  In that case, use
 3218: @c @option{--follow=name} to track the named file by reopening it periodically
 3219: @c to see if it has been removed and recreated by some other program.
 3220: @c 
 3221: このオプションでは,ファイルを追跡する方法を指定する方法が二つあります
 3222: が,その違いは,追跡しているファイルが削除されたり名前を変更されたりし
 3223: たとき通知可能だということだけです.リンクが無くなった後でも,増え続け
 3224: るファイルの終りの追跡を続けたい場合は,@option{--follow=descriptor}を
 3225: 使用してください.これはデフォルトの動作ですが,回転(rotate)される(削
 3226: 除や名前の変更がなされ,再び開かれる)ログファイルを追跡しているときは
 3227: 不便です.その場合,他のプログラムにより削除され再作成されたかどうかを
 3228: 周期的に見て,再び開かれる指名されたファイルを追跡するため,
 3229: @option{--follow=name}を使用してください.
 3230: 
 3231: @c No matter which method you use, if the tracked file is determined to have
 3232: @c shrunk, @command{tail} prints a message saying the file has been truncated
 3233: @c and resumes tracking the end of the file from the newly-determined endpoint.
 3234: @c 
 3235: 使用している方法にかかわらず,追跡しているファイルが縮まっていると決定
 3236: された場合,@command{tail}はファイルが切り詰められたことを告げるメッセー
 3237: ジを出力し,新たに決定された終端からファイルの終りを再追跡しはじめます.
 3238: 
 3239: @c When a file is removed, @command{tail}'s behavior depends on whether it is
 3240: @c following the name or the descriptor.  When following by name, tail can
 3241: @c detect that a file has been removed and gives a message to that effect,
 3242: @c and if @option{--retry} has been specified it will continue checking
 3243: @c periodically to see if the file reappears.
 3244: @c When following a descriptor, tail does not detect that the file has
 3245: @c been unlinked or renamed and issues no message;  even though the file
 3246: @c may no longer be accessible via its original name, it may still be
 3247: @c growing.
 3248: @c 
 3249: ファイルが削除されたとき,@command{tail}の動作は名前で続けるか記述子で
 3250: 続けるかに依存します.名前で続けるとき,@command{tail}はファイルが削除
 3251: されたことを検出し,その影響のメッセージを与えることが可能で,
 3252: @option{--retry}が指定されている場合,ファイルが再び現れたかどうかを見
 3253: るため周期的な調査を続けるでしょう.記述子で続けるとき,@command{tail} 
 3254: はファイルのリンクが切れたり名前が変更されたことを検出せず,メッセージ
 3255: を出力しません.ファイルは既に元の名前でアクセスできませんが,まだ増加
 3256: しているかもしれません.
 3257: 
 3258: @c The option values @samp{descriptor} and @samp{name} may be specified only
 3259: @c with the long form of the option, not with @option{-f}.
 3260: @c 
 3261: オプション値の@samp{descriptor}と@samp{name}はオプションの長い形式での
 3262: み指定でき,@option{-f}では指定できません.
 3263: 
 3264: @item -F
 3265: @opindex -F
 3266: @c This option is the same as @option{--follow=name --retry}.  That is, tail
 3267: @c will attempt to reopen a file when it is removed.  Should this fail, tail
 3268: @c will keep trying until it becomes accessible again.
 3269: @c 
 3270: このオプションは@option{--follow=name --retry}と同じです.すなわち,
 3271: @command{tail}は削除されたときファイルを再び開こうとします.これが失敗
 3272: しても,@command{tail}は再びアクセス可能になるまで挑戦し続けます.
 3273: 
 3274: @itemx --retry
 3275: @opindex --retry
 3276: @c This option is meaningful only when following by name.
 3277: @c Without this option, when tail encounters a file that doesn't
 3278: @c exist or is otherwise inaccessible, it reports that fact and
 3279: @c never checks it again.
 3280: @c 
 3281: このオプションは,名前で続けるときだけ意味があります.このオプションが
 3282: 無い場合,存在していないまたはアクセスできないファイルに@command{tail} 
 3283: が遭遇したとき,それはその事実を報告し再び調査しません.
 3284: 
 3285: @itemx --sleep-interval=@var{number}
 3286: @opindex --sleep-interval
 3287: @c Change the number of seconds to wait between iterations (the default is 1.0).
 3288: @c During one iteration, every specified file is checked to see if it has
 3289: @c Historical implementations of @command{tail} have required that
 3290: @c @var{number} be an integer.  However, GNU @command{tail} accepts
 3291: @c an arbitrary floating point number.
 3292: @c 
 3293: 繰り返しの間の待ち時間の秒数を変更します(デフォルトは1.0秒).待ってい
 3294: る間,指定された全てのファイルは大きさが変ったかどうか調査されます.
 3295: @command{tail}の歴史的な実装では,@var{number}を整数にする必要がありま
 3296: した.しかし,@sc{gnu} @command{tail}は任意の浮動小数点の数値を受け入
 3297: れます.
 3298: 
 3299: @itemx --pid=@var{pid}
 3300: @opindex --pid
 3301: @c When following by name or by descriptor, you may specify the process ID,
 3302: @c @var{pid}, of the sole writer of all @var{file} arguments.  Then, shortly
 3303: @c after that process terminates, tail will also terminate.  This will
 3304: @c work properly only if the writer and the tailing process are running on
 3305: @c the same machine.  For example, to save the output of a build in a file
 3306: @c and to watch the file grow, if you invoke @command{make} and @command{tail}
 3307: @c like this then the tail process will stop when your build completes.
 3308: @c Without this option, you would have had to kill the @code{tail -f}
 3309: @c process yourself.
 3310: @c 
 3311: 名前または記述子で続ける場合,全ての@var{file}引数に唯一書き込んでいる
 3312: プロセスID @var{pid}を指定してもかまいません.そして,プロセスが終了し
 3313: た少し後で@command{tail}も終了します.これは書き込んでいるものと
 3314: @command{tail}プロセスが同じマシンで動作している場合のみ正確に動作しま
 3315: す.例えば,ファイルにビルドの出力を保存したりファイルが大きくなるのを
 3316: 見たりするため@command{make}と@command{tail}を以下のように呼び出し,ビ
 3317: ルドが完了したとき@command{tail}の処理は終了します.このオプションを用
 3318: いない場合,@code{tail -f}プロセスを自分で停止する必要があります.
 3319: @example
 3320: $ make >& makerr & tail --pid=$! -f makerr
 3321: @end example
 3322: @c If you specify a @var{pid} that is not in use or that does not correspond
 3323: @c to the process that is writing to the tailed files, then @command{tail}
 3324: @c may terminate long before any @var{file}s stop growing or it may not
 3325: @c terminate until long after the real writer has terminated.
 3326: @c Note that @option{--pid} cannot be supported on some systems; @command{tail}
 3327: @c will print a warning if this is the case.
 3328: @c 
 3329: 使用中でない,または,@command{tail}されているファイルに書き込んでいる
 3330: プロセスに対応しない@var{pid}を指定した場合,@command{tail}はあらゆる
 3331: @var{file}の増加が終了するよりかなり前に終了したり,実際に書き込んでい
 3332: るものが終了してしばらくしても終了しないかもしれません.@option{--pid}
 3333: はシステムによってはサポートできないことに注意してください.その状況で
 3334: は,@command{tail}は警告を出力します.
 3335: 
 3336: @itemx --max-unchanged-stats=@var{n}
 3337: @opindex --max-unchanged-stats
 3338: @c When tailing a file by name, if there have been @var{n} (default
 3339: @c n=@value{DEFAULT_MAX_N_UNCHANGED_STATS_BETWEEN_OPENS}) consecutive
 3340: @c iterations for which the size has remained the same, then
 3341: @c @code{open}/@code{fstat} the file to determine if that file name is
 3342: @c still associated with the same device/inode-number pair as before.
 3343: @c When following a log file that is rotated, this is approximately the
 3344: @c number of seconds between when tail prints the last pre-rotation lines
 3345: @c and when it prints the lines that have accumulated in the new log file.
 3346: @c This option is meaningful only when following by name.
 3347: @c 
 3348: 名前でファイルを@command{tail}しているとき,@var{n}(デフォルトで
 3349: n=@value{DEFAULT_MAX_N_UNCHANGED_STATS_BETWEEN_OPENS})回連続して大きさ
 3350: が同じ場合,ファイル名が以前と同じデバイス/inode番号の組に関連している
 3351: かどうかを決定するため,ファイルに対して@code{open}/@code{fstat}を実行
 3352: します.回転(rotate)されているログファイルを追跡しているとき,前回に回
 3353: 転(rotate)した行を@command{tail}が出力するときと,新しいログファイルで
 3354: 蓄積された行を出力するときの間は,おそらく数秒になります.このオプショ
 3355: ンは,名前で追跡しているときのみ意味があります.
 3356: 
 3357: @itemx -n @var{n}
 3358: @itemx --lines=@var{n}
 3359: @opindex -n
 3360: @opindex --lines
 3361: @c Output the last @var{n} lines.
 3362: @c 
 3363: 最後の@var{n}行出力します.
 3364: 
 3365: @item -q
 3366: @itemx --quiet
 3367: @itemx --silent
 3368: @opindex -q
 3369: @opindex --quiet
 3370: @opindex --silent
 3371: @c Never print file name headers.
 3372: @c 
 3373: ファイル名のヘッダを出力しません.
 3374: 
 3375: @item -v
 3376: @itemx --verbose
 3377: @opindex -v
 3378: @opindex --verbose
 3379: @c Always print file name headers.
 3380: @c 
 3381: 常にファイル名のヘッダを出力します.
 3382: 
 3383: @end table
 3384: 
 3385: @c On older systems, @command{tail} supports an obsolete option
 3386: @c @option{-@var{count}@var{options}}, which is recognized only if it is
 3387: @c specified first.  @var{count} is a decimal number optionally followed
 3388: @c by a size letter (@samp{b}, @samp{k}, @samp{m}) as in @code{-c}, or
 3389: @c @samp{l} to mean count by lines, or other option letters
 3390: @c (@samp{cfqv}).  Some older @command{tail} implementations also support
 3391: @c an obsolete option @option{+@var{count}} with the same meaning as
 3392: @c @option{-+@var{count}}.  @acronym{POSIX} 1003.1-2001 (@pxref{Standards
 3393: @c conformance}) does not allow these options; use @option{-c
 3394: @c @var{count}} or @option{-n @var{count}} instead.
 3395: @c 
 3396: 古いシステムでは,@command{tail}は時代遅れのオプション
 3397: @option{-@var{count}@var{options}}をサポートし,それは最初に指定されて
 3398: いる場合だけ認識されます.@var{count}は十進数の数値で,オプションで
 3399: @option{-c}でのサイズ指定文字(@samp{b},@samp{k},@samp{m})や,行数を
 3400: 意味する@samp{l},またはそれ以外のオプション文字(@samp{cfqv})が続きま
 3401: す.古いシステムには,@option{-+@var{count}}と同じ意味がある時代遅れの
 3402: オプション@option{+@var{count}}をサポートしているものもあります.
 3403: @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance})ではこれら
 3404: を許可していません.代わりに@option{-c @var{count}}や@option{-n
 3405: @var{count}}を使用してください.
 3406: 
 3407: @node split invocation
 3408: @c @section @command{split}: Split a file into fixed-size pieces
 3409: @section @command{split}: ファイルを固定サイズの部分に分割
 3410: 
 3411: @pindex split
 3412: @cindex splitting a file into pieces
 3413: @cindex pieces, splitting a file into
 3414: 
 3415: @c @command{split} creates output files containing consecutive sections of
 3416: @c @var{input} (standard input if none is given or @var{input} is
 3417: @c @samp{-}).  Synopsis:
 3418: @c 
 3419: @command{split}は,@var{input}(何も与えられなかったり,@var{input}が
 3420: @samp{-}の場合は標準入力)の連続したセクションを含む出力ファイルを生成
 3421: します.概要です.
 3422: 
 3423: @example
 3424: split [@var{option}] [@var{input} [@var{prefix}]]
 3425: @end example
 3426: 
 3427: @c By default, @command{split} puts 1000 lines of @var{input} (or whatever is
 3428: @c left over for the last section), into each output file.
 3429: @c 
 3430: デフォルトで,@command{split}は@var{input}の1000行(または,最後のセク
 3431: ションでは残り)を,それぞれの出力ファイルに書き込みます.
 3432: 
 3433: @cindex output file name prefix
 3434: @c The output files' names consist of @var{prefix} (@samp{x} by default)
 3435: @c followed by a group of letters (@samp{aa}, @samp{ab}, @dots{} by default),
 3436: @c such that concatenating the output files in sorted order by file name produces
 3437: @c the original input file.  If the output file names are exhausted,
 3438: @c @command{split} reports an error without deleting the output files
 3439: @c that it did create.
 3440: @c 
 3441: 出力ファイルの名前は@var{prefix}(デフォルトは@samp{x})にグループ文字
 3442: (デフォルトで@samp{aa},@samp{ab},@dots{})が続くものから成り立ってい
 3443: て,それで,出力ファイルをファイル名の順番でソートして結合したものが,
 3444: 元の入力ファイルを生成するようになっています.出力ファイル名を使い切っ
 3445: た場合,@command{split}は作成された出力ファイルを削除せずにエラーを報
 3446: 告します.
 3447: 
 3448: @c The program accepts the following options.  Also see @ref{Common options}.
 3449: @c 
 3450: このプログラムは以下のオプションも受け入れます.@ref{Common options}も
 3451: 参照してください.
 3452: 
 3453: @table @samp
 3454: 
 3455: @item -a @var{length}
 3456: @itemx --suffix-length=@var{length}
 3457: @opindex -a
 3458: @opindex --suffix-length
 3459: @c Use suffixes of length @var{length}.  The default @var{length} is 2.
 3460: @c 
 3461: 長さ@var{length}の接尾子を使用します.デフォルトの@var{length}は2です.
 3462: 
 3463: @item -l @var{lines}
 3464: @itemx --lines=@var{lines}
 3465: @opindex -l
 3466: @opindex --lines
 3467: @c Put @var{lines} lines of @var{input} into each output file.
 3468: @c 
 3469: @var{input}の@var{lines}行をそれぞれの出力ファイルに書き込みます.
 3470: 
 3471: @c On older systems, @command{split} supports an obsolete option
 3472: @c @option{-@var{lines}}.  @acronym{POSIX} 1003.1-2001 (@pxref{Standards
 3473: @c conformance}) does not allow this; use @option{-l @var{lines}}
 3474: @c instead.
 3475: @c 
 3476: 古いシステムでは,@command{split}は時代遅れのオプション
 3477: @option{-@var{lines}}をサポートしています.@acronym{POSIX} 1003.1-2001
 3478: (@pxref{Standards conformance})ではこれを許可していません.代わりに
 3479: @option{-l @var{lines}}を使用してください.
 3480: 
 3481: @item -b @var{bytes}
 3482: @itemx --bytes=@var{bytes}
 3483: @opindex -b
 3484: @opindex --bytes
 3485: @c Put the first @var{bytes} bytes of @var{input} into each output file.
 3486: @c Appending @samp{b} multiplies @var{bytes} by 512, @samp{k} by 1024, and
 3487: @c @samp{m} by 1048576.
 3488: @c 
 3489: @var{input}の最初の@var{bytes}バイトを,それぞれの出力ファイルに書き込
 3490: みます.@samp{b}の後置は@var{bytes}の512倍,@samp{k}は1024倍,そして
 3491: @samp{m}は1048576倍です.
 3492: 
 3493: @item -C @var{bytes}
 3494: @itemx --line-bytes=@var{bytes}
 3495: @opindex -C
 3496: @opindex --line-bytes
 3497: @c Put into each output file as many complete lines of @var{input} as
 3498: @c possible without exceeding @var{bytes} bytes.  For lines longer than
 3499: @c @var{bytes} bytes, put @var{bytes} bytes into each output file until
 3500: @c less than @var{bytes} bytes of the line are left, then continue
 3501: @c normally.  @var{bytes} has the same format as for the @option{--bytes}
 3502: @c option.
 3503: @c 
 3504: @var{bytes}バイトを越えない@var{input}の完全な行を,できるだけ多くそれ
 3505: ぞれの出力ファイルに書き込みます.@var{bytes}バイトより長い行に対して
 3506: は,行の@var{bytes}バイトより少ない部分が残るまで,それぞれの出力ファ
 3507: イルに@var{bytes}バイト書き込み,それから通常通りに続けます.
 3508: @var{bytes}は@option{--bytes}オプションに対するものと同じ書式です.
 3509: 
 3510: @itemx --verbose
 3511: @opindex --verbose
 3512: @c Write a diagnostic to standard error just before each output file is opened.
 3513: @c 
 3514: それぞれの出力ファイルが開かれる直前に,標準エラー出力に状態を書き込み
 3515: ます.
 3516: 
 3517: @end table
 3518: 
 3519: 
 3520: @node csplit invocation
 3521: @c @section @command{csplit}: Split a file into context-determined pieces
 3522: @section @command{csplit}: ファイルを文脈で決定された部分に分割
 3523: 
 3524: @pindex csplit
 3525: @cindex context splitting
 3526: @cindex splitting a file into pieces by context
 3527: 
 3528: @c @command{csplit} creates zero or more output files containing sections of
 3529: @c @var{input} (standard input if @var{input} is @samp{-}).  Synopsis:
 3530: @c 
 3531: @command{csplit}は,@var{input}(@var{input}が@samp{-}の場合は標準入力) 
 3532: のセクションを含む,ゼロ以上の出力ファイルを作成します.概要です.
 3533: 
 3534: @example
 3535: csplit [@var{option}]@dots{} @var{input} @var{pattern}@dots{}
 3536: @end example
 3537: 
 3538: @c The contents of the output files are determined by the @var{pattern}
 3539: @c arguments, as detailed below.  An error occurs if a @var{pattern}
 3540: @c argument refers to a nonexistent line of the input file (e.g., if no
 3541: @c remaining line matches a given regular expression).  After every
 3542: @c @var{pattern} has been matched, any remaining input is copied into one
 3543: @c last output file.
 3544: @c 
 3545: 出力ファイルの内容は,後で詳述する@var{pattern}引数で決定されます.
 3546: @var{pattern}引数が入力ファイルに存在しない行を参照する場合,エラーが
 3547: 発生します(例えば,残っている行が与えられた正規表現にマッチしない場合).
 3548: 全ての@var{pattern}がマッチした後,残りの入力は一つの最後の出力ファイ
 3549: ルにコピーされます.
 3550: 
 3551: @c By default, @command{csplit} prints the number of bytes written to each
 3552: @c output file after it has been created.
 3553: @c 
 3554: デフォルトで,@command{csplit}は,それぞれの出力ファイルが作成された後,
 3555: バイト数をそのファイルに書き込みます.
 3556: 
 3557: @c The types of pattern arguments are:
 3558: @c 
 3559: @var{pattern}引数の形式は以下の通りです.
 3560: 
 3561: @table @samp
 3562: 
 3563: @item @var{n}
 3564: @c Create an output file containing the input up to but not including line
 3565: @c @var{n} (a positive integer).  If followed by a repeat count, also
 3566: @c create an output file containing the next @var{line} lines of the input
 3567: @c file once for each repeat.
 3568: @c 
 3569: @var{n}行までの入力を含む出力ファイルを作成しますが,@var{n}行は含みま
 3570: せん.繰り返し数が続く場合,それぞれの繰り返しに対し,入力ファイルの次
 3571: の@var{line}行を含む出力ファイルも作成します.
 3572: 
 3573: @item /@var{regexp}/[@var{offset}]
 3574: @c Create an output file containing the current line up to (but not
 3575: @c including) the next line of the input file that contains a match for
 3576: @c @var{regexp}.  The optional @var{offset} is a @samp{+} or @samp{-}
 3577: @c followed by a positive integer.  If it is given, the input up to the
 3578: @c matching line plus or minus @var{offset} is put into the output file,
 3579: @c and the line after that begins the next section of input.
 3580: @c 
 3581: @var{regexp}にマッチするものを含む入力ファイルの次の行まで,現在の行
 3582: (ただし,マッチは含まれない)を含む出力ファイルを作成します.オプション
 3583: の@var{offset}は,@samp{+}または@samp{-}に正の整数が続きます.与えられ
 3584: た場合,マッチした行までの入力に,@var{offset}加えた,または引いた入力
 3585: まで出力ファイルに書き出され,その後の行は入力の次の部分になります.
 3586: 
 3587: @item %@var{regexp}%[@var{offset}]
 3588: @c Like the previous type, except that it does not create an output
 3589: @c file, so that section of the input file is effectively ignored.
 3590: @c 
 3591: 前の形式に似ていますが,出力ファイルを作成しないので,入力ファイルの部
 3592: 分は効率的に無視されます.
 3593: 
 3594: @item @{@var{repeat-count}@}
 3595: @c Repeat the previous pattern @var{repeat-count} additional
 3596: @c times. @var{repeat-count} can either be a positive integer or an
 3597: @c asterisk, meaning repeat as many times as necessary until the input is
 3598: @c exhausted.
 3599: @c 
 3600: 前のパターンを@var{repeat-count}回余分に繰り返します.
 3601: @var{repeat-count}は正の整数,またはアスタリスクになり,それは入力が使
 3602: い果たされるのに必要なだけ繰り返すことを意味します.
 3603: 
 3604: @end table
 3605: 
 3606: @c The output files' names consist of a prefix (@samp{xx} by default)
 3607: @c followed by a suffix.  By default, the suffix is an ascending sequence
 3608: @c of two-digit decimal numbers from @samp{00} to @samp{99}.  In any case,
 3609: @c concatenating the output files in sorted order by filename produces the
 3610: @c original input file.
 3611: @c 
 3612: 出力ファイル名は,前置(デフォルトで@samp{xx})とそれに続く接尾子から成
 3613: り立ちます.デフォルトで接尾子は二桁の十進数で,@samp{00}から@samp{99}
 3614: まで順番に上昇します.あらゆる状況で,ファイル名の順番でソートされた出
 3615: 力ファイルを連結すると,元の入力ファイルを生成します.
 3616: 
 3617: @c By default, if @command{csplit} encounters an error or receives a hangup,
 3618: @c interrupt, quit, or terminate signal, it removes any output files
 3619: @c that it has created so far before it exits.
 3620: @c 
 3621: デフォルトで,@command{csplit}がエラーや,ハングアップ,中断,終了,ま
 3622: たは終端シグナルを検出した場合,それまでに存在する作成されたあらゆる出
 3623: 力ファイルを削除します.
 3624: 
 3625: @c The program accepts the following options.  Also see @ref{Common options}.
 3626: @c 
 3627: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 3628: してください.
 3629: 
 3630: @table @samp
 3631: 
 3632: @item -f @var{prefix}
 3633: @itemx --prefix=@var{prefix}
 3634: @opindex -f
 3635: @opindex --prefix
 3636: @cindex output file name prefix
 3637: @c Use @var{prefix} as the output file name prefix.
 3638: @c 
 3639: 出力ファイルの接尾子として,@var{prefix}を使用します.
 3640: 
 3641: @item -b @var{suffix}
 3642: @itemx --suffix=@var{suffix}
 3643: @opindex -b
 3644: @opindex --suffix
 3645: @cindex output file name suffix
 3646: @c Use @var{suffix} as the output file name suffix.  When this option is
 3647: @c specified, the suffix string must include exactly one
 3648: @c @code{printf(3)}-style conversion specification, possibly including
 3649: @c format specification flags, a field width, a precision specifications,
 3650: @c or all of these kinds of modifiers.  The format letter must convert a
 3651: @c binary integer argument to readable form; thus, only @samp{d}, @samp{i},
 3652: @c @samp{u}, @samp{o}, @samp{x}, and @samp{X} conversions are allowed.  The
 3653: @c entire @var{suffix} is given (with the current output file number) to
 3654: @c @code{sprintf(3)} to form the file name suffixes for each of the
 3655: @c individual output files in turn.  If this option is used, the
 3656: @c @option{--digits} option is ignored.
 3657: @c 
 3658: 出力ファイル名の接尾子として@var{suffix}を使用します.このオプションが
 3659: 指定されている場合,接尾子の文字列は,一つだけの@code{printf(3)}形式の
 3660: 変換での指定を含んでいる必要があり,おそらく,書式指定のフラグ,フィー
 3661: ルドの幅,精密さの指定,またはこれら全ての修飾語を含みます.フォーマッ
 3662: ト文字は,二進数の整数の引数を可読なものに変換する必要があります.この
 3663: ため,@samp{d},@samp{i},@samp{u},@samp{o},@samp{x},そして@samp{X}
 3664: の変換は可能です.完全な@var{suffix}は,それぞれの個別な出力ファイルに
 3665: 対し,ファイル名の接尾子を順番に形成するため(現在の出力ファイル数とと
 3666: もに) @code{sprintf(3)}に与えられます.このオプションを使用した場合,
 3667: @option{--digits}オプションは無視されます.
 3668: 
 3669: @item -n @var{digits}
 3670: @itemx --digits=@var{digits}
 3671: @opindex -n
 3672: @opindex --digits
 3673: @c Use output file names containing numbers that are @var{digits} digits
 3674: @c long instead of the default 2.
 3675: @c 
 3676: デフォルトの2の代わりに@var{digits}桁の長さの数字を含む出力ファイル名
 3677: を使用します.
 3678: 
 3679: @item -k
 3680: @itemx --keep-files
 3681: @opindex -k
 3682: @opindex --keep-files
 3683: @c Do not remove output files when errors are encountered.
 3684: @c 
 3685: エラーが検出された場合でも出力ファイルを削除しません.
 3686: 
 3687: @item -z
 3688: @itemx --elide-empty-files
 3689: @opindex -z
 3690: @opindex --elide-empty-files
 3691: @c Suppress the generation of zero-length output files.  (In cases where
 3692: @c the section delimiters of the input file are supposed to mark the first
 3693: @c lines of each of the sections, the first output file will generally be a
 3694: @c zero-length file unless you use this option.)  The output file sequence
 3695: @c numbers always run consecutively starting from 0, even when this option
 3696: @c is specified.
 3697: @c 
 3698: 長さゼロの出力ファイルの生成を抑制します.(入力ファイルのセクションを
 3699: 分離するものがそれぞれのセクションの最初の行に印を付ける状況では,この
 3700: オプションを使用しない限り,最初の出力ファイルは,通常長さゼロのファイ
 3701: ルになります.)出力ファイルの順番は,このオプションが指定されていると
 3702: きでさえ,0から始まる連続したものになります.
 3703: 
 3704: @item -s
 3705: @itemx -q
 3706: @itemx --silent
 3707: @itemx --quiet
 3708: @opindex -s
 3709: @opindex -q
 3710: @opindex --silent
 3711: @opindex --quiet
 3712: @c Do not print counts of output file sizes.
 3713: @c 
 3714: 出力ファイルの大きさを出力しません.
 3715: 
 3716: @end table
 3717: 
 3718: 
 3719: @node Summarizing files
 3720: @c @chapter Summarizing files
 3721: @chapter ファイルの要約
 3722: 
 3723: @cindex summarizing files
 3724: 
 3725: @c These commands generate just a few numbers representing entire
 3726: @c contents of files.
 3727: @c 
 3728: 以下のコマンドは,ファイルの内容全体を表現するいくつかの数字を生成しま
 3729: す.
 3730: 
 3731: @menu
 3732: * wc invocation::               Print byte, word, and line counts.
 3733: * sum invocation::              Print checksum and block counts.
 3734: * cksum invocation::            Print CRC checksum and byte counts.
 3735: * md5sum invocation::           Print or check message-digests.
 3736: @end menu
 3737: 
 3738: 
 3739: @node wc invocation
 3740: @c @section @command{wc}: Print byte, word, and line counts
 3741: @section @command{wc}: バイト,単語,行数を出力
 3742: 
 3743: @pindex wc
 3744: @cindex byte count
 3745: @cindex character count
 3746: @cindex word count
 3747: @cindex line count
 3748: 
 3749: @c @command{wc} counts the number of bytes, characters, whitespace-separated
 3750: @c words, and newlines in each given @var{file}, or standard input if none
 3751: @c are given or for a @var{file} of @samp{-}.  Synopsis:
 3752: @c 
 3753: @command{wc}は,それぞれの与えられた@var{file}や,与えられなかった場合
 3754: や@samp{-}の@var{file}に対し,バイト数,文字,空白で区切られた単語,そ
 3755: して改行を数えます.概要です.
 3756: 
 3757: @example
 3758: wc [@var{option}]@dots{} [@var{file}]@dots{}
 3759: @end example
 3760: 
 3761: @cindex total counts
 3762: @vindex POSIXLY_CORRECT
 3763: @c @command{wc} prints one line of counts for each file, and if the file was
 3764: @c given as an argument, it prints the file name following the counts.  If
 3765: @c more than one @var{file} is given, @command{wc} prints a final line
 3766: @c containing the cumulative counts, with the file name @file{total}.  The
 3767: @c counts are printed in this order: newlines, words, characters, bytes.
 3768: @c By default, each count is output right-justified in a 7-byte field with
 3769: @c one space between fields so that the numbers and file names line up nicely
 3770: @c in columns.  However, @acronym{POSIX} requires that there be exactly one space
 3771: @c separating columns.  You can make @command{wc} use the @acronym{POSIX}-mandated
 3772: @c output format by setting the @env{POSIXLY_CORRECT} environment variable.
 3773: @c 
 3774: @command{wc}は,それぞれのファイルに対し,数えたものを一行出力し,ファ
 3775: イルが引数として与えられた場合,数に続けてファイル名を出力します.一つ
 3776: 以上の@var{file}が与えられた場合,@command{wc}は,ファイル名
 3777: @file{total}と共に,累積された数を最終行に出力します.数は,以下の順序
 3778: で出力されます.改行,単語,文字,バイトです.デフォルトで,それぞれの
 3779: 数は,数字とファイル名の行が列にうまく並ぶように,右寄せで,七バイト
 3780: フィールドで,それぞれのフィールドの間にスペースを入れて出力します.し
 3781: かし,@acronym{POSIX}では列を分けるものは,一つだけのスペースであるこ
 3782: とを要求します.@env{POSIXLY_CORRECT}環境変数を設定することで,
 3783: @command{wc}を出力形式が@acronym{POSIX}で義務化されているようにさせる
 3784: ことが可能です.
 3785: 
 3786: @c By default, @command{wc} prints three counts: the newline, words, and byte
 3787: @c counts.  Options can specify that only certain counts be printed.
 3788: @c Options do not undo others previously given, so
 3789: @c 
 3790: デフォルトで,@command{wc}は三つの数すべてを出力します.オプションで,
 3791: 出力したい数のみを指定することができます.オプションは,前に与えられた
 3792: ものを元に戻すことはできません.そのため,以下のようにした場合を考えま
 3793: す.
 3794: 
 3795: @example
 3796: wc --bytes --words
 3797: @end example
 3798: 
 3799: @noindent
 3800: @c prints both the byte counts and the word counts.
 3801: @c 
 3802: これは,バイト数と単語の数の両方を出力します.
 3803: 
 3804: @c With the @code{--max-line-length} option, @command{wc} prints the length
 3805: @c of the longest line per file, and if there is more than one file it
 3806: @c prints the maximum (not the sum) of those lengths.
 3807: @c 
 3808: @option{--max-line-length}オプションを用いた場合,@command{wc}はファイ
 3809: ルごとの最長の行の長さを出力し,一つ以上のファイルがある場合,それらの
 3810: 長さの(合計ではなく)最大を出力します.
 3811: 
 3812: @c The program accepts the following options.  Also see @ref{Common options}.
 3813: @c 
 3814: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照し
 3815: てください.
 3816: 
 3817: @table @samp
 3818: 
 3819: @item -c
 3820: @itemx --bytes
 3821: @opindex -c
 3822: @opindex --bytes
 3823: @c Print only the byte counts.
 3824: @c 
 3825: バイト数のみ出力します.
 3826: 
 3827: @item -m
 3828: @itemx --chars
 3829: @opindex -m
 3830: @opindex --chars
 3831: @c Print only the character counts.
 3832: @c 
 3833: 文字数のみ出力します.
 3834: 
 3835: @item -w
 3836: @itemx --words
 3837: @opindex -w
 3838: @opindex --words
 3839: @c Print only the word counts.
 3840: @c 
 3841: 単語数のみ出力します.
 3842: 
 3843: @item -l
 3844: @itemx --lines
 3845: @opindex -l
 3846: @opindex --lines
 3847: @c Print only the newline counts.
 3848: @c 
 3849: 改行数のみ出力します.
 3850: 
 3851: @item -L
 3852: @itemx --max-line-length
 3853: @opindex -L
 3854: @opindex --max-line-length
 3855: @c Print only the maximum line lengths.
 3856: @c 
 3857: 最長行の長さのみ出力します.
 3858: 
 3859: @end table
 3860: 
 3861: 
 3862: @node sum invocation
 3863: @c @section @command{sum}: Print checksum and block counts
 3864: @section @command{sum}: チェックサムとブロック数を出力
 3865: 
 3866: @pindex sum
 3867: @cindex 16-bit checksum
 3868: @cindex checksum, 16-bit
 3869: 
 3870: @c @command{sum} computes a 16-bit checksum for each given @var{file}, or
 3871: @c standard input if none are given or for a @var{file} of @samp{-}.  Synopsis:
 3872: @c 
 3873: @command{sum}は,与えられたそれぞれの@var{file},または,与えられない
 3874: 場合や@samp{-}のファイルが与えられた場合は標準入力の16ビットのチェック
 3875: サムを計算します.概要です.
 3876: 
 3877: @example
 3878: sum [@var{option}]@dots{} [@var{file}]@dots{}
 3879: @end example
 3880: 
 3881: @c @command{sum} prints the checksum for each @var{file} followed by the
 3882: @c number of blocks in the file (rounded up).  If more than one @var{file}
 3883: @c is given, file names are also printed (by default).  (With the
 3884: @c @option{--sysv} option, corresponding file names are printed when there is
 3885: @c at least one file argument.)
 3886: @c 
 3887: @command{sum}は,それぞれの@var{file}のチェックサムに続けて,ファイル
 3888: のブロック数を(切り上げで)出力します.一つ以上の@var{file}が与えられた
 3889: 場合,ファイル名も出力します(デフォルト).(@option{--sysv}オプションを
 3890: 指定した場合,少なくとも一つのファイル引数があるときは,対応するファイ
 3891: ル名が出力されます.)
 3892: 
 3893: @c By default, @sc{gnu} @command{sum} computes checksums using an algorithm
 3894: @c compatible with BSD @command{sum} and prints file sizes in units of
 3895: @c 1024-byte blocks.
 3896: @c 
 3897: デフォルトで,@sc{gnu} @command{sum}は,BSD @command{sum}と互換性のあ
 3898: るアルゴリズムを用いて計算し,ファイルサイズを1024バイトブロックの単位
 3899: で出力します.
 3900: 
 3901: @c The program accepts the following options.  Also see @ref{Common options}.
 3902: @c 
 3903: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
 3904: してください.
 3905: 
 3906: @table @samp
 3907: 
 3908: @item -r
 3909: @opindex -r
 3910: @cindex BSD @command{sum}
 3911: @c Use the default (BSD compatible) algorithm.  This option is included for
 3912: @c compatibility with the System V @command{sum}.  Unless @option{-s} was also
 3913: @c given, it has no effect.
 3914: @c 
 3915: デフォルト(BSD互換)のアルゴリズムを使用します.このオプションは,
 3916: System V @command{sum}との互換性も含みます.@option{-s}を与えない限り,
 3917: 効果はありません.
 3918: 
 3919: @item -s
 3920: @itemx --sysv
 3921: @opindex -s
 3922: @opindex --sysv
 3923: @cindex System V @command{sum}
 3924: @c Compute checksums using an algorithm compatible with System V
 3925: @c @command{sum}'s default, and print file sizes in units of 512-byte blocks.
 3926: @c 
 3927: System V @command{sum}のデフォルトと互換のアルゴリズムを使用して,チェッ
 3928: クサムを計算し,512バイトブロックの単位でファイルサイズを出力します.
 3929: 
 3930: @end table
 3931: 
 3932: @c @command{sum} is provided for compatibility; the @command{cksum} program (see
 3933: @c next section) is preferable in new applications.
 3934: @c 
 3935: @command{sum}は,互換性のために提供されています.新しいアプリケーショ
 3936: ンでは,@command{cksum}プログラム(次のセクションを参照)が望ましいでしょ
 3937: う.
 3938: 
 3939: 
 3940: @node cksum invocation
 3941: @c @section @command{cksum}: Print CRC checksum and byte counts
 3942: @section @command{cksum}: CRCチェックサムとバイトカウントを出力
 3943: 
 3944: @pindex cksum
 3945: @cindex cyclic redundancy check
 3946: @cindex CRC checksum
 3947: 
 3948: @c @command{cksum} computes a cyclic redundancy check (CRC) checksum for each
 3949: @c given @var{file}, or standard input if none are given or for a
 3950: @c @var{file} of @samp{-}.  Synopsis:
 3951: @c 
 3952: @command{cksum}は,与えられたそれぞれの@var{file},または,与えられな
 3953: い場合や@samp{-}のファイルが与えられた場合は標準入力の周期的な冗長性の
 3954: 調査(CRC)のチェックサムを計算します.概要です.
 3955: 
 3956: @example
 3957: cksum [@var{option}]@dots{} [@var{file}]@dots{}
 3958: @end example
 3959: 
 3960: @c @command{cksum} prints the CRC checksum for each file along with the number
 3961: @c of bytes in the file, and the filename unless no arguments were given.
 3962: @c 
 3963: @command{cksum}は,ファイルのバイト数と一緒に,それぞれのファイルに対
 3964: し,CRCチェックサムと,引数が与えられていない場合以外はファイル名を出
 3965: 力します.
 3966: 
 3967: @c @command{cksum} is typically used to ensure that files
 3968: @c transferred by unreliable means (e.g., netnews) have not been corrupted,
 3969: @c by comparing the @command{cksum} output for the received files with the
 3970: @c @command{cksum} output for the original files (typically given in the
 3971: @c distribution).
 3972: @c 
 3973: @command{cksum}は,通常,信用できない手段(例えば,ネットニュース)で転
 3974: 送されたファイルが切り詰められていないか,受信したファイルの
 3975: @command{cksum}出力と元ファイルの@command{cksum}出力(通常は配布物で与
 3976: えられます)を比較することで確認するために使用します.
 3977: 
 3978: @c The CRC algorithm is specified by the @acronym{POSIX} standard.  It is not
 3979: @c compatible with the BSD or System V @command{sum} algorithms (see the
 3980: @c previous section); it is more robust.
 3981: @c 
 3982: CRCアルゴリズムは,@acronym{POSIX}標準で指定されました. BSDやSystem V
 3983: @command{sum}アルゴリズムとは互換性がありません(前のセクションを参照し
 3984: てください).それはより強固です.
 3985: 
 3986: @c The only options are @option{--help} and @option{--version}.  @xref{Common
 3987: @c options}.
 3988: @c 
 3989: オプションは@option{--help}と@option{--version}だけです.@xref{Common
 3990: options}.
 3991: 
 3992: 
 3993: @node md5sum invocation
 3994: @c @section @command{md5sum}: Print or check message-digests
 3995: @section @command{md5sum}: メッセージダイジェストの出力と調査
 3996: 
 3997: @pindex md5sum
 3998: @cindex 128-bit checksum
 3999: @cindex checksum, 128-bit
 4000: @cindex fingerprint, 128-bit
 4001: @cindex message-digest, 128-bit
 4002: 
 4003: @c @command{md5sum} computes a 128-bit checksum (or @dfn{fingerprint} or
 4004: @c @dfn{message-digest}) for each specified @var{file}.
 4005: @c If a @var{file} is specified as @samp{-} or if no files are given
 4006: @c @command{md5sum} computes the checksum for the standard input.
 4007: @c @command{md5sum} can also determine whether a file and checksum are
 4008: @c consistent. Synopses:
 4009: @c 
 4010: @command{md5sum}は,それぞれ指定された@var{file}に対し,128-bitチェッ
 4011: クサム(または@dfn{fingerprint},または@dfn{message-digest})を計算しま
 4012: す.@var{file}が@samp{-}で指定されたり,ファイルが与えられていない場合
 4013: は,@command{md5sum}は標準入力のチェックサムを計算します.
 4014: @command{md5sum}は,ファイルとチェックサムが一貫しているかどうか決定す
 4015: ることも可能です.概要です.
 4016: 
 4017: @example
 4018: md5sum [@var{option}]@dots{} [@var{file}]@dots{}
 4019: md5sum [@var{option}]@dots{} --check [@var{file}]
 4020: @end example
 4021: 
 4022: @c For each @var{file}, @samp{md5sum} outputs the MD5 checksum, a flag
 4023: @c indicating a binary or text input file, and the filename.
 4024: @c If @var{file} is omitted or specified as @samp{-}, standard input is read.
 4025: @c 
 4026: それぞれの@var{file}に対し,@samp{md5sum}は,MD5チェックサム,入力ファ
 4027: イルがバイナリかテキストかを示すフラグ,そしてファイル名を出力します.
 4028: @var{file}が無い,または@samp{-}として指定されている場合,標準入力を読
 4029: み込みます.
 4030: 
 4031: @c The program accepts the following options.  Also see @ref{Common options}.
 4032: @c 
 4033: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
 4034: してください.
 4035: 
 4036: @table @samp
 4037: 
 4038: @item -b
 4039: @itemx --binary
 4040: @opindex -b
 4041: @opindex --binary
 4042: @cindex binary input files
 4043: @c Treat all input files as binary.  This option has no effect on Unix
 4044: @c systems, since they don't distinguish between binary and text files.
 4045: @c This option is useful on systems that have different internal and
 4046: @c external character representations.  On MS-DOS and MS-Windows, this is
 4047: @c the default.
 4048: @c 
 4049: 全ての入力ファイルをバイナリとして扱います.このオプションは,Unixシス
 4050: テムではバイナリとテキストでファイルに差が無いので効果がありません.こ
 4051: のオプションは,内部と外部での文字表示が異なるシステムでは便利です.
 4052: MS-DOSとMS-Windowsでは,これはデフォルトです.
 4053: 
 4054: @item -c
 4055: @itemx --check
 4056: @c Read filenames and checksum information from the single @var{file}
 4057: @c (or from stdin if no @var{file} was specified) and report whether
 4058: @c each named file and the corresponding checksum data are consistent.
 4059: @c The input to this mode of @command{md5sum} is usually the output of
 4060: @c a prior, checksum-generating run of @samp{md5sum}.
 4061: @c Each valid line of input consists of an MD5 checksum, a binary/text
 4062: @c flag, and then a filename.
 4063: @c Binary files are marked with @samp{*}, text with @samp{ }.
 4064: @c For each such line, @command{md5sum} reads the named file and computes its
 4065: @c MD5 checksum.  Then, if the computed message digest does not match the
 4066: @c one on the line with the filename, the file is noted as having
 4067: @c failed the test.  Otherwise, the file passes the test.
 4068: @c By default, for each valid line, one line is written to standard
 4069: @c output indicating whether the named file passed the test.
 4070: @c After all checks have been performed, if there were any failures,
 4071: @c a warning is issued to standard error.
 4072: @c Use the @option{--status} option to inhibit that output.
 4073: @c If any listed file cannot be opened or read, if any valid line has
 4074: @c an MD5 checksum inconsistent with the associated file, or if no valid
 4075: @c line is found, @command{md5sum} exits with nonzero status.  Otherwise,
 4076: @c it exits successfully.
 4077: @c 
 4078: ファイル名とチェックサム情報を,単一の@var{file}(または,@var{file}が
 4079: 指定されない場合は標準入力)から読み込み,それぞれの指定された名前のファ
 4080: イルと対応するチェックサムデータが対応しているかどうか報告します.
 4081: @command{md5sum}のこのモードでの入力は,通常,@samp{md5sum}を実行して
 4082: 生成されたチェックサムで,それは以前の出力です.それぞれの入力の有効な
 4083: 行は,MD5チェックサムから成り立ち,バイナリ/テキストフラグと,ファイル
 4084: 名です.バイナリファイルは@samp{*}で,テキストは@samp{ }で印が付きます.
 4085: それぞれのそのような行に対し,@command{md5sum}は,指名されたファイルを
 4086: 読み込み,そのMD5チェックサムを計算します.そして,計算されたメッセー
 4087: ジダイジェストが,ファイル名を持つ行の一つとマッチしない場合,ファイル
 4088: にはテストに失敗したというメモが付きます.それ以外の場合,ファイルは調
 4089: 査をパスします.デフォルトで,それぞれの有効な行に対し,指名されたファ
 4090: イルが調査を通過したかどうかを示す一行を,標準出力に書き出します.全て
 4091: の調査の実行後,失敗があった場合,警告を標準エラーに出力します.出力を
 4092: 抑制するために,@option{--status}オプションを使用してください.リスト
 4093: アップされたファイルに,開いたり読み込んだりすることが不可能なものがあ
 4094: る場合,有効な行が関連するファイルとMD5チェックサムに対応しない場合,
 4095: または,有効な行が見つからない場合,@command{md5sum}はゼロ以外のステー
 4096: タスで終了します.それ以外の場合は,正しく終了します.
 4097: 
 4098: @itemx --status
 4099: @opindex --status
 4100: @cindex verifying MD5 checksums
 4101: @c This option is useful only when verifying checksums.
 4102: @c When verifying checksums, don't generate the default one-line-per-file
 4103: @c diagnostic and don't output the warning summarizing any failures.
 4104: @c Failures to open or read a file still evoke individual diagnostics to
 4105: @c standard error.
 4106: @c If all listed files are readable and are consistent with the associated
 4107: @c MD5 checksums, exit successfully.  Otherwise exit with a status code
 4108: @c indicating there was a failure.
 4109: @c 
 4110: このオプションは,チェックサムの照合時のみ便利です.チェックサムを照合
 4111: するとき,デフォルトのファイルに対し一行の診断を生成せず,あらゆる失敗
 4112: を要約する警告を出力しません.ファイルを開くあるいは読み込む際の失敗は,
 4113: 標準エラーに個別の診断結果を出力します.リストアップされたファイルがす
 4114: べて読み込み可能で,対応するMD5チェックサムと対応している場合,正しく
 4115: 終了します.それ以外の場合,失敗があることを示すステータスコードで終了
 4116: します.
 4117: 
 4118: @item -t
 4119: @itemx --text
 4120: @opindex -t
 4121: @opindex --text
 4122: @cindex text input files
 4123: @c Treat all input files as text files.  This is the reverse of
 4124: @c @option{--binary}.
 4125: @c 
 4126: 全ての入力ファイルを,テキストファイルとして扱います.このオプションは
 4127: @option{--binary}の反対です.
 4128: 
 4129: @item -w
 4130: @itemx --warn
 4131: @opindex -w
 4132: @opindex --warn
 4133: @cindex verifying MD5 checksums
 4134: @c When verifying checksums, warn about improperly formatted MD5 checksum lines.
 4135: @c This option is useful only if all but a few lines in the checked input
 4136: @c are valid.
 4137: @c 
 4138: チェックサムを照合するとき,不適切に書式化されたMD5チェックサム行につ
 4139: いて警告します.このオプションは,入力の調査で,全てではなくいくつかの
 4140: 行が有効な場合のみ便利です.
 4141: 
 4142: @end table
 4143: 
 4144: 
 4145: @node Operating on sorted files
 4146: @c @chapter Operating on sorted files
 4147: @chapter ソートされたファイルの処理
 4148: 
 4149: @cindex operating on sorted files
 4150: @cindex sorted files, operations on
 4151: 
 4152: @c These commands work with (or produce) sorted files.
 4153: @c 
 4154: 以下のコマンドは,ソートされたファイルで動作する(あるいはそれを生成す
 4155: る)コマンドです.
 4156: 
 4157: @menu
 4158: * sort invocation::             Sort text files.
 4159: * uniq invocation::             Uniquify files.
 4160: * comm invocation::             Compare two sorted files line by line.
 4161: * ptx invocation::              Produce a permuted index of file contents.
 4162: * tsort invocation::            Topological sort.
 4163: * tsort background::            Where tsort came from.
 4164: @end menu
 4165: 
 4166: 
 4167: @node sort invocation
 4168: @c @section @command{sort}: Sort text files
 4169: @section @command{sort}: テキストファイルをソート
 4170: 
 4171: @pindex sort
 4172: @cindex sorting files
 4173: 
 4174: @c @command{sort} sorts, merges, or compares all the lines from the given
 4175: @c files, or standard input if none are given or for a @var{file} of
 4176: @c @samp{-}.  By default, @command{sort} writes the results to standard
 4177: @c output.  Synopsis:
 4178: @c 
 4179: @command{sort}は,与えられたファイル,または与えられない場合や,
 4180: @samp{-}の@var{file}の場合は標準入力からの全ての行を,ソート,統合,ま
 4181: たは比較します.デフォルトで,@command{sort}は結果を標準出力に書き出し
 4182: ます.概要です.
 4183: 
 4184: @example
 4185: sort [@var{option}]@dots{} [@var{file}]@dots{}
 4186: @end example
 4187: 
 4188: @c @command{sort} has three modes of operation: sort (the default), merge,
 4189: @c and check for sortedness.  The following options change the operation
 4190: @c mode:
 4191: @c 
 4192: @command{sort}は,処理時に三つのモードがあります.ソート(デフォルト),
 4193: 統合,そしてソートされてることの調査です.以下のオプションで処理モード
 4194: を変更します.
 4195: 
 4196: @table @samp
 4197: 
 4198: @item -c
 4199: @itemx --check
 4200: @opindex -c
 4201: @opindex --check
 4202: @cindex checking for sortedness
 4203: @c Check whether the given files are already sorted: if they are not all
 4204: @c sorted, print an error message and exit with a status of 1.
 4205: @c Otherwise, exit successfully.
 4206: @c 
 4207: 与えられたファイルが,すでにソートされているかどうか調査します.全てが
 4208: ソートされていない場合,エラーメッセージを出力し,1のステータスで終了
 4209: します.それ以外の場合は正常に終了します.
 4210: 
 4211: @item -m
 4212: @itemx --merge
 4213: @opindex -m
 4214: @opindex --merge
 4215: @cindex merging sorted files
 4216: @c Merge the given files by sorting them as a group.  Each input file must
 4217: @c always be individually sorted.  It always works to sort instead of
 4218: @c merge; merging is provided because it is faster, in the case where it
 4219: @c works.
 4220: @c 
 4221: 与えられたファイルを,グループ化してソートすることで,統合します.それ
 4222: ぞれの入力ファイルは,個別にソートされている必要があります.それは常に,
 4223: 統合ではなくソートのために動作します.統合は,それが動作する状況ではよ
 4224: り高速なため提供されています.
 4225: 
 4226: @end table
 4227: 
 4228: @vindex LC_ALL
 4229: @vindex LC_COLLATE
 4230: @c A pair of lines is compared as follows: if any key fields have
 4231: @c been specified, @command{sort} compares each pair of fields, in the
 4232: @c order specified on the command line, according to the associated
 4233: @c ordering options, until a difference is found or no fields are left.
 4234: @c Unless otherwise specified, all comparisons use the character collating
 4235: @c sequence specified by the @env{LC_COLLATE} locale.  @footnote{If you
 4236: @c use a non-@acronym{POSIX} locale (e.g., by setting @env{LC_ALL}
 4237: @c to @samp{en_US}), then @command{sort} may produce output that is sorted
 4238: @c differently than you're accustomed to.  In that case, set the @env{LC_ALL}
 4239: @c environment variable to @samp{C}.  Note that setting only @env{LC_COLLATE}
 4240: @c has two problems.  First, it is ineffective if @env{LC_ALL} is also set.
 4241: @c Second, it has undefined behavior if @env{LC_CTYPE} (or @env{LANG}, if
 4242: @c @env{LC_CTYPE} is unset) is set to an incompatible value.  For example,
 4243: @c you get undefined behavior if @env{LC_CTYPE} is @code{ja_JP.PCK} but
 4244: @c @env{LC_COLLATE} is @code{en_US.UTF-8}. }
 4245: @c 
 4246: 行の組は,以下のように比較されます.キーフィールドが指定された場合,
 4247: @command{sort}は,それぞれのフィールドの組を,コマンドラインで指定され
 4248: た順番で,関連する順序オプションで,差が見つかるまで,またはフィールド
 4249: の残りが無くなるまで比較します.指定されない場合は,すべて比較する際,
 4250: @env{LC_COLLATE}ロケールで指定された,文字の順番を使用します.
 4251: @footnote{@acronym{POSIX}ではないロケール(例えば@env{LC_ALL}を
 4252: @samp{en_US}に設定している)場合,@command{sort}はいつもとは異なるソー
 4253: トされた出力を生成する可能性があります.その状況では,@env{LC_ALL}環境
 4254: 変数を@samp{C}に設定してください.@env{LC_COLLATE}だけを設定することに
 4255: は二つの問題があることに注意してください.最初は,@env{LC_ALL}が既に設
 4256: 定されている場合,無効になることです.二番目は,@env{LC_CTYPE}(または
 4257: @env{LC_CTYPE}が設定されていない場合は@env{LANG})が互換性の無い値に設
 4258: 定されている場合の動作が未定義であることです.例えば,@env{LC_CTYPE}が
 4259: @code{ja_JP.PCK}で,@env{LC_COLLATE}が@code{en_US.UTF-8}の場合,動作は
 4260: 未定義です.}
 4261: 
 4262: @c If any of the global options @samp{bdfgiMnr} are given but no key fields
 4263: @c are specified, @command{sort} compares the entire lines according to the
 4264: @c global options.
 4265: @c 
 4266: 大域的なオプション@samp{bdfgiMnr}が与えられて,キーフィールドが指定さ
 4267: れていない場合,@command{sort}は大域的なオプションに従い,行全体を比較
 4268: します.
 4269: 
 4270: @c Finally, as a last resort when all keys compare equal (or if no ordering
 4271: @c options were specified at all), @command{sort} compares the entire lines.
 4272: @c The last resort comparison honors the @option{--reverse} (@option{-r})
 4273: @c global option.  The @option{--stable} (@option{-s}) option disables this
 4274: @c last-resort comparison so that lines in which all fields compare equal
 4275: @c are left in their original relative order.  If no fields or global
 4276: @c options are specified, @option{--stable} (@option{-s}) has no effect.
 4277: @c 
 4278: 最終的に,全てのキーが同じとき(または,順序オプションが全く指定されて
 4279: いない場合),最後の手段として,@command{sort}は行全体を比較します.最
 4280: 後の手段は,@option{--reverse}(@option{-r})の大域的なオプションを尊重
 4281: して比較します.@option{--stable}(@option{-s})オプションは,この最後の
 4282: 手段では利用できず,それは,全てのフィールドの比較が同じになる行は,元
 4283: の相対的な順序のままにするためです.フィールドや大域的なオプションが指
 4284: 定されない場合,@option{--stable}(@option{-s})は効果がありません.
 4285: 
 4286: @c @sc{gnu} @command{sort} (as specified for all @sc{gnu} utilities) has no
 4287: @c limit on input line length or restrictions on bytes allowed within lines.
 4288: @c In addition, if the final byte of an input file is not a newline, @sc{gnu}
 4289: @c @command{sort} silently supplies one.  A line's trailing newline is not
 4290: @c part of the line for comparison purposes.
 4291: @c 
 4292: @sc{gnu} @command{sort}は,(全ての@sc{gnu}ユーティリティで指定されるよ
 4293: うに)入力行の長さの制限や,行で許可されるバイト数の限界がありません.
 4294: 更に,入力ファイルの最終バイトが改行でない場合,@sc{gnu}
 4295: @command{sort}は,黙ってそれを供給します.行の後ろの改行は,比較の目的
 4296: では行の一部です.
 4297: 
 4298: @c Upon any error, @command{sort} exits with a status of @samp{2}.
 4299: @c 
 4300: あらゆるエラーで,@command{sort}は@samp{2}のステータスで終了します.
 4301: 
 4302: @vindex TMPDIR
 4303: @c If the environment variable @env{TMPDIR} is set, @command{sort} uses its
 4304: @c value as the directory for temporary files instead of @file{/tmp}.  The
 4305: @c @option{--temporary-directory} (@option{-T}) option in turn overrides
 4306: @c the environment variable.
 4307: @c 
 4308: 環境変数@env{TMPDIR}が設定されている場合,@command{sort}は,一時ファイ
 4309: ルのディレクトリとして,@file{/tmp}の代わりにその変数をディレクトリと
 4310: して使用します.@option{--temporary-directory}(@option{-T})オプション
 4311: は,順序的に環境変数に優先します.
 4312: 
 4313: @c The following options affect the ordering of output lines.  They may be
 4314: @c specified globally or as part of a specific key field.  If no key
 4315: @c fields are specified, global options apply to comparison of entire
 4316: @c lines; otherwise the global options are inherited by key fields that do
 4317: @c not specify any special options of their own.  In pre-@acronym{POSIX}
 4318: @c versions of @command{sort}, global options affect only later key fields,
 4319: @c so portable shell scripts should specify global options first.
 4320: @c 
 4321: 以下のオプションは,出力行の順序に影響します.それらは,大域的,または
 4322: キーフィールドの一部として指定してもかまいません.キーフィールドが指定
 4323: されていない場合,大域的なオプションは行全体の比較に対して適用されます.
 4324: それ以外では,大域的なオプションは,それ自身オプションが指定されていな
 4325: いキーフィールドに継承されます.以前の@acronym{POSIX}のバージョンの
 4326: @command{sort}では,大域的なオプションはキーフィールドだけに影響するの
 4327: で,移植性の高いシェルスクリプトでは大域的なオプションを最初に指定すべ
 4328: きです.
 4329: 
 4330: @table @samp
 4331: 
 4332: @item -b
 4333: @itemx --ignore-leading-blanks
 4334: @opindex -b
 4335: @opindex --ignore-leading-blanks
 4336: @cindex blanks, ignoring leading
 4337: @vindex LC_CTYPE
 4338: @c Ignore leading blanks when finding sort keys in each line.
 4339: @c The @env{LC_CTYPE} locale determines character types.
 4340: @c 
 4341: それぞれの行でソートするキーを探すとき,前の空白を無視します.
 4342: @env{LC_CTYPE}ロケールで文字形式を決定します.
 4343: 
 4344: @item -d
 4345: @itemx --dictionary-order
 4346: @opindex -d
 4347: @opindex --dictionary-order
 4348: @cindex dictionary order
 4349: @cindex phone directory order
 4350: @cindex telephone directory order
 4351: @vindex LC_CTYPE
 4352: @c Sort in @dfn{phone directory} order: ignore all characters except
 4353: @c letters, digits and blanks when sorting.
 4354: @c The @env{LC_CTYPE} locale determines character types.
 4355: @c 
 4356: @dfn{phone directory}の順序でソートします.ソート時に,文字,数字,そ
 4357: して空白以外の全ての文字は無視されます.@env{LC_CTYPE}ロケールで文字形
 4358: 式を決定します.
 4359: 
 4360: @item -f
 4361: @itemx --ignore-case
 4362: @opindex -f
 4363: @opindex --ignore-case
 4364: @cindex ignoring case
 4365: @cindex case folding
 4366: @vindex LC_CTYPE
 4367: @c Fold lowercase characters into the equivalent uppercase characters when
 4368: @c comparing so that, for example, @samp{b} and @samp{B} sort as equal.
 4369: @c The @env{LC_CTYPE} locale determines character types.
 4370: @c 
 4371: 比較時に,小文字を大文字と同じに扱い,例えば,@samp{b}と@samp{B}は同等
 4372: にソートされます.@env{LC_CTYPE}ロケールで文字形式を決定します.
 4373: 
 4374: @item -g
 4375: @itemx --general-numeric-sort
 4376: @opindex -g
 4377: @opindex --general-numeric-sort
 4378: @cindex general numeric sort
 4379: @vindex LC_NUMERIC
 4380: @c Sort numerically, using the standard C function @code{strtod} to convert
 4381: @c a prefix of each line to a double-precision floating point number.
 4382: @c This allows floating point numbers to be specified in scientific notation,
 4383: @c like @code{1.0e-34} and @code{10e100}.
 4384: @c The @env{LC_NUMERIC} locale determines the decimal-point character.
 4385: @c Do not report overflow, underflow, or conversion errors.
 4386: @c Use the following collating sequence:
 4387: @c 
 4388: それぞれの行のプレフィクスを倍精度浮動小数点の数に変換するため,標準C 
 4389: 関数@code{strtod}を使用し,数値的なソートをします.これで,
 4390: @code{1.0e-34}と@code{10e100}のような浮動小数点の数を,科学的な表記方
 4391: で指定できます.@env{LC_NUMERIC}ロケールで小数点文字を決定します.オー
 4392: バーフローや,アンダーフロー,変換エラーは報告しません.以下の順番を使
 4393: 用します.
 4394: 
 4395: @itemize @bullet
 4396: @item
 4397: @c Lines that do not start with numbers (all considered to be equal).
 4398: @c 
 4399: 数字で始まらない行(全て同じと考えます).
 4400: @item
 4401: @c NaNs (``Not a Number'' values, in IEEE floating point arithmetic)
 4402: @c in a consistent but machine-dependent order.
 4403: @c 
 4404: NaN(``Not a Number''値で,IEEEでの算術的な浮動小数点です)一貫している
 4405: がマシンに依存した順番.
 4406: @item
 4407: @c Minus infinity.
 4408: @c 
 4409: 負の無限大.
 4410: @item
 4411: @c Finite numbers in ascending numeric order (with @math{-0} and @math{+0} equal).
 4412: @c 
 4413: 数字の順番に並んだ有限数(@math{-0}と@math{+0}は等しい).
 4414: @item
 4415: @c Plus infinity.
 4416: @c 
 4417: 正の無限大.
 4418: @end itemize
 4419: 
 4420: @c Use this option only if there is no alternative; it is much slower than
 4421: @c @option{--numeric-sort} (@option{-n}) and it can lose information when
 4422: @c converting to floating point.
 4423: @c 
 4424: 他に選択肢が無い場合のみ,このオプションを使用してください.
 4425: @option{--numeric-sort}(@option{-n})よりはるかに遅く,浮動小数点に変換
 4426: するとき,情報を失うはずです.
 4427: 
 4428: @item -i
 4429: @itemx --ignore-nonprinting
 4430: @opindex -i
 4431: @opindex --ignore-nonprinting
 4432: @cindex nonprinting characters, ignoring
 4433: @cindex unprintable characters, ignoring
 4434: @vindex LC_CTYPE
 4435: @c Ignore nonprinting characters.
 4436: @c The @env{LC_CTYPE} locale determines character types.
 4437: @c 
 4438: 印刷不可能な文字を無視します.@env{LC_CTYPE}ロケールで文字形式を決定し
 4439: ます.
 4440: 
 4441: @item -M
 4442: @itemx --month-sort
 4443: @opindex -M
 4444: @opindex --month-sort
 4445: @cindex months, sorting by
 4446: @vindex LC_TIME
 4447: @c An initial string, consisting of any amount of whitespace, followed
 4448: @c by a month name abbreviation, is folded to UPPER case and
 4449: @c compared in the order @samp{JAN} < @samp{FEB} < @dots{} < @samp{DEC}.
 4450: @c Invalid names compare low to valid names.  The @env{LC_TIME} locale
 4451: @c category determines the month spellings.
 4452: @c 
 4453: 任意の量の空白から成り立つ最初の文字列に月の名前の省略が続くものは,大
 4454: 文字のまま保持され,@samp{JAN} < @samp{FEB} < @dots{} < @samp{DEC}の順
 4455: に比較されます.無効な名前は,有効な名前の下になります.@env{LC_TIME} 
 4456: ロケールで,月のつづりを決定します.
 4457: 
 4458: @item -n
 4459: @itemx --numeric-sort
 4460: @opindex -n
 4461: @opindex --numeric-sort
 4462: @cindex numeric sort
 4463: @vindex LC_NUMERIC
 4464: @c Sort numerically: the number begins each line; specifically, it consists
 4465: @c of optional whitespace, an optional @samp{-} sign, and zero or more
 4466: @c digits possibly separated by thousands separators, optionally followed
 4467: @c by a decimal-point character and zero or more digits.  The @env{LC_NUMERIC}
 4468: @c locale specifies the decimal-point character and thousands separator.
 4469: @c 
 4470: 数値的なソートです.数字でそれぞれの行を開始します.特に,オプションの
 4471: 空白,オプションの@samp{-}記号,そして,1000で区切られたり,小数点文字
 4472: とゼロ以上の桁を続けることが可能な,ゼロ以上の桁から成り立ちます.
 4473: @env{LC_NUMERIC}ロケールで,小数点文字と1000の区切りを指定します.
 4474: 
 4475: @c Numeric sort uses what might be considered an unconventional method to
 4476: @c compare strings representing floating point numbers.  Rather than first
 4477: @c converting each string to the C @code{double} type and then comparing
 4478: @c those values, @command{sort} aligns the decimal-point characters in the
 4479: @c two strings and compares the strings a character at a time.  One benefit
 4480: @c of using this approach is its speed.  In practice this is much more
 4481: @c efficient than performing the two corresponding string-to-double (or
 4482: @c even string-to-integer) conversions and then comparing doubles.  In
 4483: @c addition, there is no corresponding loss of precision.  Converting each
 4484: @c string to @code{double} before comparison would limit precision to about
 4485: @c 16 digits on most systems.
 4486: @c 
 4487: 数値的なソートは,浮動小数点の数値を表現する文字列を比較するため,慣習
 4488: 的とは思われない手法を使用します.最初にそれぞれの文字列をCの
 4489: @code{double}形式に変換してそれらの値を比較するのではなく,
 4490: @command{sort}は,二つの文字列の小数点文字を一列に並べて,一度に文字の
 4491: 列を比較します.このアプローチを使う一つの利益は速度です.実際には,二
 4492: つの対応する文字列を倍精度浮動小数点に(または,文字列を整数に)変換し,
 4493: 倍精度浮動小数点を比較するより効率的です.更に,精度による損失はありま
 4494: せん.それぞれの文字列を比較前に@code{double}に変換すると,ほとんどの
 4495: システムで16桁程度に精度が制限されるでしょう.
 4496: 
 4497: @c Neither a leading @samp{+} nor exponential notation is recognized.
 4498: @c To compare such strings numerically, use the
 4499: @c @option{--general-numeric-sort} (@option{-g}) option.
 4500: @c 
 4501: 前置される@samp{+}も,指数表記も認識されません.そのような文字列を数値
 4502: 的に比較するために,@option{-g}オプションを使用してください.
 4503: 
 4504: @item -r
 4505: @itemx --reverse
 4506: @opindex -r
 4507: @opindex --reverse
 4508: @cindex reverse sorting
 4509: @c Reverse the result of comparison, so that lines with greater key values
 4510: @c appear earlier in the output instead of later.
 4511: @c 
 4512: 比較の結果を逆順にし,より大きなキー値を持つ行が,出力では後方なるので
 4513: はなく,前方に現われるようになります.
 4514: 
 4515: @end table
 4516: 
 4517: @c Other options are:
 4518: @c 
 4519: その他のオプションは以下の通りです.
 4520: 
 4521: @table @samp
 4522: 
 4523: @item -o @var{output-file}
 4524: @itemx --output=@var{output-file}
 4525: @opindex -o
 4526: @opindex --output
 4527: @cindex overwriting of input, allowed
 4528: @c Write output to @var{output-file} instead of standard output.
 4529: @c If necessary, @command{sort} reads input before opening
 4530: @c @var{output-file}, so you can safely sort a file in place by using
 4531: @c commands like @code{sort -o F F} and @code{cat F | sort -o F}.
 4532: @c 
 4533: 標準出力の代わりに,@var{output-file}に出力を書き出します.必要があれ
 4534: ば,@command{sort}は@var{output-file}を開く前に入力を読み込むので,
 4535: @code{sort -o F F}と@code{cat F | sort -o F}のようなコマンドを使用する
 4536: ことで,同じファイルを安全にソートすることが可能です.
 4537: 
 4538: @vindex POSIXLY_CORRECT
 4539: @c On newer systems, @option{-o} cannot appear after an input file if
 4540: @c @env{POSIXLY_CORRECT} is set, e.g., @samp{sort F -o F}.  Portable
 4541: @c scripts should specify @option{-o @var{output-file}} before any input
 4542: @c files.
 4543: @c 
 4544: より新しいシステムでは,@env{POSIXLY_CORRECT}が設定されている場合,
 4545: @option{-o}を入力ファイルの後に書くことができません.例えば,
 4546: @samp{sort F -o F}です.移植性の高いスクリプトでは,すべての入力ファイ
 4547: ルの前に@option{-o @var{output-file}}を指定すべきです.
 4548: 
 4549: @item -s
 4550: @itemx --stable
 4551: @opindex -s
 4552: @opindex --stable
 4553: @cindex sort stability
 4554: @cindex disabling sort's last-resort comparison
 4555: 
 4556: @c Make @command{sort} stable by disabling the last-resort
 4557: @c comparison that is performed in some cases.
 4558: @c By default, when lines compare equal based on command line options
 4559: @c that affect ordering, those lines are ordered using
 4560: @c a @dfn{last-resort comparison} that takes the entire
 4561: @c line as the key and acts as if no ordering options were specified.
 4562: @c But if @option{--reverse} (@option{-r}) was specified along with other
 4563: @c ordering options, then the last-resort comparison does use @option{--reverse}.
 4564: @c In any case, when no ordering option is specified or when only
 4565: @c @option{--reverse} is specified, the last-resort comparison is not performed
 4566: @c 
 4567: 条件によっては実行される最後の手段の比較を利用不可能にし,
 4568: @command{sort}を安定させます.デフォルトで,コマンドラインオプションに
 4569: よって影響する順番として行の比較が同じになるとき,行全体をキーとして,
 4570: 順序付けオプションが指定されていない状態で,@dfn{最後の手段の比較
 4571: (last-resort comparison)}を使用して,これらの行に順番を付けます.しか
 4572: し,順序指定として@option{--reverse} (@option{-r})が指定されている場合,
 4573: 最後の手段の比較は@option{--reverse}を使用します.あらゆる状況で,順序
 4574: 付けオプションが指定されていないときや,@option{--reverse}だけが指定さ
 4575: れているとき,最後の手段の比較は実行されません.
 4576: 
 4577: @item -S @var{size}
 4578: @itemx --buffer-size=@var{size}
 4579: @opindex -S
 4580: @opindex --buffer-size
 4581: @cindex size for main memory sorting
 4582: @c Use a main-memory sort buffer of the given @var{size}.  By default,
 4583: @c @var{size} is in units of 1024 bytes.  Appending @samp{%} causes
 4584: @c @var{size} to be interpreted as a percentage of physical memory.
 4585: @c Appending @samp{K} multiplies @var{size} by 1024 (the default),
 4586: @c @samp{M} by 1,048,576, @samp{G} by 1,073,741,824, and so on for
 4587: @c @samp{T}, @samp{P}, @samp{E}, @samp{Z}, and @samp{Y}.  Appending
 4588: @c @samp{b} causes @var{size} to be interpreted as a byte count, with no
 4589: @c multiplication.
 4590: @c 
 4591: 与えられた@var{size}のメインメモリのソートバッファを使用します.デフォ
 4592: ルトで,@var{size}は1024バイト単位です.@samp{%}を追加すると,
 4593: @var{size}を物理メモリのパーセントとして解釈します.@samp{K}を追加する
 4594: と,@var{size}を1024倍(デフォルト)にし,@samp{M}は1,048,576倍,
 4595: @samp{G}は1,073,741,824倍などのようになり,以下@samp{T},@samp{P},
 4596: @samp{E},@samp{Z},そして@samp{Y}も同様です.@samp{b}を追加すると,
 4597: @var{size}は倍数表現ではなくバイト数として解釈されます.
 4598: 
 4599: @c This option can improve the performance of @command{sort} by causing it
 4600: @c to start with a larger or smaller sort buffer than the default.
 4601: @c However, this option affects only the initial buffer size.  The buffer
 4602: @c grows beyond @var{size} if @command{sort} encounters input lines larger
 4603: @c than @var{size}.
 4604: @c 
 4605: このオプションで,デフォルトより大きいまたは小さいソートバッファを用い
 4606: て開始させることで,@command{sort}のパフォーマンスの改善することが可能
 4607: です.しかし,このオプションは初期のバッファサイズだけに影響します.
 4608: @var{size}より大きな入力行を@command{sort}が見つけた場合,バッファは
 4609: @var{size}以上に大きくなります.
 4610: 
 4611: @item -t @var{separator}
 4612: @itemx --field-separator=@var{separator}
 4613: @opindex -t
 4614: @opindex --field-separator
 4615: @cindex field separator character
 4616: @c Use character @var{separator} as the field separator when finding the
 4617: @c sort keys in each line.  By default, fields are separated by the empty
 4618: @c string between a non-whitespace character and a whitespace character.
 4619: @c That is, given the input line @w{@samp{ foo bar}}, @command{sort} breaks it
 4620: @c into fields @w{@samp{ foo}} and @w{@samp{ bar}}.  The field separator is
 4621: @c not considered to be part of either the field preceding or the field
 4622: @c following.  But note that sort fields that extend to the end of the line,
 4623: @c as @option{-k 2}, or sort fields consisting of a range, as @option{-k 2,3},
 4624: @c retain the field separators present between the endpoints of the range.
 4625: @c 
 4626: それぞれの行からソートキーを検索するとき,フィールドセパレータとして,
 4627: 文字@var{separator}を使用します.デフォルトで,フィールドは,空白でな
 4628: い文字と空白文字の間の空の文字列で分離されます.すなわち,入力行
 4629: @w{@samp{ foo bar}}が与えられた場合,@command{sort}はそれを,フィール
 4630: ド@w{@samp{ foo}}と@w{@samp{ bar}}に分離します.フィールドセパレータは,
 4631: フィールドの前やフィールドの後の部分とは考えられません.しかし,
 4632: @option{-k 2}のように行末まで展開されるソートフィールドや,@option{-k
 4633: 2,3}のように範囲があるソートフィールドは,範囲の終点に存在するフィール
 4634: ドセパレータを保持します.
 4635: 
 4636: @item -T @var{tempdir}
 4637: @itemx --temporary-directory=@var{tempdir}
 4638: @opindex -T
 4639: @opindex --temporary-directory
 4640: @cindex temporary directory
 4641: @vindex TMPDIR
 4642: @c Use directory @var{tempdir} to store temporary files, overriding the
 4643: @c @env{TMPDIR} environment variable.  If this option is given more than
 4644: @c once, temporary files are stored in all the directories given.  If you
 4645: @c have a large sort or merge that is I/O-bound, you can often improve
 4646: @c performance by using this option to specify directories on different
 4647: @c disks and controllers.
 4648: @c 
 4649: 一時ファイルを保存するためディレクトリ@var{tempdir}を使用し,それは
 4650: @env{TMPDIR}環境変数に優先します.このオプションが一回以上与えられた場
 4651: 合,一時ファイルはすべて与えられたディレクトリに保存されます.入出力が
 4652: 拘束されるほどの大量のソートやマージを行なう場合,異なるディスクやコン
 4653: トローラにあるディレクトリを指定するためにこのオプションを使用すること
 4654: で,パフォーマンスが改善するはずです.
 4655: 
 4656: @item -u
 4657: @itemx --unique
 4658: @opindex -u
 4659: @opindex --unique
 4660: @cindex uniquifying output
 4661: 
 4662: @c Normally, output only the first of a sequence of lines that compare
 4663: @c equal.  For the @option{--check} (@option{-c}) option,
 4664: @c check that no pair of consecutive lines compares equal.
 4665: @c 
 4666: 通常,比較結果が等しい行の最初の行のみを出力します.
 4667: @option{--check}(@option{-c})オプションに対し,比較結果が等しい連続し
 4668: た行の対が無いことを調査します.
 4669: 
 4670: @item -k @var{pos1}[,@var{pos2}]
 4671: @itemx --key=@var{pos1}[,@var{pos2}]
 4672: @opindex -k
 4673: @opindex --key
 4674: @cindex sort field
 4675: @c Specify a sort field that consists of the part of the line between
 4676: @c @var{pos1} and @var{pos2} (or the end of the line, if @var{pos2} is
 4677: @c omitted), @emph{inclusive}.  Fields and character positions are numbered
 4678: @c starting with 1.  So to sort on the second field, you'd use
 4679: @c @option{--key=2,2} (@option{-k 2,2}).  See below for more examples.
 4680: @c 
 4681: @var{pos1}と@var{pos2}(または,@var{pos2}が省略された場合は行末)の間か
 4682: ら成り立つ,@var{pos2}は@emph{含まれます},行の一部をソート時のフィー
 4683: ルドに指定します.フィールドと文字の位置は,1から番号付けされます.そ
 4684: のため,二番目のフィールドをソートするため,@option{--key=2,2}
 4685: (@samp{-k 2,2})を使用してください.以下により多くの例があります.
 4686: 
 4687: @item -z
 4688: @itemx --zero-terminated
 4689: @opindex -z
 4690: @opindex --zero-terminated
 4691: @cindex sort zero-terminated lines
 4692: @c Treat the input as a set of lines, each terminated by a zero byte
 4693: @c (@acronym{ASCII} @sc{nul} (Null) character) instead of an
 4694: @c @acronym{ASCII} @sc{lf} (Line Feed).
 4695: @c This option can be useful in conjunction with @samp{perl -0} or
 4696: @c @samp{find -print0} and @samp{xargs -0} which do the same in order to
 4697: @c reliably handle arbitrary pathnames (even those which contain Line Feed
 4698: @c characters.)
 4699: @c 
 4700: 入力を行の集合として扱い,@acronym{ASCII} @sc{lf} (Line Feed)の代わり
 4701: にゼロバイト(@acronym{ASCII} @sc{nul} (Null)文字)で終端します.このオ
 4702: プションは,任意のパス名を(ラインフィード文字を含んでいても)確実に処理
 4703: するため,@samp{perl -0}や,@samp{find -print0}と@samp{xargs -0}と組み
 4704: 合わせると便利です.
 4705: 
 4706: @end table
 4707: 
 4708: @c Historical (BSD and System V) implementations of @command{sort} have
 4709: @c differed in their interpretation of some options, particularly
 4710: @c @option{-b}, @option{-f}, and @option{-n}.  @sc{gnu} sort follows the @acronym{POSIX}
 4711: @c behavior, which is usually (but not always!) like the System V behavior.
 4712: @c According to @acronym{POSIX}, @option{-n} no longer implies @option{-b}.  For
 4713: @c consistency, @option{-M} has been changed in the same way.  This may
 4714: @c affect the meaning of character positions in field specifications in
 4715: @c obscure cases.  The only fix is to add an explicit @option{-b}.
 4716: @c 
 4717: 歴史的な(BSDとSystem Vの)@command{sort}の実装は,解釈が異なるオプショ
 4718: ンがあり,特に,@option{-b},@option{-f}と@option{-n}があげられます.
 4719: @sc{gnu} @command{sort}は,@acronym{POSIX}の動作に従い,それは通常(常
 4720: にではない!)System Vの動作に似ています.@acronym{POSIX}によると,
 4721: @option{-n}は,もはや@option{-b}を暗黙に指定しません.一貫性のため,
 4722: @option{-M}も同様に変更されました.これは,フィールドの指定が明確でな
 4723: い状況で,文字の位置の意味に影響するかもしれません.唯一の訂正方法は,
 4724: 明示的に@option{-b}を加えることです.
 4725: 
 4726: @c A position in a sort field specified with the @option{-k}
 4727: @c option has the form @samp{@var{f}.@var{c}}, where @var{f} is the number
 4728: @c of the field to use and @var{c} is the number of the first character
 4729: @c from the beginning of the field.  In a start position, an omitted
 4730: @c @samp{.@var{c}} stands for the field's first character.  In an end
 4731: @c position, an omitted or zero @samp{.@var{c}} stands for the field's
 4732: @c last character.  If the
 4733: @c @option{-b} option was specified, the @samp{.@var{c}} part of a field
 4734: @c specification is counted from the first nonblank character of the field.
 4735: @c 
 4736: @option{-k}オプションを用いたソート時のフィールド指定の位置は,
 4737: @samp{@var{f}.@var{c}}形式となり,@var{f}は使用するフィールド数で,
 4738: @var{c}はフィールドのはじまりから数えた最初の文字までの数です.最初の
 4739: 位置として,@samp{.@var{c}}が省略されているとフィールドの最初の文字を
 4740: 用います.@option{-b}オプションが指定されている場合,指定したフィール
 4741: ドの@samp{.@var{c}} の部分は,フィールドの最初の空白ではない文字から数
 4742: えます.
 4743: 
 4744: @c A sort key position may also have any of the option letters @samp{Mbdfinr}
 4745: @c appended to it, in which case the global ordering options are not used
 4746: @c for that particular field.  The @option{-b} option may be independently
 4747: @c attached to either or both of the start and
 4748: @c end positions of a field specification, and if it is inherited
 4749: @c from the global options it will be attached to both.
 4750: @c Keys may span multiple fields.
 4751: @c 
 4752: ソートキーの位置は,オプション文字@samp{Mbdfinr}を加えてもかまわず,そ
 4753: の場合,大域的な順序オプションは,特定のフィールドに使用されません.
 4754: @option{-b}オプションは,指定した最初と最後のフィールドの一方または両
 4755: 方に独立に適用され,大域的なオプションを継承する場合,両方に適用されま
 4756: す.キーは複数のフィールドに跨ってもかまいません.
 4757: 
 4758: @c On older systems, @command{sort} supports an obsolete origin-zero
 4759: @c syntax @samp{+@var{pos1} [-@var{pos2}]} for specifying sort keys.
 4760: @c @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance}) does not allow
 4761: @c this; use @option{-k} instead.
 4762: @c 
 4763: 古いシステムでは,@command{sort}は時代遅れのソートキーを指定するゼロを
 4764: 起点とした構文の@samp{+@var{pos1} [-@var{pos2}]}をサポートしています.
 4765: @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance})ではこれを
 4766: 許可していません.代わりに@option{-k}を使用してください.
 4767: 
 4768: @c Here are some examples to illustrate various combinations of options.
 4769: @c 
 4770: 様々なオプションの組合せを紹介する例は以下のようになります.
 4771: 
 4772: @itemize @bullet
 4773: 
 4774: @item
 4775: @c Sort in descending (reverse) numeric order.
 4776: @c 
 4777: 下降的な(逆順の)数の順序でソートします.
 4778: 
 4779: @example
 4780: sort -nr
 4781: @end example
 4782: 
 4783: @item
 4784: @c Sort alphabetically, omitting the first and second fields.
 4785: @c This uses a single key composed of the characters beginning
 4786: @c at the start of field three and extending to the end of each line.
 4787: @c 
 4788: アルファベット順に,最初と二番目のフィールドを除いてソートします.これ
 4789: は,三つ目のフィールドから始まり,それぞれの行の終りまで続く文字で構成
 4790: された,単一のキーを使用します.
 4791: 
 4792: @example
 4793: sort -k 3
 4794: @end example
 4795: 
 4796: @item
 4797: @c Sort numerically on the second field and resolve ties by sorting
 4798: @c alphabetically on the third and fourth characters of field five.
 4799: @c Use @samp{:} as the field delimiter.
 4800: @c 
 4801: 二番目のフィールドを数値的にソートし,五つ目のフィールドの三番目と四番
 4802: 目の文字のアルファベットでソートすることで,その値が同じものを並べます.
 4803: フィールドの分離に@samp{:}を使用します.
 4804: 
 4805: @example
 4806: sort -t : -k 2,2n -k 5.3,5.4
 4807: @end example
 4808: 
 4809: @c Note that if you had written @option{-k 2} instead of @option{-k 2,2}
 4810: @c @command{sort} would have used all characters beginning in the second field
 4811: @c and extending to the end of the line as the primary @emph{numeric}
 4812: @c key.  For the large majority of applications, treating keys spanning
 4813: @c more than one field as numeric will not do what you expect.
 4814: @c 
 4815: @samp{-k 2,2}の代わりに@samp{-k 2}と書いた場合,@samp{sort}は二番目の
 4816: フィールドで始まり,行の終りまで続く全ての文字を,主要な@emph{数値}キー
 4817: として使用することに注意してください.アプリケーションのほとんど大多数
 4818: に対しては,数値として一つフィールド以上に跨って扱うキーは,期待したも
 4819: のではないでしょう.
 4820: 
 4821: @c Also note that the @samp{n} modifier was applied to the field-end
 4822: @c specifier for the first key.  It would have been equivalent to
 4823: @c specify @option{-k 2n,2} or @option{-k 2n,2n}.  All modifiers except
 4824: @c @samp{b} apply to the associated @emph{field}, regardless of whether
 4825: @c the modifier character is attached to the field-start and/or the
 4826: @c field-end part of the key specifier.
 4827: @c 
 4828: また,@samp{n}の修飾は,最初のキーに対し,フィールドの終りを指定するも
 4829: のに適用されることに注意してください.それは,@samp{-k 2n,2}や@samp{-k
 4830: 2n,2n}を指定することと同じです.全ての修飾は,@samp{b}が関連する
 4831: @emph{フィールド}に適用されることを期待し,修飾文字がフィールドの最初
 4832: そして/または,キー指定のフィールドの終りに適用されるかどうかに依存し
 4833: ません.
 4834: 
 4835: @item
 4836: @c Sort the password file on the fifth field and ignore any
 4837: @c leading white space.  Sort lines with equal values in field five
 4838: @c on the numeric user ID in field three.
 4839: @c 
 4840: 五番目のフィールドでパスワードファイルをソートし,前置されるすべての空
 4841: 白を無視します.五番目のフィールドが等しい値の行を,三番目のフィールド
 4842: のユーザIDでソートします.
 4843: 
 4844: @example
 4845: sort -t : -k 5b,5 -k 3,3n /etc/passwd
 4846: @end example
 4847: 
 4848: @c An alternative is to use the global numeric modifier @option{-n}.
 4849: @c 
 4850: 代わりに,大域的な数値の修飾@option{-n}を使用します.
 4851: 
 4852: @example
 4853: sort -t : -n -k 5b,5 -k 3,3 /etc/passwd
 4854: @end example
 4855: 
 4856: @item
 4857: @c Generate a tags file in case-insensitive sorted order.
 4858: @c 
 4859: 大文字小文字を識別するタグファイルを生成します.
 4860: 
 4861: @smallexample
 4862: find src -type f -print0 | sort -t / -z -f | xargs -0 etags --append
 4863: @end smallexample
 4864: 
 4865: @c The use of @option{-print0}, @option{-z}, and @option{-0} in this case means
 4866: @c that pathnames that contain Line Feed characters will not get broken up
 4867: @c by the sort operation.
 4868: @c 
 4869: この状況では,@option{-print0},@option{-z},そして@option{-0}の使用は,
 4870: Line Feed文字を含むパス名がソート処理で分割されないようにします.
 4871: 
 4872: @c Finally, to ignore both leading and trailing white space, you
 4873: @c could have applied the @samp{b} modifier to the field-end specifier
 4874: @c for the first key,
 4875: @c 
 4876: 最後に,前後の空白を無視するため,@samp{b}修飾を最初のキーに対しフィー
 4877: ルドの終りの指定に適用できます.
 4878: 
 4879: @example
 4880: sort -t : -n -k 5b,5b -k 3,3 /etc/passwd
 4881: @end example
 4882: 
 4883: @c or by using the global @option{-b} modifier instead of @option{-n}
 4884: @c and an explicit @samp{n} with the second key specifier.
 4885: @c 
 4886: または,大域的な@option{-b}修飾を@option{-n}の代わりに使用し,二番目の
 4887: キー指定に@samp{n}を明示します.
 4888: 
 4889: @example
 4890: sort -t : -b -k 5,5 -k 3,3n /etc/passwd
 4891: @end example
 4892: 
 4893: @c This example is a bit contrived and needs more explanation.
 4894: @c @item
 4895: @c Sort records separated by an arbitrary string by using a pipe to convert
 4896: @c each record delimiter string to @samp{\0}, then using sort's -z option,
 4897: @c and converting each @samp{\0} back to the original record delimiter.
 4898: @c
 4899: @c @example
 4900: @c printf 'c\n\nb\n\na\n'|perl -0pe 's/\n\n/\n\0/g'|sort -z|perl -0pe 's/\0/\n/g'
 4901: @c @end example
 4902: 
 4903: @end itemize
 4904: 
 4905: 
 4906: @node uniq invocation
 4907: @c @section @command{uniq}: Uniquify files
 4908: @section @command{uniq}: ファイルのユニーク化
 4909: 
 4910: @pindex uniq
 4911: @cindex uniquify files
 4912: 
 4913: @c @command{uniq} writes the unique lines in the given @file{input}, or
 4914: @c standard input if nothing is given or for an @var{input} name of
 4915: @c @samp{-}.  Synopsis:
 4916: @c 
 4917: @command{uniq}は与えられたファイル,または与えられない場合や@samp{-}の
 4918: @var{input}名に対し,ユニークな行を書き出します.概要です.
 4919: 
 4920: @example
 4921: uniq [@var{option}]@dots{} [@var{input} [@var{output}]]
 4922: @end example
 4923: 
 4924: @c By default, @command{uniq} prints the unique lines in a sorted file, i.e.,
 4925: @c discards all but one of identical successive lines.  Optionally, it can
 4926: @c instead show only lines that appear exactly once, or lines that appear
 4927: @c more than once.
 4928: @c 
 4929: デフォルトで,@command{uniq}はソートされたファイルのユニークな行を出力
 4930: し,すなわち,一意に識別可能な行以外を全て削除します.オプションで,そ
 4931: うする代わりに,一度しか現われない行を表示したり,一度以上現われる行を
 4932: 表示したりできます.
 4933: 
 4934: @c The input need not be sorted, but duplicate input lines are detected
 4935: @c only if they are adjacent.  If you want to discard non-adjacent
 4936: @c duplicate lines, perhaps you want to use @code{sort -u}.
 4937: @c 
 4938: 入力ファイルはソートされている必要はありませんが,同じ行は隣接している
 4939: 場合のみ検出されます.隣接していないものを除去したい場合,おそらく
 4940: @code{sort -u}を使用したいと思うでしょう.
 4941: 
 4942: @vindex LC_COLLATE
 4943: @c Comparisons use the character collating sequence specified by the
 4944: @c @env{LC_COLLATE} locale category.
 4945: @c 
 4946: 比較には,@env{LC_COLLATE}ロケールカテゴリで指定された文字の順番を使用
 4947: します.
 4948: 
 4949: @c If no @var{output} file is specified, @command{uniq} writes to standard
 4950: @c output.
 4951: @c 
 4952: @var{output}ファイルが無い場合,@command{uniq}は標準出力に書き出します.
 4953: 
 4954: @c The program accepts the following options.  Also see @ref{Common options}.
 4955: @c 
 4956: このプログラムは,以下のオプションも受け入れます.@ref{Common options} 
 4957: も参照してください.
 4958: 
 4959: @table @samp
 4960: 
 4961: @item -f @var{n}
 4962: @itemx --skip-fields=@var{n}
 4963: @opindex -f
 4964: @opindex --skip-fields
 4965: @c Skip @var{n} fields on each line before checking for uniqueness.  Fields
 4966: @c are sequences of non-space non-tab characters that are separated from
 4967: @c each other by at least one space or tab.
 4968: @c 
 4969: ユニークさを調査する前に,それぞれの行の@var{n}フィールドスキップしま
 4970: す.フィールドは,少なくとも一つ以上のスペースやタブで区切られた,非ス
 4971: ペース,非タブ文字の並びです.
 4972: 
 4973: @c On older systems, @command{uniq} supports an obsolete option
 4974: @c @option{-@var{n}}.  @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance})
 4975: @c does not allow this; use @option{-f @var{n}} instead.
 4976: @c 
 4977: 古いシステムでは,@command{uniq}は時代遅れのオプション
 4978: @option{-@var{n}}をサポートしています.@acronym{POSIX} 1003.1-2001
 4979: (@pxref{Standards conformance})ではこれを許可していません.代わりに
 4980: @option{-f @var{n}}を使用してください.
 4981: 
 4982: @item -s @var{n}
 4983: @itemx --skip-chars=@var{n}
 4984: @opindex -s
 4985: @opindex --skip-chars
 4986: @c Skip @var{n} characters before checking for uniqueness.  If you use both
 4987: @c the field and character skipping options, fields are skipped over first.
 4988: @c 
 4989: ユニークさの調査の前に,@var{n}文字スキップします.フィールドと文字の
 4990: スキップオプションを両方とも使用した場合,フィールドが最初にスキップさ
 4991: れます.
 4992: 
 4993: @c On older systems, @command{uniq} supports an obsolete option
 4994: @c @option{+@var{n}}.  @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance})
 4995: @c does not allow this; use @option{-s @var{n}} instead.
 4996: @c 
 4997: 古いシステムでは,@command{uniq}は時代遅れのオプション
 4998: @option{+@var{n}}をサポートしています.@acronym{POSIX} 1003.1-2001
 4999: (@pxref{Standards conformance})ではこれを許可していません.代わりに
 5000: @option{-s @var{n}}を使用してください.
 5001: 
 5002: @item -c
 5003: @itemx --count
 5004: @opindex -c
 5005: @opindex --count
 5006: @c Print the number of times each line occurred along with the line.
 5007: @c 
 5008: それぞれの行で同じものが発生した回数を出力します.
 5009: 
 5010: @item -i
 5011: @itemx --ignore-case
 5012: @opindex -i
 5013: @opindex --ignore-case
 5014: @c Ignore differences in case when comparing lines.
 5015: @c 
 5016: 行の比較時に大文字小文字の違いを無視します.
 5017: 
 5018: @item -d
 5019: @itemx --repeated
 5020: @opindex -d
 5021: @opindex --repeated
 5022: @cindex duplicate lines, outputting
 5023: @c Print one copy of each duplicate line.
 5024: @c 
 5025: 重複する行のみを出力します.
 5026: 
 5027: @item -D
 5028: @itemx --all-repeated[=@var{delimit-method}]
 5029: @opindex -D
 5030: @opindex --all-repeated
 5031: @cindex all duplicate lines, outputting
 5032: @c Print all copies of each duplicate line.
 5033: @c This option is useful mainly in conjunction with other options e.g.,
 5034: @c to ignore case or to compare only selected fields.
 5035: @c The optional @var{delimit-method} tells how to delimit
 5036: @c groups of duplicate lines, and must be one of the following:
 5037: @c 
 5038: それぞれの重複する行をすべて出力します.このオプションは,主に他のオプ
 5039: ションと組み合わせると便利で,例えば,大文字小文字を無視したり,選択し
 5040: たフィールドのみを比較する場合です.追加の@var{delimit-method}で重複す
 5041: る行の組を分ける方法を伝え、それは以下の一つにする必要があります.
 5042: 
 5043: @table @samp
 5044: 
 5045: @item none
 5046: @c Do not delimit groups of duplicate lines.
 5047: @c This is equivalent to @option{--all-repeated} (@option{-D}).
 5048: @c 
 5049: 重複する行の組を分離しません.これは@option{--all-repeated}
 5050: (@option{-D})と同じです.
 5051: 
 5052: @item prepend
 5053: @c Output a newline before each group of duplicate lines.
 5054: @c 
 5055: それぞれの重複する行の組の前に改行を出力します.
 5056: 
 5057: @item separate
 5058: @c Separate groups of duplicate lines with a single newline.
 5059: @c This is the same as using @samp{prepend}, except that
 5060: @c there is no newline before the first group, and hence
 5061: @c may be better suited for output direct to users.
 5062: @c 
 5063: 重複する行の組を単一の改行で分離します.これは,最初の組の前に改行が無
 5064: いこと以外@samp{prepend}を使用することと同じで,ユーザに直接出力するた
 5065: めにはより適しているでしょう.
 5066: @end table
 5067: 
 5068: @c Note that when groups are delimited and the input stream contains
 5069: @c two or more consecutive blank lines, then the output is ambiguous.
 5070: @c To avoid that, filter the input through @samp{tr -s '\n'} to replace
 5071: @c each sequence of consecutive newlines with a single newline.
 5072: @c 
 5073: 組が分離されていて,入力に二つ以上の空白行があるとき,出力が不明瞭にな
 5074: ることに注意してください.それを避けるため,連続した改行を単一の改行に
 5075: 置換するように,入力を@samp{tr -s '\n'}でフィルタリングしてください.
 5076: 
 5077: @c This is a @sc{gnu} extension.
 5078: @c 
 5079: これは,@sc{gnu}の拡張です.
 5080: @c FIXME: give an example showing *how* it's useful
 5081: 
 5082: @item -u
 5083: @itemx --unique
 5084: @opindex -u
 5085: @opindex --unique
 5086: @cindex unique lines, outputting
 5087: @c Print non-duplicate lines.
 5088: @c 
 5089: 重複していない行のみ出力します.
 5090: 
 5091: @item -w @var{n}
 5092: @itemx --check-chars=@var{n}
 5093: @opindex -w
 5094: @opindex --check-chars
 5095: @c Compare @var{n} characters on each line (after skipping any specified
 5096: @c fields and characters).  By default the entire rest of the lines are
 5097: @c compared.
 5098: @c 
 5099: (指定されたすべてのフィールドと文字をスキップした後)それぞれの行の
 5100: @var{n}文字を比較します.デフォルトで,行の残り全体が比較されます.
 5101: 
 5102: @end table
 5103: 
 5104: 
 5105: @node comm invocation
 5106: @c @section @command{comm}: Compare two sorted files line by line
 5107: @section @command{comm}: 二つのソートされた行と行の比較
 5108: 
 5109: @pindex comm
 5110: @cindex line-by-line comparison
 5111: @cindex comparing sorted files
 5112: 
 5113: @c @command{comm} writes to standard output lines that are common, and lines
 5114: @c that are unique, to two input files; a file name of @samp{-} means
 5115: @c standard input.  Synopsis:
 5116: @c 
 5117: @command{comm}は,二つの入力ファイルの共通の行とユニークな行を標準出力
 5118: に書き出します.@samp{-}のファイル名は標準入力を意味します.概要です.
 5119: 
 5120: @example
 5121: comm [@var{option}]@dots{} @var{file1} @var{file2}
 5122: @end example
 5123: 
 5124: @vindex LC_COLLATE
 5125: @c Before @command{comm} can be used, the input files must be sorted using the
 5126: @c collating sequence specified by the @env{LC_COLLATE} locale.
 5127: @c If an input file ends in a non-newline
 5128: @c character, a newline is silently appended.  The @command{sort} command with
 5129: @c no options always outputs a file that is suitable input to @command{comm}.
 5130: @c 
 5131: @command{comm}を使用する前に,@env{LC_COLLATE}ロケールで指定された順番
 5132: に入力ファイルをソートする必要があります.入力ファイルが改行文字で終ら
 5133: ない場合,改行は暗黙に付加されます.オプションを用いない@command{sort}
 5134: コマンドは,@command{comm}の入力に適したファイルを常に出力します.
 5135: 
 5136: @cindex differing lines
 5137: @cindex common lines
 5138: @c With no options, @command{comm} produces three column output.  Column one
 5139: @c contains lines unique to @var{file1}, column two contains lines unique
 5140: @c to @var{file2}, and column three contains lines common to both files.
 5141: @c Columns are separated by a single TAB character.
 5142: @c 
 5143: オプションが無い場合,@command{comm}は三列の出力を生成します.一列目は
 5144: @var{file1}のユニークな行を含み,二列目は@var{file2}のユニークな行を含
 5145: み,三列目は両方のファイルに共通な列を含みます.列は単一のTAB文字で分
 5146: 離されます.
 5147: @c FIXME: when there's an option to supply an alternative separator
 5148: @c string, append `by default' to the above sentence.
 5149: 
 5150: @opindex -1
 5151: @opindex -2
 5152: @opindex -3
 5153: @c The options @option{-1}, @option{-2}, and @option{-3} suppress printing of
 5154: @c the corresponding columns.  Also see @ref{Common options}.
 5155: @c 
 5156: オプションの@option{-1},@option{-2},そして@option{-3}は,対応する列
 5157: の出力を抑制します.@ref{Common options}も参照してください.
 5158: 
 5159: @c Unlike some other comparison utilities, @command{comm} has an exit
 5160: @c status that does not depend on the result of the comparison.
 5161: @c Upon normal completion @command{comm} produces an exit code of zero.
 5162: @c If there is an error it exits with nonzero status.
 5163: @c 
 5164: 他の比較ユーティリティとは異なり,@command{comm}は比較の結果に依存しな
 5165: い終了ステータスがあります.上記の通常の比較では,@command{comm}はゼロ
 5166: のコードで終了します.エラーがあった場合,ゼロでないステータスで終了し
 5167: ます.
 5168: 
 5169: 
 5170: @node tsort invocation
 5171: @c @section @command{tsort}: Topological sort
 5172: @section @command{tsort}: 位相幾何学的なソート
 5173: 
 5174: @pindex tsort
 5175: @cindex topological sort
 5176: 
 5177: @c @command{tsort} performs a topological sort on the given @var{file}, or
 5178: @c standard input if no input file is given or for a @var{file} of
 5179: @c @samp{-}.  For more details and some history, see @ref{tsort background}.
 5180: @c Synopsis:
 5181: @c 
 5182: @command{tsort}は,位相幾何学的なソートを,与えられた@var{file},また
 5183: は入力ファイルが与えられない場合や@samp{-}のファイルに対しては標準入力
 5184: で実行します.詳細とちょっとした歴史は@ref{tsort background}を参照して
 5185: ください.概要です.
 5186: 
 5187: @example
 5188: tsort [@var{option}] [@var{file}]
 5189: @end example
 5190: 
 5191: @c @command{tsort} reads its input as pairs of strings, separated by blanks,
 5192: @c indicating a partial ordering.  The output is a total ordering that
 5193: @c corresponds to the given partial ordering.
 5194: @c 
 5195: @command{tsort}は,その入力を文字列の組で,空白で分離されていて,不完
 5196: 全な順序で示されているものとして読み込みます.出力は,与えられた不完全
 5197: な順序に対応する完全な順序になります.
 5198: 
 5199: @c For example
 5200: @c 
 5201: 例えば以下のようにします.
 5202: 
 5203: @example
 5204: tsort <<EOF
 5205: a b c
 5206: d
 5207: e f
 5208: b c d e
 5209: EOF
 5210: @end example
 5211: 
 5212: @noindent
 5213: @c will produce the output
 5214: @c 
 5215: これは以下の出力を生成します.
 5216: 
 5217: @example
 5218: a
 5219: b
 5220: c
 5221: d
 5222: e
 5223: f
 5224: @end example
 5225: 
 5226: @c Consider a more realistic example.
 5227: @c You have a large set of functions all in one file, and they may all be
 5228: @c declared static except one.  Currently that one (say @code{main}) is the
 5229: @c first function defined in the file, and the ones it calls directly follow
 5230: @c it, followed by those they call, etc.  Let's say that you are determined
 5231: @c to take advantage of prototypes, so you have to choose between declaring
 5232: @c all of those functions (which means duplicating a lot of information from
 5233: @c the definitions) and rearranging the functions so that as many as possible
 5234: @c are defined before they are used.  One way to automate the latter process
 5235: @c is to get a list for each function of the functions it calls directly.
 5236: @c Many programs can generate such lists.  They describe a call graph.
 5237: @c Consider the following list, in which a given line indicates that the
 5238: @c function on the left calls the one on the right directly.
 5239: @c 
 5240: より現実的な例を考えてみましょう.一つのファイルに大きなすべての関数の
 5241: セットがあり,一つ以外のすべてがスタティックに宣言されていると仮定しま
 5242: す.現在,それ(いわゆる@code{main})はファイルの最初に定義されていて,
 5243: それから直接呼び出されるものが続き,それらが呼び出すものがそれに続いて
 5244: いる,といったようになっています.さて,プロトタイプの利点が決定すると,
 5245: それらの関数の宣言(定義からのたくさんの情報が重複していることを意味し
 5246: ます)の関係を選択し,それらが使用される前にできるだけ多くの関数の順番
 5247: を整理することになるでしょう,それ以降の処理を自動化する一つの方法とし
 5248: て,直接呼ばれるそれぞれの関数のリストを入手することがあげられます.そ
 5249: のようなリストを生成することが可能なプログラムはたくさんあります.それ
 5250: らはグラフと呼ばれる物を記述します.それぞれの行で,左の関数が右の関数
 5251: を直接呼び出すことを示している以下のリストを考えてみましょう.
 5252: 
 5253: @example
 5254: main parse_options
 5255: main tail_file
 5256: main tail_forever
 5257: tail_file pretty_name
 5258: tail_file write_header
 5259: tail_file tail
 5260: tail_forever recheck
 5261: tail_forever pretty_name
 5262: tail_forever write_header
 5263: tail_forever dump_remainder
 5264: tail tail_lines
 5265: tail tail_bytes
 5266: tail_lines start_lines
 5267: tail_lines dump_remainder
 5268: tail_lines file_lines
 5269: tail_lines pipe_lines
 5270: tail_bytes xlseek
 5271: tail_bytes start_bytes
 5272: tail_bytes dump_remainder
 5273: tail_bytes pipe_bytes
 5274: file_lines dump_remainder
 5275: recheck pretty_name
 5276: @end example
 5277: 
 5278: @c then you can use @command{tsort} to produce an ordering of those
 5279: @c functions that satisfies your requirement.
 5280: @c 
 5281: そのとき,要求を満足するようにそれらの関数の順番を生成するため,
 5282: @command{tsort}を使用することが可能です.
 5283: 
 5284: @example
 5285: example$ tsort call-graph | tac
 5286: dump_remainder
 5287: start_lines
 5288: file_lines
 5289: pipe_lines
 5290: xlseek
 5291: start_bytes
 5292: pipe_bytes
 5293: tail_lines
 5294: tail_bytes
 5295: pretty_name
 5296: write_header
 5297: tail
 5298: recheck
 5299: parse_options
 5300: tail_file
 5301: tail_forever
 5302: main
 5303: @end example
 5304: 
 5305: @c @command{tsort} detects any cycles in the input and writes the first cycle
 5306: @c encountered to standard error.
 5307: @c 
 5308: @command{tsort}は入力内の循環を検出し,出現した最初の循環部分を標準エ
 5309: ラーに書き出します.
 5310: 
 5311: @c Note that for a given partial ordering, generally there is no unique
 5312: @c total ordering.  In the context of the call graph above, the function
 5313: @c @code{parse_options} may be placed anywhere in the list as long as it
 5314: @c precedes @code{main}.
 5315: @c 
 5316: 与えられた不完全な順序が,一般に唯一の完全な順序でないことに注意してく
 5317: ださい.上記の例の状況では,関数@code{parse_options}は,@code{main}の
 5318: 前であればリストのどこにあってもかまいません.
 5319: 
 5320: @c The only options are @option{--help} and @option{--version}.  @xref{Common
 5321: @c options}.
 5322: @c 
 5323: オプションは,@option{--help}と@option{--version}のみです.
 5324: @xref{Common options}.
 5325: 
 5326: @node tsort background
 5327: @c @section @command{tsort}: Background
 5328: @section @command{tsort}: 背景
 5329: 
 5330: @c @command{tsort} exists because very early versions of the Unix linker processed
 5331: @c an archive file exactly once, and in order.  As @command{ld} read each object
 5332: @c in the archive, it decided whether it was needed in the program based on
 5333: @c whether it defined any symbols which were undefined at that point in
 5334: @c the link.
 5335: @c 
 5336: @command{tsort}は,初期のUnixのバージョンのリンカで,アーカイブファイ
 5337: ルを正確に一度だけ正しい順序で処理するために存在しています.
 5338: @command{ld}はそれぞれのオブジェクトをアーカイブから読み出すので,プロ
 5339: グラムで基本となるものが必要かどうか,リンク時に未定義のシンボルが定義
 5340: されているかどうかは明確です.
 5341: 
 5342: @c This meant that dependencies within the archive had to be handled
 5343: @c specially.  For example, @code{scanf} probably calls @code{read}.  That means
 5344: @c that in a single pass through an archive, it was important for @code{scanf.o}
 5345: @c to appear before read.o, because otherwise a program which calls
 5346: @c @code{scanf} but not @code{read} might end up with an unexpected unresolved
 5347: @c reference to @code{read}.
 5348: @c 
 5349: これは,アーカイブでの依存性を特別処理する必要があったことを意味します.
 5350: 例えば,@code{scanf}はおそらく@code{read}を呼び出します.それは,一度
 5351: アーカイブ全体を見渡すとき,@code{scanf.o}が@code{read.o}の前に現れる
 5352: ことが重要だということで,そうでなければ,@code{scanf}を呼び出している
 5353: が,@code{read}を呼び出していないプログラムで,期待していない未解決の
 5354: @code{read}への参照に結局なってしまうからです.
 5355: 
 5356: @c The way to address this problem was to first generate a set of
 5357: @c dependencies of one object file on another.  This was done by a shell
 5358: @c script called @command{lorder}.  The GNU tools don't provide a version of
 5359: @c lorder, as far as I know, but you can still find it in BSD
 5360: @c distributions.
 5361: @c 
 5362: この問題を解決する方法は,最初にオブジェクトファイル内の依存性を生成す
 5363: ることです.これは,@command{lorder}と呼ばれるシェルスクリプトで行なわ
 5364: れていました.GNUツールは,私の知る限りlorderを用いるバージョンを提供
 5365: していませんが,BSDの配布物ではまだ見つかるはずです.
 5366: 
 5367: @c Then you ran @command{tsort} over the @command{lorder} output, and you used the
 5368: @c resulting sort to define the order in which you added objects to the archive.
 5369: @c 
 5370: @command{lorder}の出力で@command{tsort}を実行すると,アーカイブに追加
 5371: したオブジェクトの定義順を並べ替えた結果を使用することが可能になります.
 5372: 
 5373: @c This whole procedure has been obsolete since about 1980, because
 5374: @c Unix archives now contain a symbol table (traditionally built by
 5375: @c @command{ranlib}, now generally built by @command{ar} itself), and the Unix
 5376: @c linker uses the symbol table to effectively make multiple passes over
 5377: @c an archive file.
 5378: @c 
 5379: 1980年以降,Unixのアーカイブにはシンボル表が含まれていて(伝統的に
 5380: @command{ranlib}で構築され,今では@command{ar}自身で構築されます),
 5381: Unixのリンカは,アーカイブファイル全体を何回も効率的に処理するため,そ
 5382: のシンボル表を使用するので,この一連の処理は時代遅れです.
 5383: 
 5384: @c Anyhow, that's where tsort came from.  To solve an old problem with
 5385: @c the way the linker handled archive files, which has since been solved
 5386: @c in different ways.
 5387: @c 
 5388: いずれにせよ,こういうことで@command{tsort}は生まれました.古い問題を
 5389: 解決するためにリンカがアーカイブファイルを処理する方法で,それは別の方
 5390: 法で解決されています.
 5391: 
 5392: @node ptx invocation
 5393: @c @section @command{ptx}: Produce permuted indexes
 5394: @section @command{ptx}: 並べ替えた索引の生成
 5395: 
 5396: @pindex ptx
 5397: 
 5398: @c @command{ptx} reads a text file and essentially produces a permuted index, with
 5399: @c each keyword in its context.  The calling sketch is either one of:
 5400: @c 
 5401: @command{ptx}は,テキストファイルを読み込み,その内容のそれぞれのキー
 5402: ワードを用いて,並べ替えられた索引を本来は生成します.呼び出しの形態は
 5403: 以下の一つです.
 5404: 
 5405: @example
 5406: ptx [@var{option} @dots{}] [@var{file} @dots{}]
 5407: ptx -G [@var{option} @dots{}] [@var{input} [@var{output}]]
 5408: @end example
 5409: 
 5410: @c The @option{-G} (or its equivalent: @option{--traditional}) option disables
 5411: @c all @sc{gnu} extensions and reverts to traditional mode, thus introducing some
 5412: @c limitations and changing several of the program's default option values.
 5413: @c When @option{-G} is not specified, @sc{gnu} extensions are always enabled.
 5414: @c @sc{gnu} extensions to @command{ptx} are documented wherever appropriate in this
 5415: @c document.  For the full list, see @xref{Compatibility in ptx}.
 5416: @c 
 5417: @option{-G}(または同等の: @option{--traditional})オプションは,全ての
 5418: @sc{gnu}拡張を利用不可にし,伝統的なモードに切替えるので,いくつか制限
 5419: があり,そしてプログラムのオプションデフォルト値を変更します.
 5420: @option{-G}が指定されていない場合,@sc{gnu}拡張は常に利用可能です.
 5421: @command{ptx}の@sc{gnu}拡張は,このドキュメントに適切に文章化されてい
 5422: ます.完全なリストは,@xref{Compatibility in ptx}.
 5423: 
 5424: @c Individual options are explained in the following sections.
 5425: @c 
 5426: 個別のオプションは,以下のセクションで説明します.
 5427: 
 5428: @c When @sc{gnu} extensions are enabled, there may be zero, one or several
 5429: @c @var{file}s after the options.  If there is no @var{file}, the program
 5430: @c reads the standard input.  If there is one or several @var{file}s, they
 5431: @c give the name of input files which are all read in turn, as if all the
 5432: @c input files were concatenated.  However, there is a full contextual
 5433: @c break between each file and, when automatic referencing is requested,
 5434: @c file names and line numbers refer to individual text input files.  In
 5435: @c all cases, the program outputs the permuted index to the standard
 5436: @c output.
 5437: @c 
 5438: @sc{gnu}拡張が利用可能なとき,ゼロ,一つ,または複数の@var{file}をオプ
 5439: ションの後に続けてかまいません.@var{file}が無い場合,プログラムは標準
 5440: 入力から読み込みます.一つまたは複数@var{file}ある場合,全ての入力ファ
 5441: イルが連結されているかのように,順番に全て読み込まれる入力ファイル名に
 5442: なります.しかし,それぞれのファイルの間に完全に文脈の終りが有り,自動
 5443: 的な参照が要求されるとき,ファイル名と行番号は,入力ファイルの個別のテ
 5444: キストを参照します.全ての状況で,プログラムは並べ替えられた索引を標準
 5445: 出力に書き出します.
 5446: 
 5447: @c When @sc{gnu} extensions are @emph{not} enabled, that is, when the program
 5448: @c operates in traditional mode, there may be zero, one or two parameters
 5449: @c besides the options.  If there are no parameters, the program reads the
 5450: @c standard input and outputs the permuted index to the standard output.
 5451: @c If there is only one parameter, it names the text @var{input} to be read
 5452: @c instead of the standard input.  If two parameters are given, they give
 5453: @c respectively the name of the @var{input} file to read and the name of
 5454: @c the @var{output} file to produce.  @emph{Be very careful} to note that,
 5455: @c in this case, the contents of file given by the second parameter is
 5456: @c destroyed.  This behavior is dictated by System V @command{ptx}
 5457: @c compatibility; @sc{gnu} Standards normally discourage output parameters not
 5458: @c introduced by an option.
 5459: @c 
 5460: @sc{gnu}拡張が利用可能で@emph{ない}とき,すなわち,伝統的なモードでプ
 5461: ログラムが動作しているとき,ゼロ,一つ,または二つのパラメータをオプショ
 5462: ンの後に続けてかまもいません.パラメータが無い場合,プログラムは標準入
 5463: 力を読み込み,標準出力に並べ替えた索引を生成します.一つのパラメータの
 5464: みの場合,それは標準入力の代わりに読み込まれるテキスト@var{input}を指
 5465: 名します.二つのパラメータが与えられた場合,それらはそれぞれ,読み込ま
 5466: れる@var{input}ファイル名と,生成する@var{output}ファイル名を与えます.
 5467: この場合,二番目のパラメータとして与えられるファイルの内容が壊れること
 5468: に@emph{十分注意して}ください.この動作は,System V @command{ptx}互換
 5469: で規定されています.@sc{gnu}の標準は,オプションで導入されない出力パラ
 5470: メータを防止します.
 5471: 
 5472: @c Note that for @emph{any} file named as the value of an option or as an
 5473: @c input text file, a single dash @kbd{-} may be used, in which case
 5474: @c standard input is assumed.  However, it would not make sense to use this
 5475: @c convention more than once per program invocation.
 5476: @c 
 5477: @emph{あらゆる}ファイルは,オプション値や入力テキストファイルとして指
 5478: 名され,単一のダッシュ@kbd{-}を使用でき,その場合は標準入力と考えられ
 5479: ます.しかし,プログラムの呼び出しに一回以上,この慣習を使用する意味は
 5480: ありません.
 5481: 
 5482: @menu
 5483: * General options in ptx::      Options which affect general program behavior.
 5484: * Charset selection in ptx::    Underlying character set considerations.
 5485: * Input processing in ptx::     Input fields, contexts, and keyword selection.
 5486: * Output formatting in ptx::    Types of output format, and sizing the fields.
 5487: * Compatibility in ptx::
 5488: @end menu
 5489: 
 5490: 
 5491: @node General options in ptx
 5492: @c @subsection General options
 5493: @subsection 一般的なオプション
 5494: 
 5495: @table @samp
 5496: 
 5497: @item -C
 5498: @itemx --copyright
 5499: @c Print a short note about the copyright and copying conditions, then
 5500: @c exit without further processing.
 5501: @c 
 5502: 著作権とコピー条件の短いメモを出力し,それ以上何も処理せず終了します.
 5503: 
 5504: @item -G
 5505: @itemx --traditional
 5506: @c As already explained, this option disables all @sc{gnu} extensions to
 5507: @c @command{ptx} and switches to traditional mode.
 5508: @c 
 5509: 既に拡張されているので,このオプションは,@command{ptx}に対する全ての
 5510: @sc{gnu}拡張を利用不可にし,伝統的なモードに切替えます.
 5511: 
 5512: @item --help
 5513: @c Print a short help on standard output, then exit without further
 5514: @c processing.
 5515: @c 
 5516: 短いヘルプを標準出力に出力し,それ以上何も処理せず終了します.
 5517: 
 5518: @item --version
 5519: @c Print the program version on standard output, then exit without further
 5520: @c processing.
 5521: @c 
 5522: プログラムのバージョンを標準出力に出力し,それ以上何も処理せずに終了し
 5523: ます.
 5524: 
 5525: @end table
 5526: 
 5527: 
 5528: @node Charset selection in ptx
 5529: @c @subsection Charset selection
 5530: @subsection 文字セットの選択
 5531: 
 5532: @c FIXME:  People don't necessarily know what an IBM-PC was these days.
 5533: @c 
 5534: @c As it is set up now, the program assumes that the input file is coded
 5535: @c using 8-bit ISO 8859-1 code, also known as Latin-1 character set,
 5536: @c @emph{unless} it is compiled for MS-DOS, in which case it uses the
 5537: @c character set of the IBM-PC.  (@sc{gnu} @command{ptx} is not known to work on
 5538: @c smaller MS-DOS machines anymore.)  Compared to 7-bit @acronym{ASCII}, the set
 5539: @c of characters which are letters is different; this alters the behavior
 5540: @c of regular expression matching.  Thus, the default regular expression
 5541: @c for a keyword allows foreign or diacriticized letters.  Keyword sorting,
 5542: @c however, is still crude; it obeys the underlying character set ordering
 5543: @c quite blindly.
 5544: @c 
 5545: 現在セットアップされているので,プログラムは,入力ファイルが8ビット
 5546: ISO-8859-1コードを使用して符号化されていると考え,Latin-1文字セットだ
 5547: ということも分かりますが,それは,MS-DOSでコンパイル@emph{されていない
 5548: 場合}で,その場合はIBM-PCの文字セットを使用します.(@sc{gnu}
 5549: @command{ptx}を,より小さいMS-DOSマシンで動作させる方法が分かりません.)
 5550: 7-bit @acronym{ASCII}とは異なり,文字である文字セットは別物です.これ
 5551: は正規表現のマッチの動作を変更します.そのため,キーワードに対するデフォ
 5552: ルトの正規表現で,外国や発音記号の文字が可能となります.しかし,キーワー
 5553: ドのソートはそのままです.それは,全く盲目的に基礎的な文字セットの順序
 5554: に従います.
 5555: 
 5556: @table @samp
 5557: 
 5558: @item -f
 5559: @itemx --ignore-case
 5560: @c Fold lower case letters to upper case for sorting.
 5561: @c 
 5562: ソートに対し,小文字を大文字にまとめます.
 5563: 
 5564: @end table
 5565: 
 5566: 
 5567: @node Input processing in ptx
 5568: @c @subsection Word selection and input processing
 5569: @subsection 単語の選択と入力の処理
 5570: 
 5571: @table @samp
 5572: 
 5573: @item -b @var{file}
 5574: @item --break-file=@var{file}
 5575: 
 5576: @c This option provides an alternative (to @option{-W}) method of describing
 5577: @c which characters make up words.  It introduces the name of a
 5578: @c file which contains a list of characters which can@emph{not} be part of
 5579: @c one word; this file is called the @dfn{Break file}.  Any character which
 5580: @c is not part of the Break file is a word constituent.  If both options
 5581: @c @option{-b} and @option{-W} are specified, then @option{-W} has precedence and
 5582: @c @option{-b} is ignored.
 5583: @c 
 5584: このオプションは,単語を生成する文字の記述方法(@option{-W})の代替物を
 5585: 提供します.それは,単語の部分にならない文字のリストを含むファイル名を
 5586: 導入し,このファイルは@dfn{ブレークファイル(Break file)}と呼ばれます.
 5587: ブレークファイルの一部でないあらゆる文字は単語の要素です.@option{-b}
 5588: と@option{-W}を両方指定した場合,@option{-W}が優先され@option{-b}は無
 5589: 視されます.
 5590: 
 5591: @c When @sc{gnu} extensions are enabled, the only way to avoid newline as a
 5592: @c break character is to write all the break characters in the file with no
 5593: @c newline at all, not even at the end of the file.  When @sc{gnu} extensions
 5594: @c are disabled, spaces, tabs and newlines are always considered as break
 5595: @c characters even if not included in the Break file.
 5596: @c 
 5597: @sc{gnu}拡張が利用可能な場合,改行をブレーク文字とすることを避ける唯一
 5598: の方法で,ファイルの終りにさえ改行が全く無いファイルに,全てのブレーク
 5599: 文字を書くことでできます.@sc{gnu}拡張が利用不可能な場合,スペース,タ
 5600: ブ,そして改行は,ブレークファイルに含まれていない場合でも,常にブレー
 5601: ク文字だと考慮されます.
 5602: 
 5603: @item -i @var{file}
 5604: @itemx --ignore-file=@var{file}
 5605: 
 5606: @c The file associated with this option contains a list of words which will
 5607: @c never be taken as keywords in concordance output.  It is called the
 5608: @c @dfn{Ignore file}.  The file contains exactly one word in each line; the
 5609: @c end of line separation of words is not subject to the value of the
 5610: @c @option{-S} option.
 5611: @c 
 5612: このオプションで関連付けられたファイルは,用語索引の出力でキーワードと
 5613: されない単語のリストを含みます.それは@dfn{無視ファイル(Ignore file)} 
 5614: と呼ばれます.ファイルは,正確にそれぞれの行に一単語を含みます.単語を
 5615: 分ける行の終りは,@option{-S}オプションの値を適用されません.
 5616: 
 5617: @c There is a default Ignore file used by @command{ptx} when this option is
 5618: @c not specified, usually found in @file{/usr/local/lib/eign} if this has
 5619: @c not been changed at installation time.  If you want to deactivate the
 5620: @c default Ignore file, specify @code{/dev/null} instead.
 5621: @c 
 5622: このオプションが指定されない場合,デフォルトの無視ファイルが
 5623: @command{ptx}で使用され,インストール時に変更されていない場合,通常は
 5624: @file{/usr/local/lib/eign}で見つかります.デフォルトの無視ファイルの影
 5625: 響を無くしたい場合,代わりに@code{/dev/null}を指定してください.
 5626: 
 5627: @item -o @var{file}
 5628: @itemx --only-file=@var{file}
 5629: 
 5630: @c The file associated with this option contains a list of words which will
 5631: @c be retained in concordance output; any word not mentioned in this file
 5632: @c is ignored.  The file is called the @dfn{Only file}.  The file contains
 5633: @c exactly one word in each line; the end of line separation of words is
 5634: @c not subject to the value of the @option{-S} option.
 5635: @c 
 5636: このオプションで関連付けられたファイルは,用語索引の出力に維持される単
 5637: 語のリストを含み,このファイルで述べていないあらゆる単語は無視されます.
 5638: ファイルは@dfn{オンリーファイル(Only file)}と呼ばれています.ファイル
 5639: は,正確にそれぞれの行に一単語を含みます.単語を分ける行の終りは,
 5640: @option{-S}オプションの値を適用されません.
 5641: 
 5642: @c There is no default for the Only file.  When both an Only file and an
 5643: @c Ignore file are specified, a word is considered a keyword only
 5644: @c if it is listed in the Only file and not in the Ignore file.
 5645: @c 
 5646: オンリーファイルにデフォルトはありません.オンリーファイルと無視ファイ
 5647: ルの両方にある場合,オンリーファイルで与えられ,無視ファイルで与えられ
 5648: ない単語のみキーワードに適用されます.
 5649: 
 5650: @item -r
 5651: @itemx --references
 5652: 
 5653: @c On each input line, the leading sequence of non-white space characters will be
 5654: @c taken to be a reference that has the purpose of identifying this input
 5655: @c line in the resulting permuted index.  For more information about reference
 5656: @c production, see @xref{Output formatting in ptx}.
 5657: @c Using this option changes the default value for option @option{-S}.
 5658: @c 
 5659: それぞれの入力行で,空白文字でない前置された並びは,結果として得られる
 5660: 並べ替えされた索引で,この入力行を識別する目的の参照として受け取られま
 5661: す.参照生成に関するより多くの情報は,@xref{Output formatting in ptx}. 
 5662: このオプションの使用で,オプション@option{-S}に対するデフォルト値を変
 5663: 更します.
 5664: 
 5665: @c Using this option, the program does not try very hard to remove
 5666: @c references from contexts in output, but it succeeds in doing so
 5667: @c @emph{when} the context ends exactly at the newline.  If option
 5668: @c @option{-r} is used with @option{-S} default value, or when @sc{gnu} extensions
 5669: @c are disabled, this condition is always met and references are completely
 5670: @c excluded from the output contexts.
 5671: @c 
 5672: このオプションを使用すると,プログラムは出力の文脈からの参照の削除の試
 5673: みが非常に難しくなりますが,文脈の終りが正確に改行で終る@emph{とき},
 5674: そうすることに成功します.オプション@option{-r}が@option{-S}デフォルト
 5675: 値とともに使用された場合や,@sc{gnu}拡張が利用不可能なとき,この条件は
 5676: 常に満たされ,参照は完全に出力文脈から除外されます.
 5677: 
 5678: @item -S @var{regexp}
 5679: @itemx --sentence-regexp=@var{regexp}
 5680: 
 5681: @c This option selects which regular expression will describe the end of a
 5682: @c line or the end of a sentence.  In fact, this regular expression is not
 5683: @c the only distinction between end of lines or end of sentences, and input
 5684: @c line boundaries have no special significance outside this option.  By
 5685: @c default, when @sc{gnu} extensions are enabled and if @option{-r} option is not
 5686: @c used, end of sentences are used.  In this case, this @var{regex} is
 5687: @c imported from @sc{gnu} Emacs:
 5688: @c 
 5689: このオプションは,行末や文の終りを記述する正規表現を選択します.実際,
 5690: この正規表現の効果以外に,行末や文の終わりのには他の区別があり,入力行
 5691: の境界は,このオプションの外で特別な重要性はありません.デフォルトで,
 5692: @sc{gnu}拡張が使用可能なときや,@option{-r}オプションが使用されていな
 5693: い場合,文の終りが使用されます.この場合,正確な@var{regex}は@sc{gnu}
 5694: emacsから取り込まれます.
 5695: 
 5696: @example
 5697: [.?!][]\"')@}]*\\($\\|\t\\|  \\)[ \t\n]*
 5698: @end example
 5699: 
 5700: @c Whenever @sc{gnu} extensions are disabled or if @option{-r} option is used, end
 5701: @c of lines are used; in this case, the default @var{regexp} is just:
 5702: @c 
 5703: @sc{gnu}拡張が使用不可能なときや,@option{-r}オプションが使用されてい
 5704: る場合は,常に行の終りが使用され,この場合デフォルトの@var{regexp}は以
 5705: 下のようになります.
 5706: 
 5707: @example
 5708: \n
 5709: @end example
 5710: 
 5711: @c Using an empty @var{regexp} is equivalent to completely disabling end of
 5712: @c line or end of sentence recognition.  In this case, the whole file is
 5713: @c considered to be a single big line or sentence.  The user might want to
 5714: @c disallow all truncation flag generation as well, through option @option{-F
 5715: @c ""}.  @xref{Regexps, , Syntax of Regular Expressions, emacs, The GNU Emacs
 5716: @c Manual}.
 5717: @c 
 5718: 空の@var{regexp}の使用は,行末と文の終りの認識を完全に不可能にすること
 5719: と同等です.この場合,ファイル全体が単一の大きな行や文と考えられます.
 5720: ユーザは,オプション@samp{-F ""}を通じて,全ての切り詰めフラグの生成を,
 5721: 不許可にしたい場合もあります.@xref{Regexps, , Syntax of Regular
 5722: Expressions, emacs, The GNU Emacs Manual}.
 5723: 
 5724: @c When the keywords happen to be near the beginning of the input line or
 5725: @c sentence, this often creates an unused area at the beginning of the
 5726: @c output context line; when the keywords happen to be near the end of the
 5727: @c input line or sentence, this often creates an unused area at the end of
 5728: @c the output context line.  The program tries to fill those unused areas
 5729: @c by wrapping around context in them; the tail of the input line or
 5730: @c sentence is used to fill the unused area on the left of the output line;
 5731: @c the head of the input line or sentence is used to fill the unused area
 5732: @c on the right of the output line.
 5733: @c 
 5734: キーワードが入力行や文の最初で発生したとき,出力文脈の行の最初に,利用
 5735: されない領域を作成することもよくあります.キーワードが入力行や文の終り
 5736: 近くで発生したとき,出力文脈の行の終りに利用されない領域を作成すること
 5737: もよくあります.プログラムは,その中の文脈の周りを包むことで,それらの
 5738: 領域を補充しようとします.入力行や文の頭は,出力行の右の利用されていな
 5739: い行を補充するために使用されます.
 5740: 
 5741: @c As a matter of convenience to the user, many usual backslashed escape
 5742: @c sequences from the C language are recognized and converted to the
 5743: @c corresponding characters by @command{ptx} itself.
 5744: @c 
 5745: ユーザの利便性の問題として,C言語で見つかる,通常のバックスラッシュさ
 5746: れたエスケープ・シーケンスは認識され,@command{ptx}自身によって対応す
 5747: る文字に変換されます.
 5748: 
 5749: @item -W @var{regexp}
 5750: @itemx --word-regexp=@var{regexp}
 5751: 
 5752: @c This option selects which regular expression will describe each keyword.
 5753: @c By default, if @sc{gnu} extensions are enabled, a word is a sequence of
 5754: @c letters; the @var{regexp} used is @samp{\w+}.  When @sc{gnu} extensions are
 5755: @c disabled, a word is by default anything which ends with a space, a tab
 5756: @c or a newline; the @var{regexp} used is @samp{[^ \t\n]+}.
 5757: @c 
 5758: このオプションは,それぞれのキーワードを記述している正規表現を選択しま
 5759: す.デフォルトで,@sc{gnu}拡張が利用可能な場合,単語は文字の並びです.
 5760: 使用される@var{regexp}は@samp{\w+}です.@sc{gnu}拡張が利用不可能な場合,
 5761: 単語はデフォルトで,スペース,タブ,または改行で終るあらゆるものです.
 5762: 使用される@var{regexp}は@samp{[^ \t\n]+}です.
 5763: 
 5764: @c An empty @var{regexp} is equivalent to not using this option.
 5765: @c @xref{Regexps, , Syntax of Regular Expressions, emacs, The GNU Emacs
 5766: @c Manual}.
 5767: @c 
 5768: 空の@var{regexp}は,このオプションを使用しないのと同等で,デフォルト動
 5769: 作になります.@xref{Regexps, , Syntax of Regular Expressions, emacs,
 5770: The GNU Emacs Manual}.
 5771: 
 5772: @c As a matter of convenience to the user, many usual backslashed escape
 5773: @c sequences, as found in the C language, are recognized and converted to
 5774: @c the corresponding characters by @command{ptx} itself.
 5775: @c 
 5776: ユーザの利便性の問題として,C言語で見つかる,多くの通常のバックスラッ
 5777: シュされたエスケープ・シーケンスは認識され,@command{ptx}自身によって
 5778: 対応する文字に変換されます.
 5779: 
 5780: @end table
 5781: 
 5782: 
 5783: @node Output formatting in ptx
 5784: @c @subsection Output formatting
 5785: @subsection 出力の書式
 5786: 
 5787: @c Output format is mainly controlled by the @option{-O} and @option{-T} options
 5788: @c described in the table below.  When neither @option{-O} nor @option{-T} are
 5789: @c selected, and if @sc{gnu} extensions are enabled, the program chooses an
 5790: @c output format suitable for a dumb terminal.  Each keyword occurrence is
 5791: @c output to the center of one line, surrounded by its left and right
 5792: @c contexts.  Each field is properly justified, so the concordance output
 5793: @c can be readily observed.  As a special feature, if automatic
 5794: @c references are selected by option @option{-A} and are output before the
 5795: @c left context, that is, if option @option{-R} is @emph{not} selected, then
 5796: @c a colon is added after the reference; this nicely interfaces with @sc{gnu}
 5797: @c Emacs @code{next-error} processing.  In this default output format, each
 5798: @c white space character, like newline and tab, is merely changed to
 5799: @c exactly one space, with no special attempt to compress consecutive
 5800: @c spaces.  This might change in the future.  Except for those white space
 5801: @c characters, every other character of the underlying set of 256
 5802: @c characters is transmitted verbatim.
 5803: @c 
 5804: 出力書式は,主に@option{-O}と@option{-T}オプションで制御され,それは以
 5805: 下の表で記述されています.@option{-O}も@option{-T}も選択されていないと
 5806: きで,@sc{gnu}拡張が利用可能な場合,プログラムはdumb端末に適した出力書
 5807: 式を選択します.それぞれのキーワードの生成は,出力を行の中心にし,周り
 5808: をその左右の文脈で囲います.それぞれのフィールドは適切で正しいものなの
 5809: で,用語索引の出力を容易に観察することが可能です.特別な特徴として,自
 5810: 動的な参照がオプション@option{-A}で指定されていて,左の文脈の前に出力
 5811: されている,すなわち,オプション@option{-R}が選択されて@emph{いない}場
 5812: 合,コロンが参照の後に追加されます.これは,@sc{gnu} Emacsが
 5813: @code{next-error}を処理することでうまく作用します.このデフォルト出力
 5814: 書式では,改行やタブのようなそれぞれの空白文字は,正確に一つのスペース
 5815: に単に変換され,連続したスペースの圧縮は特に試みません.これは将来変更
 5816: されるかもしれません.これらの空白文字以外の,256文字の基本セットの全
 5817: ての他の文字は逐語的に転送されます.
 5818: 
 5819: @c Output format is further controlled by the following options.
 5820: @c 
 5821: 出力書式は,以下のオプションで更に制御されます.
 5822: 
 5823: @table @samp
 5824: 
 5825: @item -g @var{number}
 5826: @itemx --gap-size=@var{number}
 5827: 
 5828: @c Select the size of the minimum white space gap between the fields on the
 5829: @c output line.
 5830: @c 
 5831: 出力行のフィールド間の最小の空白の隙間を選択します.
 5832: 
 5833: @item -w @var{number}
 5834: @itemx --width=@var{number}
 5835: 
 5836: @c Select the maximum output width of each final line.  If references are
 5837: @c used, they are included or excluded from the maximum output width
 5838: @c depending on the value of option @option{-R}.  If this option is not
 5839: @c selected, that is, when references are output before the left context,
 5840: @c the maximum output width takes into account the maximum length of all
 5841: @c references.  If this option is selected, that is, when references are
 5842: @c output after the right context, the maximum output width does not take
 5843: @c into account the space taken by references, nor the gap that precedes
 5844: @c them.
 5845: @c 
 5846: それぞれの最終行の出力最大幅を選択します.参照が使用される場合,
 5847: @option{-R}オプションの値に依存して,それらは出力最大幅に含められたり
 5848: 省かれたりします.これらのオプションが選択されていない場合,すなわち,
 5849: 参照が左の文脈の前に出力されるとき,出力最大幅は全ての参照の最大長まで
 5850: 考慮されます.このオプションが選択された場合,すなわち,参照が右の文脈
 5851: の後に出力されるとき,出力最大幅は参照が使用するスペースの量も,前にあ
 5852: る隙間も考慮されません.
 5853: 
 5854: @item -A
 5855: @itemx --auto-reference
 5856: 
 5857: @c Select automatic references.  Each input line will have an automatic
 5858: @c reference made up of the file name and the line ordinal, with a single
 5859: @c colon between them.  However, the file name will be empty when standard
 5860: @c input is being read.  If both @option{-A} and @option{-r} are selected, then
 5861: @c the input reference is still read and skipped, but the automatic
 5862: @c reference is used at output time, overriding the input reference.
 5863: @c 
 5864: 自動的な参照を選択します.それぞれの入力行は,ファイル名と間に単一のコ
 5865: ロンを用いた行の序数で作成された自動的な参照を持ちます.しかし,標準入
 5866: 力が読み込まれているときは,ファイル名は空です.@option{-A}と
 5867: @option{-r}の両方が選択された場合,入力参照は読み込まれスキップされま
 5868: すが,自動的な参照は出力時に利用され,それは入力参照に優先します.
 5869: 
 5870: @item -R
 5871: @itemx --right-side-refs
 5872: 
 5873: @c In the default output format, when option @option{-R} is not used, any
 5874: @c references produced by the effect of options @option{-r} or @option{-A} are
 5875: @c placed to the far right of output lines, after the right context.  With
 5876: @c default output format, when the @option{-R} option is specified, references
 5877: @c are rather placed at the beginning of each output line, before the left
 5878: @c context.  For any other output format, option @option{-R} is
 5879: @c ignored, with one exception:  with @option{-R} the width of references
 5880: @c is @emph{not} taken into account in total output width given by @option{-w}.
 5881: @c 
 5882: デフォルト出力書式で,オプション@option{-R}が使用されていないとき,オ
 5883: プション@option{-r}や@option{-A}の影響で生成されるあらゆる参照は,右の
 5884: 文脈の後に,出力行の右端に与えられます.デフォルト出力書式で,オプショ
 5885: ン@option{-R}が指定された場合,参照は,左の文脈の前に,それぞれの出力
 5886: 行の始めに代わりに与えられます.それ以外のあらゆる出力書式に対し,
 5887: @option{-R}が選択されたときは常に,参照の幅が@option{-w}で与えられた全
 5888: 体の出力幅に含まれ@emph{ない}という事実以外,オプション@option{-R}はほ
 5889: とんど無視されます.
 5890: 
 5891: @c This option is automatically selected whenever @sc{gnu} extensions are
 5892: @c disabled.
 5893: @c 
 5894: @sc{gnu}拡張が利用不可能なときは,常にこのオプションは自動的に選択され
 5895: ます.
 5896: 
 5897: @item -F @var{string}
 5898: @itemx --flac-truncation=@var{string}
 5899: 
 5900: @c This option will request that any truncation in the output be reported
 5901: @c using the string @var{string}.  Most output fields theoretically extend
 5902: @c towards the beginning or the end of the current line, or current
 5903: @c sentence, as selected with option @option{-S}.  But there is a maximum
 5904: @c allowed output line width, changeable through option @option{-w}, which is
 5905: @c further divided into space for various output fields.  When a field has
 5906: @c to be truncated because it cannot extend beyond the beginning or the end of
 5907: @c the current line to fit in, then a truncation occurs.  By default,
 5908: @c the string used is a single slash, as in @option{-F /}.
 5909: @c 
 5910: このオプションは,文字列@var{string}の使用が報告された出力での,あらゆ
 5911: る切り詰めを要求します.ほとんどの出力フィールドは,オプション
 5912: @option{-S}が選択されたのと同様に,現在の行や現在の文の始めや終りに向
 5913: かって,理論的に展開されます.しかし,許可される出力行幅の最大値は存在
 5914: し,それはオプション@option{-w}で変更でき,そしてそれは様々な出力フィー
 5915: ルドに対しスペースで更に分割されます.現在の行に適するように,その行の
 5916: 最初や終りまで伸ばすことができないためフィールドを切り詰める必要がある
 5917: とき,切り詰めが発生します.デフォルトで,使用される文字列は単一のスラッ
 5918: シュで,@samp{-F /}のようになります.
 5919: 
 5920: @c @var{string} may have more than one character, as in @option{-F ...}.
 5921: @c Also, in the particular case when @var{string} is empty (@option{-F ""}),
 5922: @c truncation flagging is disabled, and no truncation marks are appended in
 5923: @c this case.
 5924: @c 
 5925: @var{string}は一文字以上が可能で,@samp{-F ...}のようになります.また,
 5926: @var{string}が空(@samp{-F ""})となる特定の場合,切り詰めフラグは利用不
 5927: 可能で,切り詰めマークはこの場合は現われません.
 5928: 
 5929: @c As a matter of convenience to the user, many usual backslashed escape
 5930: @c sequences, as found in the C language, are recognized and converted to
 5931: @c the corresponding characters by @command{ptx} itself.
 5932: @c 
 5933: ユーザの利便性の問題として,多くの通常の,C言語で見つかる,バックスペー
 5934: スされたエスケープシーケンスは認識され,@command{ptx}自身によって,対
 5935: 応する文字に変換されます.
 5936: 
 5937: @item -M @var{string}
 5938: @itemx --macro-name=@var{string}
 5939: 
 5940: @c Select another @var{string} to be used instead of @samp{xx}, while
 5941: @c generating output suitable for @command{nroff}, @command{troff} or @TeX{}.
 5942: @c 
 5943: @code{nroff},@code{troff}や@TeX{}に適した出力を生成している間,
 5944: @samp{xx}の代わりに,使用する他の@var{string}を選択します.
 5945: 
 5946: @item -O
 5947: @itemx --format=roff
 5948: 
 5949: @c Choose an output format suitable for @command{nroff} or @command{troff}
 5950: @c processing.  Each output line will look like:
 5951: @c 
 5952: @code{nroff}や@code{troff}の処理に適した出力書式を選択します.それぞれ
 5953: の出力行は以下のようになります.
 5954: 
 5955: @smallexample
 5956: .xx "@var{tail}" "@var{before}" "@var{keyword_and_after}" "@var{head}" "@var{ref}"
 5957: @end smallexample
 5958: 
 5959: @c so it will be possible to write a @samp{.xx} roff macro to take care of
 5960: @c the output typesetting.  This is the default output format when @sc{gnu}
 5961: @c extensions are disabled.  Option @option{-M} can be used to change
 5962: @c @samp{xx} to another macro name.
 5963: @c 
 5964: それで,出力の植字を処理するための,@samp{.xx} roffマクロを書くことが
 5965: 可能になります.@sc{gnu}拡張が利用不可能な場合,これはデフォルト出力で
 5966: す.オプション@option{-M}は,@samp{xx}を他のマクロ名に変更するために使
 5967: 用することが可能です.
 5968: 
 5969: @c In this output format, each non-graphical character, like newline and
 5970: @c tab, is merely changed to exactly one space, with no special attempt to
 5971: @c compress consecutive spaces.  Each quote character: @kbd{"} is doubled
 5972: @c so it will be correctly processed by @command{nroff} or @command{troff}.
 5973: @c 
 5974: この出力形式で,改行やタブのような,表示不可能なそれぞれの文字は,連続
 5975: したスペースを圧縮するという特別な試みを行わず,正確に一つのスペースに
 5976: 単に変換されます.それぞれの引用文字:@kbd{"}は二重になるので,
 5977: @code{nroff}や@code{troff}で正しく処理されます.
 5978: 
 5979: @item -T
 5980: @itemx --format=tex
 5981: 
 5982: @c Choose an output format suitable for @TeX{} processing.  Each output
 5983: @c line will look like:
 5984: @c 
 5985: @TeX{}での処理に適した出力書式を選択します.それぞれの出力行は以下のよ
 5986: うになります.
 5987: 
 5988: @smallexample
 5989: \xx @{@var{tail}@}@{@var{before}@}@{@var{keyword}@}@{@var{after}@}@{@var{head}@}@{@var{ref}@}
 5990: @end smallexample
 5991: 
 5992: @noindent
 5993: @c so it will be possible to write a @code{\xx} definition to take care of
 5994: @c the output typesetting.  Note that when references are not being
 5995: @c produced, that is, neither option @option{-A} nor option @option{-r} is
 5996: @c selected, the last parameter of each @code{\xx} call is inhibited.
 5997: @c Option @option{-M} can be used to change @samp{xx} to another macro
 5998: @c name.
 5999: @c 
 6000: それで,出力の植字の処理するための@code{\xx}定義を書くことが可能になり
 6001: ます.参照が生成されないとき,すなはち,オプション@option{-A}もオプショ
 6002: ン@option{-r}も選択されていないとき,それぞれの@code{\xx}の最後のパラ
 6003: メータが抑制されることに注意してください.オプション@option{-M}は,
 6004: @samp{xx}を他のマクロ名に変更するために利用可能です.
 6005: 
 6006: @c In this output format, some special characters, like @kbd{$}, @kbd{%},
 6007: @c @kbd{&}, @kbd{#} and @kbd{_} are automatically protected with a
 6008: @c backslash.  Curly brackets @kbd{@{}, @kbd{@}} are protected with a
 6009: @c backslash and a pair of dollar signs (to force mathematical mode).  The
 6010: @c backslash itself produces the sequence @code{\backslash@{@}}.
 6011: @c Circumflex and tilde diacritical marks produce the sequence @code{^\@{ @}} and
 6012: @c @code{~\@{ @}} respectively.  Other diacriticized characters of the
 6013: @c underlying character set produce an appropriate @TeX{} sequence as far
 6014: @c as possible.  The other non-graphical characters, like newline and tab,
 6015: @c and all other characters which are not part of @acronym{ASCII}, are merely
 6016: @c changed to exactly one space, with no special attempt to compress
 6017: @c consecutive spaces.  Let me know how to improve this special character
 6018: @c processing for @TeX{}.
 6019: @c 
 6020: この出力書式では,@kbd{$},@kbd{%},@kbd{&},@kbd{#}そして@kbd{_}のよ
 6021: うないくつかの特殊文字は,自動的にバックスラッシュで保護されます.弓カッ
 6022: コの@kbd{@{},@kbd{@}}もバックスラッシュで保護されますが,数学モードを
 6023: 強制するドル記号の組でも囲まれます.バックスラッシュ自身は
 6024: @code{\backslash@{@}}の並びを生成します.曲折アクセント記号とティルデ
 6025: 分音記号は,@code{^\@{ @}}と@code{~\@{ @}}の並びをそれぞれ生成します.
 6026: その他の基礎となる文字セットの分音文字は,適切な@TeX{}の並びを可能な限
 6027: り生成します.改行とタブのようなその他の表示不可能な文字と,
 6028: @acronym{ASCII}ではない全ての他の文字は,連続したスペースを圧縮すると
 6029: いう特別な試みを行わず,一つのスペースに単に変換されます.これらの特殊
 6030: 文字を@TeX{}で処理する改善方法を知らせてください.
 6031: 
 6032: @end table
 6033: 
 6034: 
 6035: @node Compatibility in ptx
 6036: @c @subsection The @sc{gnu} extensions to @command{ptx}
 6037: @subsection @command{ptx}の@sc{gnu}拡張
 6038: 
 6039: @c This version of @command{ptx} contains a few features which do not exist in
 6040: @c System V @command{ptx}.  These extra features are suppressed by using the
 6041: @c @option{-G} command line option, unless overridden by other command line
 6042: @c options.  Some @sc{gnu} extensions cannot be recovered by overriding, so the
 6043: @c simple rule is to avoid @option{-G} if you care about @sc{gnu} extensions.
 6044: @c Here are the differences between this program and System V @command{ptx}.
 6045: @c 
 6046: この@command{ptx}のバージョンには,System V @command{ptx}には存在しな
 6047: いいくつかの特徴があります.これらの拡張された特徴は,他のコマンドライ
 6048: ンオプションで優先されない場合,@option{-G}コマンドラインオプションを
 6049: 使用して抑制されます.@sc{gnu}拡張には,優先で元に戻すことができないも
 6050: のがあり,そのため,@sc{gnu}拡張を気にする場合,簡単な規則で
 6051: @option{-G}を避けるはずです.ここに,このプログラムとSystem V
 6052: @command{ptx}の間の違いがあります.
 6053: 
 6054: @itemize @bullet
 6055: 
 6056: @item
 6057: @c This program can read many input files at once, it always writes the
 6058: @c resulting concordance on standard output.  On the other hand, System V
 6059: @c @command{ptx} reads only one file and sends the result to standard output
 6060: @c or, if a second @var{file} parameter is given on the command, to that
 6061: @c @var{file}.
 6062: @c 
 6063: このプログラムは,一度に多くの入力ファイルを読むことが可能で,それは常
 6064: に,用語索引の結果を標準出力に書き出します.一方,System V
 6065: @command{ptx}は,一つのみファイルを読み込み,結果を標準出力に書き出す
 6066: か,二番目の@var{file}パラメータがコマンドで与えられている場合は,その
 6067: @var{file}に書き出します.
 6068: 
 6069: @c Having output parameters not introduced by options is a dangerous
 6070: @c practice which @sc{gnu} avoids as far as possible.  So, for using @command{ptx}
 6071: @c portably between @sc{gnu} and System V, you should always use it with a
 6072: @c single input file, and always expect the result on standard output.  You
 6073: @c might also want to automatically configure in a @option{-G} option to
 6074: @c @command{ptx} calls in products using @command{ptx}, if the configurator finds
 6075: @c that the installed @command{ptx} accepts @option{-G}.
 6076: @c 
 6077: オプションで導入されない出力パラメータがあると,@sc{gnu}ができる限り避
 6078: けようとしている危険な操作になります.そのため,@sc{gnu}とSystem Vの間
 6079: の移植性のある@command{ptx}を使用するため,単一の入力ファイルで常に使
 6080: 用することに注意を払い,常に標準出力で結果を期待するべきです.配置する
 6081: ものが@option{-G}を受け入れる@command{ptx}がインストールされていること
 6082: が分かった場合,@command{ptx}を使用した製品での@command{ptx}の呼び出し
 6083: で,@option{-G}オプションを自動的に配置したいと思うかもしれません.
 6084: 
 6085: @item
 6086: @c The only options available in System V @command{ptx} are options @option{-b},
 6087: @c @option{-f}, @option{-g}, @option{-i}, @option{-o}, @option{-r}, @option{-t} and
 6088: @c @option{-w}.  All other options are @sc{gnu} extensions and are not repeated in
 6089: @c this enumeration.  Moreover, some options have a slightly different
 6090: @c meaning when @sc{gnu} extensions are enabled, as explained below.
 6091: @c 
 6092: System V @command{ptx}でのみ利用可能なオプションは,@option{-b},
 6093: @option{-f},@option{-g},@option{-i},@option{-o},@option{-r},
 6094: @option{-t},そして@option{-w}です.全ての他のオプションは@sc{gnu}拡張
 6095: で,この列挙では繰り返しません.さらに,@sc{gnu}拡張が利用可能なとき,
 6096: わずかに意味が異なるオプションもあり,それは以下で記述します.
 6097: 
 6098: @item
 6099: @c By default, concordance output is not formatted for @command{troff} or
 6100: @c @command{nroff}.  It is rather formatted for a dumb terminal.  @command{troff}
 6101: @c or @command{nroff} output may still be selected through option @option{-O}.
 6102: @c 
 6103: デフォルトで,用語索引出力は@code{troff}や@code{nroff}に対して書式化さ
 6104: れません.それはむしろ,dumb端末に対する出力です.@code{troff}や
 6105: @code{nroff}への出力は,オプション@option{-O}を通じて選択してもかまい
 6106: ません.
 6107: 
 6108: @item
 6109: @c Unless @option{-R} option is used, the maximum reference width is
 6110: @c subtracted from the total output line width.  With @sc{gnu} extensions
 6111: @c disabled, width of references is not taken into account in the output
 6112: @c line width computations.
 6113: @c 
 6114: @option{-R}オプションが選択されない場合,最大の参照幅は出力行幅全体か
 6115: ら引いたものになります.@sc{gnu}拡張が利用不可能な場合,参照の幅は出力
 6116: 行の幅の計算で考慮されません.
 6117: 
 6118: @item
 6119: @c All 256 characters, even @kbd{NUL}s, are always read and processed from
 6120: @c input file with no adverse effect, even if @sc{gnu} extensions are disabled.
 6121: @c However, System V @command{ptx} does not accept 8-bit characters, a few
 6122: @c control characters are rejected, and the tilde @kbd{~} is also rejected.
 6123: @c 
 6124: @kbd{NUL}を含む256文字全ては,たとえ@sc{gnu}拡張が利用不可能な場合でも,
 6125: 常に入力ファイルから読み込まれ,問題となる影響もなく処理されます.しか
 6126: し,System V @command{ptx}は8ビット文字を受け入れず,いくつかの制御文
 6127: 字は削除され,チルダ@kbd{~}は処分されます.
 6128: 
 6129: @item
 6130: @c Input line length is only limited by available memory, even if @sc{gnu}
 6131: @c extensions are disabled.  However, System V @command{ptx} processes only
 6132: @c the first 200 characters in each line.
 6133: @c 
 6134: 入力行の長さは,@sc{gnu}拡張が利用できない場合でさえ,利用可能なメモリ
 6135: でのみ制限されます.しかしSystem V @command{ptx}は,それぞれの行の最初
 6136: の200文字のみ処理します.
 6137: 
 6138: @item
 6139: @c The break (non-word) characters default to be every character except all
 6140: @c letters of the underlying character set, diacriticized or not.  When @sc{gnu}
 6141: @c extensions are disabled, the break characters default to space, tab and
 6142: @c newline only.
 6143: @c 
 6144: ブレーク(単語ではない)文字は,全ての基礎となる文字セット以外,分音記号
 6145: の有無によらず,全ての文字をデフォルトとします.@sc{gnu}拡張が利用不可
 6146: 能なとき,ブレーク文字は,スペース,タブと改行のみをデフォルトとします.
 6147: 
 6148: @item
 6149: @c The program makes better use of output line width.  If @sc{gnu} extensions
 6150: @c are disabled, the program rather tries to imitate System V @command{ptx},
 6151: @c but still, there are some slight disposition glitches this program does
 6152: @c not completely reproduce.
 6153: @c 
 6154: プログラムは,出力行の幅でより良いものを使用します.@sc{gnu}拡張が利用
 6155: 不可能な場合,プログラムは,代わりにSystem V @command{ptx}を模倣しよう
 6156: としますが,このプログラムが完全に再現していない,わずかな配置不備もま
 6157: だあります.
 6158: 
 6159: @item
 6160: @c The user can specify both an Ignore file and an Only file.  This is not
 6161: @c allowed with System V @command{ptx}.
 6162: @c 
 6163: ユーザは,IgnoreファイルとOnlyファイルの両方を指定できます.これは,
 6164: System V @command{ptx}では許可されません.
 6165: 
 6166: @end itemize
 6167: 
 6168: 
 6169: @node Operating on fields within a line
 6170: @c @chapter Operating on fields within a line
 6171: @chapter 行のフィールドの処理
 6172: 
 6173: @menu
 6174: * cut invocation::              Print selected parts of lines.
 6175: * paste invocation::            Merge lines of files.
 6176: * join invocation::             Join lines on a common field.
 6177: @end menu
 6178: 
 6179: 
 6180: @node cut invocation
 6181: @c @section @command{cut}: Print selected parts of lines
 6182: @section @command{cut}: 行の選択した部分の出力
 6183: 
 6184: @pindex cut
 6185: @c @command{cut} writes to standard output selected parts of each line of each
 6186: @c input file, or standard input if no files are given or for a file name of
 6187: @c @samp{-}.  Synopsis:
 6188: @c 
 6189: @command{cut}は,それぞれの入力ファイルや,ファイルが与えられない場合
 6190: や@samp{-}のファイル名に対しては標準入力の,それぞれの行の選択された部
 6191: 分を標準出力に書き出します.概要です.
 6192: 
 6193: @example
 6194: cut [@var{option}]@dots{} [@var{file}]@dots{}
 6195: @end example
 6196: 
 6197: @c In the table which follows, the @var{byte-list}, @var{character-list},
 6198: @c and @var{field-list} are one or more numbers or ranges (two numbers
 6199: @c separated by a dash) separated by commas.  Bytes, characters, and
 6200: @c fields are numbered starting at 1.  Incomplete ranges may be
 6201: @c given: @option{-@var{m}} means @samp{1-@var{m}}; @samp{@var{n}-} means
 6202: @c @samp{@var{n}} through end of line or last field.  The list elements
 6203: @c can be repeated, can overlap, and can be specified in any order; but
 6204: @c the selected input is written in the same order that it is read, and
 6205: @c is written exactly once.
 6206: @c 
 6207: 以下の表で,@var{byte-list},@var{character-list},そして
 6208: @var{field-list}は,一つ以上の数字またはカンマで分けられた(ダッシュで
 6209: 分けられた二つの数字の)範囲です.バイト,文字,そしてフィールドは,1で
 6210: 始まる番号がつきます.不完全な範囲を与えることができます.
 6211: @samp{-@var{m}}は@samp{1-@var{m}}を意味します.@samp{@var{n}-}は,
 6212: @samp{@var{n}}から行末やフィールドの終りまでを意味します.
 6213: 
 6214: @c The program accepts the following options.  Also see @ref{Common
 6215: @c options}.
 6216: @c 
 6217: このプログラムは以下のオプションも受け入れます.@ref{Common options}も
 6218: 参照してください.
 6219: 
 6220: @table @samp
 6221: 
 6222: @item -b @var{byte-list}
 6223: @itemx --bytes=@var{byte-list}
 6224: @opindex -b
 6225: @opindex --bytes
 6226: @c Print only the bytes in positions listed in @var{byte-list}.  Tabs and
 6227: @c backspaces are treated like any other character; they take up 1 byte.
 6228: @c If an output delimiter is specified, (see the description of
 6229: @c @option{--output-delimiter}), then output that string between
 6230: @c ranges of selected bytes.
 6231: @c 
 6232: @var{byte-list}でリストアップされた位置にあるバイトのみを出力します.
 6233: タブとバックスペースは他の文字と同様に扱われます.それらは1バイト使用
 6234: します.出力の分離文字が指定されている場合(@option{--output-delimiter} 
 6235: を参照して下さい),選択したバイトの範囲の間の文字列を出力します.
 6236: 
 6237: @item -c @var{character-list}
 6238: @itemx --characters=@var{character-list}
 6239: @opindex -c
 6240: @opindex --characters
 6241: @c Print only characters in positions listed in @var{character-list}.
 6242: @c The same as @option{-b} for now, but internationalization will change
 6243: @c that.  Tabs and backspaces are treated like any other character; they
 6244: @c take up 1 character.
 6245: @c If an output delimiter is specified, (see the description of
 6246: @c @option{--output-delimiter}), then output that string between
 6247: @c ranges of selected bytes.
 6248: @c 
 6249: @var{character-list}にリストアップされている位置にある文字のみを出力し
 6250: ます.現在は@option{-b}と同じですが,国際化でそれが変更される可能性が
 6251: あります.タブとバックスペースは他の文字と同様に扱われます.それらは1 
 6252: バイト使用します.出力の分離文字が指定されている場合
 6253: (@option{--output-delimiter} を参照して下さい),選択したバイトの範囲の
 6254: 間の文字列を出力します.
 6255: 
 6256: 
 6257: @item -f @var{field-list}
 6258: @itemx --fields=@var{field-list}
 6259: @opindex -f
 6260: @opindex --fields
 6261: @c Print only the fields listed in @var{field-list}.  Fields are
 6262: @c separated by a TAB character by default.
 6263: @c Also print any line that contains no delimiter character, unless
 6264: @c the @option{--only-delimited} (@option{-s}) option is specified
 6265: @c 
 6266: @var{field-list}にリストアップされたフィールドのみを出力します.デフォ
 6267: ルトで,フィールドはTAB文字で分けられています.
 6268: @option{--only-delimited} (@option{-s})オプションが指定されない限り,
 6269: デリミタ文字の無い行も出力されます.
 6270: 
 6271: @item -d @var{input_delim_byte}
 6272: @itemx --delimiter=@var{input_delim_byte}
 6273: @opindex -d
 6274: @opindex --delimiter
 6275: @c For @option{-f}, fields are separated in the input by the first character
 6276: @c in @var{input_delim_byte} (default is TAB).
 6277: @c 
 6278: @option{-f}に対し,フィールドは,@var{input_delim_byte}の最初の文字に
 6279: よって,入力を分離したものになります.(デフォルトはTABです).
 6280: 
 6281: @item -n
 6282: @opindex -n
 6283: @c Do not split multi-byte characters (no-op for now).
 6284: @c 
 6285: マルチバイトの文字を分けません(現在何もしません).
 6286: 
 6287: @item -s
 6288: @itemx --only-delimited
 6289: @opindex -s
 6290: @opindex --only-delimited
 6291: @c For @option{-f}, do not print lines that do not contain the field separator
 6292: @c character.  Normally, any line without a field separator is printed verbatim.
 6293: @c 
 6294: @option{-f}に対し,フィールド分離文字を含まない列を出力しません.通常,
 6295: フィールド分離文字が無い行は,そのまま出力されます.
 6296: 
 6297: @itemx --output-delimiter=@var{output_delim_string}
 6298: @opindex --output-delimiter
 6299: @c With @option{-f}, output fields are separated by @var{output_delim_string}.
 6300: @c The default with @option{-f} is to use the input delimiter.
 6301: @c When using @option{-b} or @option{-c} to select ranges of byte or
 6302: @c character offsets (as opposed to ranges of fields),
 6303: @c output @var{output_delim_string} between ranges of selected bytes.
 6304: @c 
 6305: @option{-f}に対し,出力フィールドは,@var{output_delim_string}で分けら
 6306: れます.デフォルトは入力の分離文字を使用します.バイトや文字のオフセッ
 6307: トの範囲を選択するために@option{-b}や@option{-c}を使用しているとき,選
 6308: 択したバイト数の範囲の間に@var{output_delim_string}を出力します.
 6309: 
 6310: @end table
 6311: 
 6312: 
 6313: @node paste invocation
 6314: @c @section @command{paste}: Merge lines of files
 6315: @section @command{paste}: ファイルの行を統合します
 6316: 
 6317: @pindex paste
 6318: @cindex merging files
 6319: 
 6320: @c @command{paste} writes to standard output lines consisting of sequentially
 6321: @c corresponding lines of each given file, separated by a TAB character.
 6322: @c Standard input is used for a file name of @samp{-} or if no input files
 6323: @c are given.
 6324: @c 
 6325: @command{paste}は,与えられたそれぞれのファイルの,順番的に対応してい
 6326: る行を,TAB文字で分離しながら標準出力に書き出します.@samp{-}のファイ
 6327: ル名に対して,または入力ファイルが与えられない場合,標準入力が使用され
 6328: ます.
 6329: 
 6330: @c For example:
 6331: @c 
 6332: 例えば以下のようになります.
 6333: 
 6334: @example
 6335: $ cat num2
 6336: 1
 6337: 2
 6338: $ cat let3
 6339: a
 6340: b
 6341: c
 6342: $ paste num2 let3
 6343: 1       a
 6344: 2       b
 6345:         c
 6346: @end example
 6347: 
 6348: @c Synopsis:
 6349: @c 
 6350: 概要です.
 6351: 
 6352: @example
 6353: paste [@var{option}]@dots{} [@var{file}]@dots{}
 6354: @end example
 6355: 
 6356: @c The program accepts the following options.  Also see @ref{Common options}.
 6357: @c 
 6358: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 6359: してください.
 6360: 
 6361: @table @samp
 6362: 
 6363: @item -s
 6364: @itemx --serial
 6365: @opindex -s
 6366: @opindex --serial
 6367: @c Paste the lines of one file at a time rather than one line from each
 6368: @c file.  Using the above example data:
 6369: @c 
 6370: それぞれのファイルから一行ではなく,一度に一つのファイルの行をペースト
 6371: します.
 6372: 
 6373: @example
 6374: $ paste -s num2 let3
 6375: 1       2
 6376: a       b       c
 6377: @end example
 6378: 
 6379: @item -d @var{delim-list}
 6380: @itemx --delimiters=@var{delim-list}
 6381: @opindex -d
 6382: @opindex --delimiters
 6383: @c Consecutively use the characters in @var{delim-list} instead of
 6384: @c TAB to separate merged lines.  When @var{delim-list} is
 6385: @c exhausted, start again at its beginning.  Using the above example data:
 6386: @c 
 6387: 統合される行の分離文字TABの代わりに,@var{delim-list}の文字を順番に使
 6388: 用します.@var{delim-list}が使い尽くされたとき,最初から再び開始します.
 6389: 
 6390: @example
 6391: $ paste -d '%_' num2 let3 num2
 6392: 1%a_1
 6393: 2%b_2
 6394: %c_
 6395: @end example
 6396: 
 6397: @end table
 6398: 
 6399: 
 6400: @node join invocation
 6401: @c @section @command{join}: Join lines on a common field
 6402: @section @command{join}: 共通のフィールドで行を結合
 6403: 
 6404: @pindex join
 6405: @cindex common field, joining on
 6406: 
 6407: @c @command{join} writes to standard output a line for each pair of input
 6408: @c lines that have identical join fields.  Synopsis:
 6409: @c 
 6410: @command{join}は,同一の結合フィールドを持つそれぞれの入力行の組に対し,
 6411: 一行を標準出力に書き出します.概要です.
 6412: 
 6413: @example
 6414: join [@var{option}]@dots{} @var{file1} @var{file2}
 6415: @end example
 6416: 
 6417: @vindex LC_COLLATE
 6418: @c Either @var{file1} or @var{file2} (but not both) can be @samp{-},
 6419: @c meaning standard input.  @var{file1} and @var{file2} should be
 6420: @c sorted on the join fields.
 6421: @c 
 6422: @var{file1}または@var{file2}は(両方ではなく)@samp{-}が可能で,標準入力
 6423: を意味します.@var{file1}と@var{file2}は,結合フィールド上で並べ替えし
 6424: ておくべきです.
 6425: 
 6426: @c Normally, the sort order is that of the
 6427: @c collating sequence specified by the @env{LC_COLLATE} locale.  Unless
 6428: @c the @option{-t} option is given, the sort comparison ignores blanks at
 6429: @c the start of the join field, as in @code{sort -b}.  If the
 6430: @c @option{--ignore-case} option is given, the sort comparison ignores
 6431: @c the case of characters in the join field, as in @code{sort -f}.
 6432: @c 
 6433: 通常,並べ替えの順序は,@env{LC_COLLATE}ロケールで指定されている順番で
 6434: す.@option{-t}オプションが与えられない限り,@code{sort -b}のように,
 6435: 並べ替えの比較では結合フィールドの最初の空白は無視されます.
 6436: @option{--ignore-case}オプションが与えられている場合,@code{sort -f}の
 6437: ように,並べ替えの比較では結合フィールドの文字の大文字小文字は無視され
 6438: ます.
 6439: 
 6440: @c However, as a GNU extension, if the input has no unpairable lines the
 6441: @c sort order can be any order that considers two fields to be equal if and
 6442: @c only if the sort comparison described above considers them to be equal.
 6443: @c For example:
 6444: @c 
 6445: しかし,@sc{gnu}の拡張として,入力に組になる行が無い場合,並び順は,上
 6446: 記の並び替えの比較が同じであると考えられる場合,そしてそのときだけ,二
 6447: つのフィールドが同じであると考えられる順番になるはずです.例えば,以下
 6448: のようになります.
 6449: 
 6450: @example
 6451: $ cat file1
 6452: a a1
 6453: c c1
 6454: b b1
 6455: $ cat file2
 6456: a a2
 6457: c c2
 6458: b b2
 6459: $ join file1 file2
 6460: a a1 a2
 6461: c c1 c2
 6462: b b1 b2
 6463: @end example
 6464: 
 6465: @c The defaults are: the join field is the first field in each line;
 6466: @c fields in the input are separated by one or more blanks, with leading
 6467: @c blanks on the line ignored; fields in the output are separated by a
 6468: @c space; each output line consists of the join field, the remaining
 6469: @c fields from @var{file1}, then the remaining fields from @var{file2}.
 6470: @c 
 6471: デフォルトは,以下の通りです.結合フィールドは,それぞれの行の最初の
 6472: フィールドです.入力のフィールドは,一つ以上の空白で分離されていて,行
 6473: の前の空白は無視されます.出力のフィールドはスペースで分離されています.
 6474: それぞれの出力行は,結合フィールド,@var{file1}の残りのフィールド,そ
 6475: して@var{file2}の残りのフィールドから成り立ちます.
 6476: 
 6477: @c The program accepts the following options.  Also see @ref{Common options}.
 6478: @c 
 6479: プログラムは,以下のオプションを受け入れます.@ref{Common options}も参
 6480: 照してください.
 6481: 
 6482: @table @samp
 6483: 
 6484: @item -a @var{file-number}
 6485: @opindex -a
 6486: @c Print a line for each unpairable line in file @var{file-number} (either
 6487: @c @samp{1} or @samp{2}), in addition to the normal output.
 6488: @c 
 6489: ファイル@var{file-number} (@samp{1}または@samp{2}のいずれか)で組になっ
 6490: ていないそれぞれの行に対し,一行を通常の出力に追加して出力します.
 6491: 
 6492: @item -e @var{string}
 6493: @opindex -e
 6494: @c Replace those output fields that are missing in the input with
 6495: @c @var{string}.
 6496: @c 
 6497: 入力で欠けているこれらの出力フィールドを,@var{string}で置換します.
 6498: 
 6499: @item -i
 6500: @itemx --ignore-case
 6501: @opindex -i
 6502: @opindex --ignore-case
 6503: @c Ignore differences in case when comparing keys.
 6504: @c With this option, the lines of the input files must be ordered in the same way.
 6505: @c Use @samp{sort -f} to produce this ordering.
 6506: @c 
 6507: キーを比較するとき,大文字小文字の違いを無視します.このオプションを用
 6508: いると,入力ファイルの行は同じ方法でソートされている必要があります.こ
 6509: の順序を生成するために,@samp{sort -f}を使用してください.
 6510: 
 6511: @item -1 @var{field}
 6512: @itemx -j1 @var{field}
 6513: @opindex -1
 6514: @opindex -j1
 6515: @c Join on field @var{field} (a positive integer) of file 1.
 6516: @c 
 6517: ファイル1のフィールド@var{field}(正の整数)で結合します.
 6518: 
 6519: @item -2 @var{field}
 6520: @itemx -j2 @var{field}
 6521: @opindex -2
 6522: @opindex -j2
 6523: @c Join on field @var{field} (a positive integer) of file 2.
 6524: @c 
 6525: ファイル2のフィールド@var{field} (正の整数)で結合します.
 6526: 
 6527: @item -j @var{field}
 6528: @c Equivalent to @option{-1 @var{field} -2 @var{field}}.
 6529: @c 
 6530: @samp{-1 @var{field} -2 @var{field}}と同じです.
 6531: 
 6532: @item -o @var{field-list}@dots{}
 6533: @c Construct each output line according to the format in @var{field-list}.
 6534: @c Each element in @var{field-list} is either the single character @samp{0} or
 6535: @c has the form @var{m.n} where the file number, @var{m}, is @samp{1} or
 6536: @c @samp{2} and @var{n} is a positive field number.
 6537: @c 
 6538: @var{field-list}の書式に従い,それぞれの出力行を生成します.
 6539: @var{field-list}のそれぞれの要素は,単一文字@samp{0},または,ファイル
 6540: 番号の@var{m},@samp{1}または@samp{2},そして@var{n}が正のフィールド番
 6541: 号となっている,@var{m.n}の形式になります.
 6542: 
 6543: @c A field specification of @samp{0} denotes the join field.
 6544: @c In most cases, the functionality of the @samp{0} field spec
 6545: @c may be reproduced using the explicit @var{m.n} that corresponds
 6546: @c to the join field.  However, when printing unpairable lines
 6547: @c (using either of the @option{-a} or @option{-v} options), there is no way
 6548: @c to specify the join field using @var{m.n} in @var{field-list}
 6549: @c if there are unpairable lines in both files.
 6550: @c To give @command{join} that functionality, @acronym{POSIX} invented the @samp{0}
 6551: @c field specification notation.
 6552: @c 
 6553: @samp{0}のフィールド指定は,結合フィールドを示します.ほとんどの場合,
 6554: @samp{0}フィールドの指定の機能は,対応する結合フィールドとなる,明示的
 6555: な@var{m.n}を用いて再現できます.しかし,(@option{-a}または@option{-v}
 6556: オプションを用いて)組にならない行を出力するとき,両方のファイルで組に
 6557: ならない行がある場合,@var{field-list}で@var{m.n}を用いて結合フィール
 6558: ドを指定する方法はありません.@command{join}にその機能を与えるため,
 6559: @acronym{POSIX}は@samp{0}フィールド指定の表記を考え出しました.
 6560: 
 6561: @c The elements in @var{field-list}
 6562: @c are separated by commas or blanks.  Multiple @var{field-list}
 6563: @c arguments can be given after a single @option{-o} option; the values
 6564: @c of all lists given with @option{-o} are concatenated together.
 6565: @c All output lines -- including those printed because of any -a or -v
 6566: @c option -- are subject to the specified @var{field-list}.
 6567: @c 
 6568: @var{field-list}の要素は,カンマまたは空白で分けられています.複数の
 6569: @var{field-list}引数を,単一の@option{-o}オプションの後に与えることが
 6570: 可能です.@option{-o}で与えられる全てのリストの値は,一緒に連結されま
 6571: す.全ての出力行は -- @option{-a}や@option{-v}オプションで出力されるも
 6572: のを含め -- 指定された@var{field-list}が適用されます.
 6573: 
 6574: @item -t @var{char}
 6575: @c Use character @var{char} as the input and output field separator.
 6576: @c 
 6577: 文字@var{char}を入出力のフィールドセパレータとして使用します.
 6578: 
 6579: @item -v @var{file-number}
 6580: @c Print a line for each unpairable line in file @var{file-number}
 6581: @c (either @samp{1} or @samp{2}), instead of the normal output.
 6582: @c 
 6583: 通常の出力の代わりに,ファイル@var{file-number} (@samp{1}または
 6584: @samp{2})の組にならないそれぞれの行に対し,一行を出力します.
 6585: 
 6586: @end table
 6587: 
 6588: @c In addition, when @sc{gnu} @command{join} is invoked with exactly one argument,
 6589: @c the @option{--help} and @option{--version} options are recognized.
 6590: @c @xref{Common options}.
 6591: @c 
 6592: 更に,@sc{gnu} @command{join}は,単一の引数で呼び出されたとき,オプショ
 6593: ン@option{--help}と@option{--version}は認識されます.@xref{Common
 6594: options}.
 6595: 
 6596: 
 6597: @node Operating on characters
 6598: @c @chapter Operating on characters
 6599: @chapter 文字の処理
 6600: 
 6601: @cindex operating on characters
 6602: 
 6603: @c This commands operate on individual characters.
 6604: @c 
 6605: このコマンドは,個別に文字を処理します.
 6606: 
 6607: @menu
 6608: * tr invocation::               Translate, squeeze, and/or delete characters.
 6609: * expand invocation::           Convert tabs to spaces.
 6610: * unexpand invocation::         Convert spaces to tabs.
 6611: @end menu
 6612: 
 6613: 
 6614: @node tr invocation
 6615: @c @section @command{tr}: Translate, squeeze, and/or delete characters
 6616: @section @command{tr}: 文字の変換,圧縮,そして/または,削除
 6617: 
 6618: @pindex tr
 6619: 
 6620: @c Synopsis:
 6621: @c 
 6622: 概要です.
 6623: 
 6624: @example
 6625: tr [@var{option}]@dots{} @var{set1} [@var{set2}]
 6626: @end example
 6627: 
 6628: @c @command{tr} copies standard input to standard output, performing
 6629: @c one of the following operations:
 6630: @c 
 6631: @command{tr}は標準入力を標準出力にコピーし,そのとき以下の処理の一つを
 6632: 実行します.
 6633: 
 6634: @itemize @bullet
 6635: @item
 6636: @c translate, and optionally squeeze repeated characters in the result,
 6637: @c 
 6638: 変換,さらに結果の繰り返し文字の圧縮.
 6639: @item
 6640: @c squeeze repeated characters,
 6641: @c 
 6642: 繰り返し文字の圧縮.
 6643: @item
 6644: @c delete characters,
 6645: @c 
 6646: 文字の削除.
 6647: @item
 6648: @c delete characters, then squeeze repeated characters from the result.
 6649: @c 
 6650: 文字の削除後,結果から繰り返し文字の圧縮.
 6651: @end itemize
 6652: 
 6653: @c The @var{set1} and (if given) @var{set2} arguments define ordered
 6654: @c sets of characters, referred to below as @var{set1} and @var{set2}.  These
 6655: @c sets are the characters of the input that @command{tr} operates on.
 6656: @c The @option{--complement} (@option{-c}) option replaces @var{set1} with its
 6657: @c complement (all of the characters that are not in @var{set1}).
 6658: @c 
 6659: @var{set1}と(与えられている場合)@var{set2}引数は,順番付けされた文字を
 6660: 定義し,以下の@var{set1}と@var{set2}を参照します.これらの組は,
 6661: @command{tr}が処理する入力文字です.@option{--complement}
 6662: (@option{-c})オプションは,@var{set1}をその補集合(@var{set1}に無い全て
 6663: の文字)に置換します.
 6664: 
 6665: @menu
 6666: * Character sets::              Specifying sets of characters.
 6667: * Translating::                 Changing one characters to another.
 6668: * Squeezing::                   Squeezing repeats and deleting.
 6669: * Warnings in tr::              Warning messages.
 6670: @end menu
 6671: 
 6672: 
 6673: @node Character sets
 6674: @c @subsection Specifying sets of characters
 6675: @subsection 文字の組の指定
 6676: 
 6677: @cindex specifying sets of characters
 6678: 
 6679: @c The format of the @var{set1} and @var{set2} arguments resembles
 6680: @c the format of regular expressions; however, they are not regular
 6681: @c expressions, only lists of characters.  Most characters simply
 6682: @c represent themselves in these strings, but the strings can contain
 6683: @c the shorthands listed below, for convenience.  Some of them can be
 6684: @c used only in @var{set1} or @var{set2}, as noted below.
 6685: @c 
 6686: @var{set1}と@var{set2}の引数の書式は,正規表現の書式に似ています.しか
 6687: し正規表現ではなく,文字のリストのみです.これらの文字列のほとんどの文
 6688: 字は単にその文字自身を表しますが,利便性のため,文字列には以下でリスト
 6689: アップされた速記を含むことができます.そのうち,以下で注意する
 6690: @var{set1}または@var{set2}のみでしか利用できないものもあります.
 6691: 
 6692: @table @asis
 6693: 
 6694: @item Backslash escapes
 6695: @cindex backslash escapes
 6696: 
 6697: @c A backslash followed by a character not listed below causes an error
 6698: @c message.
 6699: @c 
 6700: 以下でリストアップされていない,文字が続くバックスラッシュは,エラーメッ
 6701: セージを発生します.
 6702: 
 6703: @table @samp
 6704: @item \a
 6705: Control-G.
 6706: @item \b
 6707: Control-H.
 6708: @item \f
 6709: Control-L.
 6710: @item \n
 6711: Control-J.
 6712: @item \r
 6713: Control-M.
 6714: @item \t
 6715: Control-I.
 6716: @item \v
 6717: Control-K.
 6718: @item \@var{ooo}
 6719: @c The character with the value given by @var{ooo}, which is 1 to 3
 6720: @c octal digits,
 6721: @c 
 6722: @var{ooo}で与えられる値の文字で,一桁から三桁までの八進数.
 6723: @item \\
 6724: @c A backslash.
 6725: @c 
 6726: バックスラッシュ.
 6727: @end table
 6728: 
 6729: @c @item Ranges
 6730: @item 範囲
 6731: @cindex ranges
 6732: 
 6733: @c The notation @samp{@var{m}-@var{n}} expands to all of the characters
 6734: @c from @var{m} through @var{n}, in ascending order.  @var{m} should
 6735: @c collate before @var{n}; if it doesn't, an error results.  As an example,
 6736: @c @samp{0-9} is the same as @samp{0123456789}.
 6737: @c 
 6738: 表記方法の@samp{@var{m}-@var{n}}は,@var{m}から@var{n}まで昇順に,全て
 6739: の文字に展開されます.@var{m}は,対照で@var{n}の前であるべきです.そう
 6740: でない場合,結果としてエラーとなります.例としては,@samp{0-9}は
 6741: @samp{0123456789}と同じです.
 6742: 
 6743: @c @sc{gnu} @command{tr} does not support the System V syntax that uses square
 6744: @c brackets to enclose ranges.  Translations specified in that format
 6745: @c sometimes work as expected, since the brackets are often transliterated
 6746: @c to themselves.  However, they should be avoided because they sometimes
 6747: @c behave unexpectedly.  For example, @samp{tr -d '[0-9]'} deletes brackets
 6748: @c as well as digits.
 6749: @c 
 6750: @sc{gnu} @command{tr}は,範囲を囲む角括弧を使用するSystem V構文をサポー
 6751: トしません.その書式で指定された変換は,括弧はそれ自身に変換されるので,
 6752: 期待したように動作します.しかし,期待しない動作を行なうときもあるので
 6753: 避けるべきです.例えば,@samp{tr -d '[0-9]'}は数字だけでなく括弧も削除
 6754: します.
 6755: 
 6756: @c Many historically common and even accepted uses of ranges are not
 6757: @c portable.  For example, on @acronym{EBCDIC} hosts using the @samp{A-Z}
 6758: @c range will not do what most would expect because @samp{A} through @samp{Z}
 6759: @c are not contiguous as they are in @acronym{ASCII}.
 6760: @c If you can rely on a @acronym{POSIX} compliant version of @command{tr}, then
 6761: @c the best way to work around this is to use character classes (see below).
 6762: @c Otherwise, it is most portable (and most ugly) to enumerate the members
 6763: @c of the ranges.
 6764: @c 
 6765: 多くの歴史的に一般的なものと,範囲の使用の受け入れには移植性がありませ
 6766: ん.例えば,@acronym{EBCDIC}のホストでは,@samp{A-Z}の範囲を使用すると,
 6767: @acronym{ASCII}では@samp{A}から@samp{Z}までが不連続なので期待したよう
 6768: に動作しません.@acronym{POSIX}に準拠しているバージョンの@command{tr} 
 6769: に依存している場合,これを回避する最善の方法は,文字クラスを使用するこ
 6770: とです(以下を参照して下さい).それ以外では,範囲内のメンバーを列挙する
 6771: ことが最も移植性がある(そして最も醜い)方法です.
 6772: 
 6773: @c @item Repeated characters
 6774: @item 繰り返される文字
 6775: @cindex repeated characters
 6776: 
 6777: @c The notation @samp{[@var{c}*@var{n}]} in @var{set2} expands to @var{n}
 6778: @c copies of character @var{c}.  Thus, @samp{[y*6]} is the same as
 6779: @c @samp{yyyyyy}.  The notation @samp{[@var{c}*]} in @var{string2} expands
 6780: @c to as many copies of @var{c} as are needed to make @var{set2} as long as
 6781: @c @var{set1}.  If @var{n} begins with @samp{0}, it is interpreted in
 6782: @c octal, otherwise in decimal.
 6783: @c 
 6784: @var{set2}での@samp{[@var{c}*@var{n}]}の表記は,文字@var{c}の@var{n}個
 6785: のコピーに展開されます.このため,@samp{[y*6]}は@samp{yyyyyy}と同じで
 6786: す.@var{set2}での@samp{[@var{c}*]}の表記は,@var{set2}を@var{set1}と
 6787: 同じ長さにするのに必要なたくさんの@var{c}のコピーに展開されます.
 6788: @var{n}が@samp{0}で始まる場合は八進数に,それ以外では十進数だと解釈さ
 6789: れます.
 6790: 
 6791: @c @item Character classes
 6792: @item 文字クラス
 6793: @cindex character classes
 6794: 
 6795: @c The notation @samp{[:@var{class}:]} expands to all of the characters in
 6796: @c the (predefined) class @var{class}.  The characters expand in no
 6797: @c particular order, except for the @code{upper} and @code{lower} classes,
 6798: @c which expand in ascending order.  When the @option{--delete} (@option{-d})
 6799: @c and @option{--squeeze-repeats} (@option{-s}) options are both given, any
 6800: @c character class can be used in @var{set2}.  Otherwise, only the
 6801: @c character classes @code{lower} and @code{upper} are accepted in
 6802: @c @var{set2}, and then only if the corresponding character class
 6803: @c (@code{upper} and @code{lower}, respectively) is specified in the same
 6804: @c relative position in @var{set1}.  Doing this specifies case conversion.
 6805: @c The class names are given below; an error results when an invalid class
 6806: @c name is given.
 6807: @c 
 6808: @samp{[:@var{class}:]}の表記は,(あらかじめ定義された)クラス
 6809: @var{class} にある全ての文字に展開されます.文字は,特定の順序で展開さ
 6810: れませんが,@code{upper}と@code{lower}クラスは,昇順に展開されます.
 6811: @option{--delete} (@option{-d})と@option{--squeeze-repeats}
 6812: (@option{-s})オプションが両方与えられている場合,すべての文字クラスを
 6813: @var{set2}で使用することが可能です.それ以外の場合,文字クラス
 6814: @code{lower}と@code{upper}は@var{set2}に適用され,さらに,対応する(そ
 6815: れぞれ@code{upper}と@code{lower}の)文字クラスが@var{set1}の位置に相対
 6816: 的に同じものが指定されている場合だけそうなります.これは,大文字小文字
 6817: の変換の指定です.クラス名は以下で与えられます.無効なクラス名が与えら
 6818: れた場合,結果としてエラーとなります.
 6819: 
 6820: @table @code
 6821: @item alnum
 6822: @opindex alnum
 6823: @c Letters and digits.
 6824: @c 
 6825: 文字と数字.
 6826: @item alpha
 6827: @opindex alpha
 6828: @c Letters.
 6829: @c 
 6830: 文字.
 6831: @item blank
 6832: @opindex blank
 6833: @c Horizontal whitespace.
 6834: @c 
 6835: 水平方向の空白.
 6836: @item cntrl
 6837: @opindex cntrl
 6838: @c Control characters.
 6839: @c 
 6840: コントロール文字.
 6841: @item digit
 6842: @opindex digit
 6843: @c Digits.
 6844: @c 
 6845: 数字.
 6846: @item graph
 6847: @opindex graph
 6848: @c Printable characters, not including space.
 6849: @c 
 6850: スペースを含まない,印刷可能な文字.
 6851: @item lower
 6852: @opindex lower
 6853: @c Lowercase letters.
 6854: @c 
 6855: 小文字.
 6856: @item print
 6857: @opindex print
 6858: @c Printable characters, including space.
 6859: @c 
 6860: スペースを含む,印刷可能な文字.
 6861: @item punct
 6862: @opindex punct
 6863: @c Punctuation characters.
 6864: @c 
 6865: 句読点文字.
 6866: @item space
 6867: @opindex space
 6868: @c Horizontal or vertical whitespace.
 6869: @c 
 6870: 水平垂直の空白.
 6871: @item upper
 6872: @opindex upper
 6873: @c Uppercase letters.
 6874: @c 
 6875: 大文字.
 6876: @item xdigit
 6877: @opindex xdigit
 6878: @c Hexadecimal digits.
 6879: @c 
 6880: 16進数の数字.
 6881: @end table
 6882: 
 6883: @c @item Equivalence classes
 6884: @item 等価なクラス
 6885: @cindex equivalence classes
 6886: 
 6887: @c The syntax @samp{[=@var{c}=]} expands to all of the characters that are
 6888: @c equivalent to @var{c}, in no particular order.  Equivalence classes are
 6889: @c a relatively recent invention intended to support non-English alphabets.
 6890: @c But there seems to be no standard way to define them or determine their
 6891: @c contents.  Therefore, they are not fully implemented in @sc{gnu} @command{tr};
 6892: @c each character's equivalence class consists only of that character,
 6893: @c which is of no particular use.
 6894: @c 
 6895: 構文@samp{[=@var{c}=]}は,@var{c}と等価な文字の全てに,特定の順序を持
 6896: たずに展開されます.等価なクラスは,英語以外のアルファベットをサポート
 6897: する目的で,比較的最近発明されました.しかし,それらの定義や内容を決定
 6898: する標準的な方法はなさそうです.そのため,@sc{gnu} @command{tr}では,
 6899: 完全には実装されていません.それぞれの文字の等価クラスは,その文字から
 6900: のみ構成されていて,特定の利用価値はありません.
 6901: 
 6902: @end table
 6903: 
 6904: 
 6905: @node Translating
 6906: @c @subsection Translating
 6907: @subsection 変換
 6908: 
 6909: @cindex translating characters
 6910: 
 6911: @c @command{tr} performs translation when @var{set1} and @var{set2} are
 6912: @c both given and the @option{--delete} (@option{-d}) option is not given.
 6913: @c @command{tr} translates each character of its input that is in @var{set1}
 6914: @c to the corresponding character in @var{set2}.  Characters not in
 6915: @c @var{set1} are passed through unchanged.  When a character appears more
 6916: @c than once in @var{set1} and the corresponding characters in @var{set2}
 6917: @c are not all the same, only the final one is used.  For example, these
 6918: @c two commands are equivalent:
 6919: @c 
 6920: @var{set1}と@var{set2}の両方が与えられ,@option{--delete}
 6921: (@option{-d})オプションが与えられていない場合,@command{tr}は変換を実
 6922: 行します.@command{tr}は,@var{set1}にある入力のぞれぞれの文字を,対応
 6923: する@var{set2}の文字に変換します.@var{set1}に無い文字は,そのまま変換
 6924: されず通過します.@var{set1}の文字が一回以上現われ,@var{set2}の対応す
 6925: る文字が全て同じではない場合,最後の一つのみ使用されます.例えば,以下
 6926: の二つのコマンドは等価です.
 6927: 
 6928: @example
 6929: tr aaa xyz
 6930: tr a z
 6931: @end example
 6932: 
 6933: @c A common use of @command{tr} is to convert lowercase characters to
 6934: @c uppercase.  This can be done in many ways.  Here are three of them:
 6935: @c 
 6936: @command{tr}の一般的な使用法は,小文字を大文字に変換することです.これ
 6937: を行なう方法はたくさんあるはずです.その三つを以下に書きます.
 6938: 
 6939: @example
 6940: tr abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ
 6941: tr a-z A-Z
 6942: tr '[:lower:]' '[:upper:]'
 6943: @end example
 6944: 
 6945: @noindent
 6946: @c But note that using ranges like @code{a-z} above is not portable.
 6947: @c 
 6948: しかし,上記の@code{a-z}のような範囲の使用には移植性がありません.
 6949: 
 6950: @c When @command{tr} is performing translation, @var{set1} and @var{set2}
 6951: @c typically have the same length.  If @var{set1} is shorter than
 6952: @c @var{set2}, the extra characters at the end of @var{set2} are ignored.
 6953: @c 
 6954: @command{tr}が変換を実行しているとき,@var{set1}と@var{set2}は,通常同
 6955: じ長さです.@var{set1}が@var{set2}より短い場合,@var{set2}の終りの余分
 6956: な文字は無視されます.
 6957: 
 6958: @c On the other hand, making @var{set1} longer than @var{set2} is not
 6959: @c portable; @acronym{POSIX} says that the result is undefined.  In this situation,
 6960: @c BSD @command{tr} pads @var{set2} to the length of @var{set1} by repeating
 6961: @c the last character of @var{set2} as many times as necessary.  System V
 6962: @c @command{tr} truncates @var{set1} to the length of @var{set2}.
 6963: @c 
 6964: 一方,@var{set1}を@var{set2}より大きくすることは移植性がありません.
 6965: @acronym{POSIX}では,その結果が未定義だと述べています.この場合,BSD
 6966: @command{tr}は,@var{set2}を@var{set2}の最後文字で必要なだけ繰り返すこ
 6967: とで@var{set1}の長さに引き延ばします.System V @command{tr}は,
 6968: @var{set1}を@var{set2}の長さに切り詰めます.
 6969: 
 6970: @c By default, @sc{gnu} @command{tr} handles this case like BSD @command{tr}.
 6971: @c When the @option{--truncate-set1} (@option{-t}) option is given,
 6972: @c @sc{gnu} @command{tr} handles this case like the System V @command{tr}
 6973: @c instead.  This option is ignored for operations other than translation.
 6974: @c 
 6975: デフォルトで,@sc{gnu} @command{tr}はBSD @command{tr}のようにこの状態
 6976: を処理します.@option{--truncate-set1} (@option{-t})オプションが与えら
 6977: れている場合,@sc{gnu} @command{tr}はSystem V @command{tr}のようにこの
 6978: 状態を処理します.このオプションは,変換以外の処理では無視されます.
 6979: 
 6980: @c Acting like System V @command{tr} in this case breaks the relatively common
 6981: @c BSD idiom:
 6982: @c 
 6983: この場合,System V @command{tr}のように動作させると,比較的一般的なBSD
 6984: の表現は壊れます.
 6985: 
 6986: @example
 6987: tr -cs A-Za-z0-9 '\012'
 6988: @end example
 6989: 
 6990: @noindent
 6991: @c because it converts only zero bytes (the first element in the
 6992: @c complement of @var{set1}), rather than all non-alphanumerics, to
 6993: @c newlines.
 6994: @c 
 6995: それは,全ての非英数字を改行に変換する代わりに,(@var{set1}の補語の最
 6996: 初の要素)ゼロバイトのみ変換されるためです.
 6997: 
 6998: @noindent
 6999: By the way, the above idiom is not portable because it uses ranges.
 7000: Assuming a @acronym{POSIX} compliant @command{tr}, here is a better way to write it:
 7001: 
 7002: ところで,上記の慣例は範囲を使用しているので移植性がありません.
 7003: @acronym{POSIX}が@command{tr}に文句をいう場合,ここでは以下のように書
 7004: いた方が良いでしょう.
 7005: 
 7006: @example
 7007: tr -cs '[:alnum:]' '[\n*]'
 7008: @end example
 7009: 
 7010: 
 7011: @node Squeezing
 7012: @c @subsection Squeezing repeats and deleting
 7013: @subsection 繰り返しの圧縮と削除
 7014: 
 7015: @cindex squeezing repeat characters
 7016: @cindex deleting characters
 7017: 
 7018: @c When given just the @option{--delete} (@option{-d}) option, @command{tr}
 7019: @c removes any input characters that are in @var{set1}.
 7020: @c 
 7021: @option{--delete} (@option{-d})オプションのみ与えられたとき,
 7022: @command{tr}は,@var{set1}にあるあらゆる入力文字を削除します.
 7023: 
 7024: @c When given just the @option{--squeeze-repeats} (@option{-s}) option,
 7025: @c @command{tr} replaces each input sequence of a repeated character that
 7026: @c is in @var{set1} with a single occurrence of that character.
 7027: @c 
 7028: @option{--squeeze-repeats} (@option{-s})オプションのみ与えられたとき,
 7029: @command{tr}は,@var{set1}にある,それぞれの入力で繰り返される文字の並
 7030: びを,その文字が一度だけ表れるように置換します.
 7031: 
 7032: @c When given both @option{--delete} and @option{--squeeze-repeats}, @command{tr}
 7033: @c first performs any deletions using @var{set1}, then squeezes repeats
 7034: @c from any remaining characters using @var{set2}.
 7035: @c 
 7036: @option{--delete}と@option{--squeeze-repeats}の両方が与えられた場合,
 7037: @command{tr}は,最初に@var{set1}を用いて削除を実行し,@var{set2}を用い
 7038: て残りの文字から繰り返しを圧縮します.
 7039: 
 7040: @c The @option{--squeeze-repeats} option may also be used when translating,
 7041: @c in which case @command{tr} first performs translation, then squeezes
 7042: @c repeats from any remaining characters using @var{set2}.
 7043: @c 
 7044: @option{--squeeze-repeats}オプションは,変換時にも利用でき,その場合,
 7045: @command{tr}は,最初に変換を実行し,@var{set2}を用いて残りの文字から繰
 7046: り返しを圧縮します.
 7047: 
 7048: @c Here are some examples to illustrate various combinations of options:
 7049: @c 
 7050: ここに,オプションの様々な組合せの表現例をいくつかあげます.
 7051: 
 7052: @itemize @bullet
 7053: 
 7054: @item
 7055: @c Remove all zero bytes:
 7056: @c 
 7057: 全てのゼロバイトを削除.
 7058: 
 7059: @example
 7060: tr -d '\000'
 7061: @end example
 7062: 
 7063: @item
 7064: @c Put all words on lines by themselves.  This converts all
 7065: @c non-alphanumeric characters to newlines, then squeezes each string
 7066: @c of repeated newlines into a single newline:
 7067: @c 
 7068: 全ての単語を単独行にします.これは,全ての非英数文字を改行に変換し,繰
 7069: り返される改行になっているそれぞれの文字列を単一の改行に圧縮します.
 7070: 
 7071: @example
 7072: tr -cs '[:alnum:]' '[\n*]'
 7073: @end example
 7074: 
 7075: @item
 7076: @c Convert each sequence of repeated newlines to a single newline:
 7077: @c 
 7078: 繰り返される改行のそれぞれの並びを,単一の改行に変換します.
 7079: 
 7080: @example
 7081: tr -s '\n'
 7082: @end example
 7083: 
 7084: @item
 7085: @c Find doubled occurrences of words in a document.
 7086: @c For example, people often write ``the the'' with the duplicated words
 7087: @c separated by a newline.  The bourne shell script below works first
 7088: @c by converting each sequence of punctuation and blank characters to a
 7089: @c single newline.  That puts each ``word'' on a line by itself.
 7090: @c Next it maps all uppercase characters to lower case, and finally it
 7091: @c runs @command{uniq} with the @option{-d} option to print out only the words
 7092: @c that were adjacent duplicates.
 7093: @c 
 7094: ドキュメントで単語の二重の出現を見付けます.例えば,改行で分離されてい
 7095: る二重になっている単語``the the''と書くこともよくあります.以下の
 7096: bourneシェルスクリプトは,最初に句読点と空白文字の並びを単一の改行文字
 7097: に変換する動作を行います.それでそれぞれの``単語''が単独行に書かれます.
 7098: 次に全ての大文字を小文字に置き換え,最後に複製が隣接している単語のみを
 7099: 出力するために,@command{uniq}を@option{-d}オプションで実行します.
 7100: 
 7101: @example
 7102: #!/bin/sh
 7103: cat "$@@" \
 7104:   | tr -s '[:punct:][:blank:]' '\n' \
 7105:   | tr '[:upper:]' '[:lower:]' \
 7106:   | uniq -d
 7107: @end example
 7108: 
 7109: @item
 7110: @c Deleting a small set of characters is usually straightforward.  For example,
 7111: @c to remove all @samp{a}s, @samp{x}s, and @samp{M}s you would do this:
 7112: @c 
 7113: 文字の小さな組を削除することは,一般的に簡単です.例えば,すべての
 7114: @samp{a},@samp{x},そして@samp{M}を削除するために,以下のようにします.
 7115: 
 7116: @example
 7117: tr -d axM
 7118: @end example
 7119: 
 7120: @c However, when @samp{-} is one of those characters, it can be tricky because
 7121: @c @samp{-} has special meanings.  Performing the same task as above but also
 7122: @c removing all @samp{-} characters, we might try @code{tr -d -axM}, but
 7123: @c that would fail because @command{tr} would try to interpret @option{-a} as
 7124: @c a command-line option.  Alternatively, we could try putting the hyphen
 7125: @c inside the string, @code{tr -d a-xM}, but that wouldn't work either because
 7126: @c it would make @command{tr} interpret @code{a-x} as the range of characters
 7127: @c @samp{a}@dots{}@samp{x} rather than the three.
 7128: @c One way to solve the problem is to put the hyphen at the end of the list
 7129: @c of characters:
 7130: @c 
 7131: しかし,これらの文字の一つが@samp{-}のとき,@samp{-}には特別な意味があ
 7132: るので,ちょっとトリッキーになります.上記と同じ作業を実行し,さらにす
 7133: べての@samp{-}文字を削除するため,@code{tr -d -axM}を試してみるかもし
 7134: れませんが,@command{tr}は@option{-a}をコマンドラインオプションと解釈
 7135: しようとするので失敗するでしょう.代わりに,文字列の間にハイフンを
 7136: @code{tr -d a-xM}のように書いてみても,@command{tr}は@code{a-x}を三文
 7137: 字ではなく@samp{a}@dots{}@samp{x}の範囲として解釈するので動作しません.
 7138: 問題を解決する方法の一つは,文字のリストの最後にハイフンを書くことです.
 7139: 
 7140: @example
 7141: tr -d axM-
 7142: @end example
 7143: 
 7144: @c More generally, use the character class notation @code{[=c=]}
 7145: @c with @samp{-} (or any other character) in place of the @samp{c}:
 7146: @c 
 7147: より一般的に,文字クラスの表記@code{[=c=]}を使用し,@samp{-}(または,
 7148: 任意の文字)を@samp{c}の位置に書きます.
 7149: 
 7150: @example
 7151: tr -d '[=-=]axM'
 7152: @end example
 7153: 
 7154: @c Note how single quotes are used in the above example to protect the
 7155: @c square brackets from interpretation by a shell.
 7156: @c 
 7157: 上記の例で使用しているシングルクオートは,角括弧をシェルが解釈すること
 7158: を防ぎます.
 7159: 
 7160: @end itemize
 7161: 
 7162: 
 7163: @node Warnings in tr
 7164: @c @subsection Warning messages
 7165: @subsection 警告メッセージ
 7166: 
 7167: @vindex POSIXLY_CORRECT
 7168: @c Setting the environment variable @env{POSIXLY_CORRECT} turns off the
 7169: @c following warning and error messages, for strict compliance with
 7170: @c @acronym{POSIX}.  Otherwise, the following diagnostics are issued:
 7171: @c 
 7172: 環境変数@env{POSIXLY_CORRECT}を設定すると,@acronym{POSIX}を厳密に遵守
 7173: するため,以下の警告とエラーのメッセージをオフにします.それ以外の場合,
 7174: 以下の診断結果を出力します.
 7175: 
 7176: @enumerate
 7177: 
 7178: @item
 7179: @c When the @option{--delete} option is given but @option{--squeeze-repeats}
 7180: @c is not, and @var{set2} is given, @sc{gnu} @command{tr} by default prints
 7181: @c a usage message and exits, because @var{set2} would not be used.
 7182: @c The @acronym{POSIX} specification says that @var{set2} must be ignored in
 7183: @c this case. Silently ignoring arguments is a bad idea.
 7184: @c 
 7185: @option{--delete}オプションが与えられているが,
 7186: @option{--squeeze-repeats}が与えられておらず,@var{set2}が与えられてい
 7187: るとき,@sc{gnu} @command{tr}は,@var{set2}が使用されないため,デフォ
 7188: ルトで使用方法のメッセージを出力し終了します.@acronym{POSIX}仕様では,
 7189: この場合@var{set2}は無視する必要があると述べられています.黙って引数を
 7190: 無視するのは悪い考えです.
 7191: 
 7192: @item
 7193: @c When an ambiguous octal escape is given.  For example, @samp{\400}
 7194: @c is actually @samp{\40} followed by the digit @samp{0}, because the
 7195: @c value 400 octal does not fit into a single byte.
 7196: @c 
 7197: 曖昧な八進数のエスケープが与えられたときです.例えば@samp{\400}は,八
 7198: 進数の400の値が単一バイトに適さないので,実際には@samp{0}が後置された
 7199: @samp{\40}になります.
 7200: 
 7201: @end enumerate
 7202: 
 7203: @c @sc{gnu} @command{tr} does not provide complete BSD or System V compatibility.
 7204: @c For example, it is impossible to disable interpretation of the @acronym{POSIX}
 7205: @c constructs @samp{[:alpha:]}, @samp{[=c=]}, and @samp{[c*10]}.  Also, @sc{gnu}
 7206: @c @command{tr} does not delete zero bytes automatically, unlike traditional
 7207: @c Unix versions, which provide no way to preserve zero bytes.
 7208: @c 
 7209: @sc{gnu} @command{tr}は,BSDやSystem Vとの完全な互換性を提供していませ
 7210: ん.例えば,@acronym{POSIX}の概念@samp{[:alpha:]},@samp{[=c=]},そし
 7211: て@samp{[c*10]}の解釈を利用不可にすることはできません.また,@sc{gnu}
 7212: @command{tr}は,ゼロバイトを保護する方法を提供できない伝統的なUnixバー
 7213: ジョンと異なり,ゼロバイトを自動的に削除できません.
 7214: 
 7215: 
 7216: @node expand invocation
 7217: @c @section @command{expand}: Convert tabs to spaces
 7218: @section @command{expand}: タブをスペースに変換
 7219: 
 7220: @pindex expand
 7221: @cindex tabs to spaces, converting
 7222: @cindex converting tabs to spaces
 7223: 
 7224: @c @command{expand} writes the contents of each given @var{file}, or standard
 7225: @c input if none are given or for a @var{file} of @samp{-}, to standard
 7226: @c output, with tab characters converted to the appropriate number of
 7227: @c spaces.  Synopsis:
 7228: @c 
 7229: @command{expand}は,与えられたそれぞれの@var{file},または,与えられな
 7230: い場合や@samp{-}の@var{file}の場合は標準入力の内容を,タブ文字を適切な
 7231: 数のスペースに変換して,標準出力に書き出します.概要です.
 7232: 
 7233: @example
 7234: expand [@var{option}]@dots{} [@var{file}]@dots{}
 7235: @end example
 7236: 
 7237: @c By default, @command{expand} converts all tabs to spaces.  It preserves
 7238: @c backspace characters in the output; they decrement the column count for
 7239: @c tab calculations.  The default action is equivalent to @option{-t 8} (set
 7240: @c tabs every 8 columns).
 7241: @c 
 7242: デフォルトで,@command{expand}は全てのタブをスペースに変換します.それ
 7243: は全ての出力でバックスペース文字を維持します.それらはタブ計算に対し,
 7244: 列の数を減少させます.デフォルトの動作は@option{-8}(タブをそれぞれ八列
 7245: に設定する)と同じです.
 7246: 
 7247: @c The program accepts the following options.  Also see @ref{Common options}.
 7248: @c 
 7249: プログラムは,以下のオプションを受け入れます.@ref{Common options}も参
 7250: 照してください.
 7251: 
 7252: @table @samp
 7253: 
 7254: @item -t @var{tab1}[,@var{tab2}]@dots{}
 7255: @itemx --tabs=@var{tab1}[,@var{tab2}]@dots{}
 7256: @opindex -t
 7257: @opindex --tabs
 7258: @cindex tabstops, setting
 7259: @c If only one tab stop is given, set the tabs @var{tab1} spaces apart
 7260: @c (default is 8).  Otherwise, set the tabs at columns @var{tab1},
 7261: @c @var{tab2}, @dots{} (numbered from 0), and replace any tabs beyond the
 7262: @c last tabstop given with single spaces.  Tabstops can be separated by
 7263: @c blanks as well as by commas.
 7264: @c 
 7265: 一つのタブストップのみ与えられた場合,タブを@var{tab1}個の別々のスペー
 7266: ス(デフォルトで8)に設定します.それ以外の場合,タブを@var{tab1},
 7267: @var{tab2},@dots{}(0から番号付けされる)列に設定し,与えられた最後のタ
 7268: ブストップ以降のあらゆるタブを単一のスペースで置換します.タブストップ
 7269: は,カンマではなく空白で分けることも可能です.
 7270: 
 7271: @c On older systems, @command{expand} supports an obsolete option
 7272: @c @option{-@var{tab1}[,@var{tab2}]@dots{}}, where tabstops must be
 7273: @c separated by commas.  @acronym{POSIX} 1003.1-2001 (@pxref{Standards
 7274: @c conformance}) does not allow this; use @option{-t
 7275: @c @var{tab1}[,@var{tab2}]@dots{}} instead.
 7276: @c 
 7277: 古いシステムでは,@command{expand}は時代遅れのオプション
 7278: @option{-@var{tab1}[,@var{tab2}]@dots{}}をサポートしていて,そこではタ
 7279: ブストップをカンマで分離するはずです.@acronym{POSIX} 1003.1-2001
 7280: (@pxref{Standards conformance})ではこれを許可していません.代わりに
 7281: @option{-t @var{tab1}[,@var{tab2}]@dots{}}を使用してください.
 7282: 
 7283: @item -i
 7284: @itemx --initial
 7285: @opindex -i
 7286: @opindex --initial
 7287: @cindex initial tabs, converting
 7288: @c Only convert initial tabs (those that precede all non-space or non-tab
 7289: @c characters) on each line to spaces.
 7290: @c 
 7291: それぞれの行の最初のタブ(前にあるものが全て非スペース文字や非タブ文字
 7292: となるもの)をスペースに変換します.
 7293: 
 7294: @end table
 7295: 
 7296: 
 7297: @node unexpand invocation
 7298: @c @section @command{unexpand}: Convert spaces to tabs
 7299: @section @command{unexpand}: スペースをタブに変換する
 7300: 
 7301: @pindex unexpand
 7302: 
 7303: @c @command{unexpand} writes the contents of each given @var{file}, or
 7304: @c standard input if none are given or for a @var{file} of @samp{-}, to
 7305: @c standard output, with strings of two or more space or tab characters
 7306: @c converted to as many tabs as possible followed by as many spaces as are
 7307: @c needed.  Synopsis:
 7308: @c 
 7309: @command{unexpand}は,与えられたそれぞれの@var{file},または与えられな
 7310: い場合や@samp{-}の@var{file}に対しては標準入力の内容を,二つ以上のスペー
 7311: スやタブ文字の文字列を,二つ以上のスペースやタブ文字を,必要とされる数
 7312: のスペースを可能な限り連続するタブに変換しながら,内容を標準出力に書き
 7313: 出します.概要です.
 7314: 
 7315: @example
 7316: unexpand [@var{option}]@dots{} [@var{file}]@dots{}
 7317: @end example
 7318: 
 7319: @c By default, @command{unexpand} converts only initial spaces and tabs (those
 7320: @c that precede all non space or tab characters) on each line.  It
 7321: @c preserves backspace characters in the output; they decrement the column
 7322: @c count for tab calculations.  By default, tabs are set at every 8th
 7323: @c column.
 7324: @c 
 7325: デフォルトで,@command{unexpand}は,最初のスペースとタブ(前にあるもの
 7326: が全て非スペース文字や非タブ文字となるもの)だけを,ぞれぞれの行で変換
 7327: します.それは,出力でバックスペース文字を維持します.タブの計算で列が
 7328: 減少します.デフォルトで,タブは八列単位に設定されます.
 7329: 
 7330: @c The program accepts the following options.  Also see @ref{Common options}.
 7331: @c 
 7332: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
 7333: してください.
 7334: 
 7335: @table @samp
 7336: 
 7337: @item -t @var{tab1}[,@var{tab2}]@dots{}
 7338: @itemx --tabs=@var{tab1}[,@var{tab2}]@dots{}
 7339: @opindex -t
 7340: @opindex --tabs
 7341: @c If only one tab stop is given, set the tabs @var{tab1} spaces apart
 7342: @c instead of the default 8.  Otherwise, set the tabs at columns
 7343: @c @var{tab1}, @var{tab2}, @dots{} (numbered from 0), and leave spaces and
 7344: @c tabs beyond the tabstops given unchanged.  Tabstops can be separated by
 7345: @c blanks as well as by commas.  This option implies the @option{-a} option.
 7346: @c 
 7347: 一つのタブストップのみ与えられた場合,タブを,デフォルトの8の代わりに,
 7348: それぞれ@var{tab1}スペースに設定します.それ以外の場合,タブを
 7349: @var{tab1}列,@var{tab2}列,@dots{} (0から番号付けされる)に設定し,与
 7350: えられたタブストップ以降のスペースタブは,変更されずに残ります.タブス
 7351: トップはカンマではなく空白で分離することも可能です.オプションは暗黙に
 7352: @option{-a}オプションを指定します.
 7353: 
 7354: @c On older systems, @command{unexpand} supports an obsolete option
 7355: @c @option{-@var{tab1}[,@var{tab2}]@dots{}}, where tabstops must be
 7356: @c separated by commas.  (Unlike @option{-t}, this obsolete option does
 7357: @c not imply @option{-a}.)  @acronym{POSIX} 1003.1-2001 (@pxref{Standards
 7358: @c conformance}) does not allow this; use @option{--first-only -t
 7359: @c @var{tab1}[,@var{tab2}]@dots{}} instead.
 7360: @c 
 7361: 古いシステムでは,@command{unexpand}は時代遅れのオプション
 7362: @option{-@var{tab1}[,@var{tab2}]@dots{}}をサポートしていて,そこではタ
 7363: ブストップをカンマで分離するはずです.@acronym{POSIX} 1003.1-2001
 7364: (@pxref{Standards conformance})ではこれを許可していません.代わりに
 7365: @option{--first-only -t @var{tab1}[,@var{tab2}]@dots{}}を使用してくだ
 7366: さい.
 7367: 
 7368: @item -a
 7369: @itemx --all
 7370: @opindex -a
 7371: @opindex --all
 7372: @c Convert all strings of two or more spaces or tabs, not just initial
 7373: @c ones, to tabs.
 7374: @c 
 7375: 最初のものだけでなく,全ての二つ以上のスペースやタブをタブに変換します.
 7376: 
 7377: @end table
 7378: 
 7379: 
 7380: @node Directory listing
 7381: @c @chapter Directory listing
 7382: @chapter ディレクトリのリストアップ
 7383: 
 7384: @c This chapter describes the @command{ls} command and its variants @command{dir}
 7385: @c and @command{vdir}, which list information about files.
 7386: @c 
 7387: この章では,@command{ls}コマンドとその変形の@command{dir}と
 7388: @command{vdir}を記述し,それはファイルに関する情報をリストアップします.
 7389: 
 7390: @menu
 7391: * ls invocation::               List directory contents.
 7392: * dir invocation::              Briefly ls.
 7393: * vdir invocation::             Verbosely ls.
 7394: * dircolors invocation::        Color setup for ls, etc.
 7395: @end menu
 7396: 
 7397: 
 7398: @node ls invocation
 7399: @c @section @command{ls}: List directory contents
 7400: @section @command{ls}: ディレクトリの内容をリストアップ
 7401: 
 7402: @pindex ls
 7403: @cindex directory listing
 7404: 
 7405: @c The @command{ls} program lists information about files (of any type,
 7406: @c including directories).  Options and file arguments can be intermixed
 7407: @c arbitrarily, as usual.
 7408: @c 
 7409: @command{ls}プログラムは,ファイル(のすべての形式で,ディレクトリを含
 7410: む)に関する情報をリストアップします.オプションとファイル引数は,通常
 7411: のものと同様,任意に混ぜることが可能です.
 7412: 
 7413: @c For non-option command-line arguments that are directories, by default
 7414: @c @command{ls} lists the contents of directories, not recursively, and
 7415: @c omitting files with names beginning with @samp{.}.  For other non-option
 7416: @c arguments, by default @command{ls} lists just the file name.  If no
 7417: @c non-option argument is specified, @command{ls} operates on the current
 7418: @c directory, acting as if it had been invoked with a single argument of @samp{.}.
 7419: @c 
 7420: オプションの無いコマンドラインのディレクトリ引数に対し,@command{ls}は
 7421: デフォルトで,ディレクトリの内容をリストアップし,それは再帰的ではなく,
 7422: @samp{.}で始まる名前を持つファイルは除外しています.他のオプションの無
 7423: い引数に対し,@command{ls}はデフォルトで,そのファイル名のみをリストアッ
 7424: プします.オプションではない引数が指定されない場合,@command{ls}は現在
 7425: のディレクトリの内容をリストアップします.
 7426: 
 7427: @vindex LC_ALL
 7428: @c By default, the output is sorted alphabetically, according to the locale
 7429: @c settings in effect. @footnote{If you use a non-@acronym{POSIX}
 7430: @c locale (e.g., by setting @env{LC_ALL} to @samp{en_US}), then @command{ls} may
 7431: @c produce output that is sorted differently than you're accustomed to.
 7432: @c In that case, set the @env{LC_ALL} environment variable to @samp{C}.}
 7433: @c If standard output is
 7434: @c a terminal, the output is in columns (sorted vertically) and control
 7435: @c characters are output as question marks; otherwise, the output is listed
 7436: @c one per line and control characters are output as-is.
 7437: @c 
 7438: デフォルトで,出力はアルファベット順に出力され,それはロケールの設定に
 7439: 影響されます.@footnote{@acronym{POSIX}ロケールにではないものを使用し
 7440: ている(例えば,@env{LC_ALL}を@samp{en_US}に設定している)場合,
 7441: @command{ls} は慣れているものとは異なる並べ替えの出力を生成する可能性
 7442: があります.そのような状況では,@env{LC_ALL}を@samp{C}に設定して下さい.} 
 7443: 標準出力が端末の場合,出力は(垂直方向にソートされた)列になり,制御文字
 7444: は疑問符として出力されます.それ以外の場合,出力は一行ごとにリストアッ
 7445: プされ,制御文字はそのままになります.
 7446: 
 7447: @c Because @command{ls} is such a fundamental program, it has accumulated many
 7448: @c options over the years.  They are described in the subsections below;
 7449: @c within each section, options are listed alphabetically (ignoring case).
 7450: @c The division of options into the subsections is not absolute, since some
 7451: @c options affect more than one aspect of @command{ls}'s operation.
 7452: @c 
 7453: @command{ls}はあまりに基本的なプログラムなので,数年かけて多くのオプショ
 7454: ンを蓄積してきました.それらは以下のサブセクションで記述します.それぞ
 7455: れのセクションで,オプションはアルファベット順に(大文字小文字を無視し
 7456: て)リストアップされています.オプションをサブセクションに分けることは
 7457: 絶対ではなく,それは,一つ以上の@command{ls}の処理の局面に影響するため
 7458: です.
 7459: 
 7460: @c Also see @ref{Common options}.
 7461: @c 
 7462: @ref{Common options}も参照してください.
 7463: 
 7464: @menu
 7465: * Which files are listed::
 7466: * What information is listed::
 7467: * Sorting the output::
 7468: * More details about version sort::
 7469: * General output formatting::
 7470: * Formatting file timestamps::
 7471: * Formatting the file names::
 7472: @end menu
 7473: 
 7474: 
 7475: @node Which files are listed
 7476: @c @subsection Which files are listed
 7477: @subsection リストアップされるファイル
 7478: 
 7479: @c These options determine which files @command{ls} lists information for.
 7480: @c By default, any files and the contents of any directories on the command
 7481: @c line are shown.
 7482: @c 
 7483: これらのオプションは,@command{ls}がリストアップするファイルの情報を決
 7484: 定します.デフォルトで,コマンドラインのあらゆるファイルとディレクトリ
 7485: の内容が表示されます.
 7486: 
 7487: @table @samp
 7488: 
 7489: @item -a
 7490: @itemx --all
 7491: @opindex -a
 7492: @opindex --all
 7493: @c List all files in directories, including files that start with @samp{.}.
 7494: @c 
 7495: @samp{.}で始まるファイルを含め,ディレクトリの全てのファイルをリストアッ
 7496: プします.
 7497: 
 7498: @item -A
 7499: @itemx --almost-all
 7500: @opindex -A
 7501: @opindex --almost-all
 7502: @c List all files in directories except for @file{.} and @file{..}.
 7503: @c 
 7504: @file{.}と@file{..}以外の,ディレクトリの全てのファイルをリストアップ
 7505: します.
 7506: 
 7507: @item -B
 7508: @itemx --ignore-backups
 7509: @opindex -B
 7510: @opindex --ignore-backups
 7511: @cindex backup files, ignoring
 7512: @c Do not list files that end with @samp{~}, unless they are given on the
 7513: @c command line.
 7514: @c 
 7515: コマンドラインで与えられない限り,@samp{~}で終るファイルをリストアップ
 7516: しません.
 7517: 
 7518: @item -d
 7519: @itemx --directory
 7520: @opindex -d
 7521: @opindex --directory
 7522: @c List just the names of directories, as with other types of files, rather
 7523: @c than listing their contents.
 7524: @c 
 7525: ディレクトリの名前のみリストアップし,それはファイルの他の形式と同様で,
 7526: その内容をリストアップしません.
 7527: @c The following sentence is the same as the one for -F.
 7528: @c 
 7529: @c Do not follow symbolic links listed on the
 7530: @c command line unless the @option{--dereference-command-line} (@option{-H}),
 7531: @c @option{--dereference} (@option{-L}), or
 7532: @c @option{--dereference-command-line-symlink-to-dir} options are specified.
 7533: @c 
 7534: @option{--dereference-command-line} (@option{-H}),
 7535: @option{--dereference} (@option{-L}),または
 7536: @option{--dereference-command-line-symlink-to-dir}オプションが指定され
 7537: ていない限り,コマンドラインでリストアップされているシンボリックリンク
 7538: をたどりません.
 7539: 
 7540: @item -H
 7541: @itemx --dereference-command-line
 7542: @opindex -H
 7543: @opindex --dereference-command-line
 7544: @cindex symbolic links, dereferencing
 7545: @c If a command line argument specifies a symbolic link, show information
 7546: @c for the file the link references rather than for the link itself.
 7547: @c 
 7548: コマンドライン引数がシンボリックリンクを指定している場合,リンク自身で
 7549: はなくリンクが参照しているファイルの情報を表示します.
 7550: 
 7551: @itemx --dereference-command-line-symlink-to-dir
 7552: @opindex --dereference-command-line-symlink-to-dir
 7553: @cindex symbolic links, dereferencing
 7554: @c Do not dereference symbolic links, with one exception:
 7555: @c if a command line argument specifies a symbolic link that refers to
 7556: @c a directory, show information for that directory rather than for the
 7557: @c link itself.
 7558: @c This is the default behavior when no other dereferencing-related
 7559: @c option has been specified (@option{--classify} (@option{-F}),
 7560: @c @option{--directory} (@option{-d}),
 7561: @c (@option{-l}),
 7562: @c @option{--dereference} (@option{-L}), or
 7563: @c @option{--dereference-command-line} (@option{-H})).
 7564: @c 
 7565: 一つの例外がありますが,シンボリックリンクを間接参照しません.コマンド
 7566: ライン引数で,ディレクトリを参照するシンボリックリンクが指定されている
 7567: 場合,リンク自身ではなくディレクトリの情報を表示します.他に参照に関連
 7568: するオプション(@option{--classify} (@option{-F}),@option{--directory}
 7569: (@option{-d}),(@option{-l}),@option{--dereference} (@option{-L}),ま
 7570: たは@option{--dereference-command-line} (@option{-H}))が指定されていな
 7571: いとき,これはデフォルトの動作です.
 7572: 
 7573: @item -I PATTERN
 7574: @itemx --ignore=PATTERN
 7575: @opindex -I
 7576: @opindex --ignore=@var{pattern}
 7577: @c Do not list files whose names match the shell pattern (not regular
 7578: @c expression) @var{pattern} unless they are given on the command line.  As
 7579: @c in the shell, an initial @samp{.} in a file name does not match a
 7580: @c wildcard at the start of @var{pattern}.  Sometimes it is useful
 7581: @c to give this option several times.  For example,
 7582: @c 
 7583: コマンドラインで与えられていない限り,シェルパターン(正規表現ではあり
 7584: ません)@var{pattern}にマッチする名前のファイルをリストアップしません.
 7585: シェルと同様に,ファイル名の最初の@samp{.}は,@var{pattern}の最初のワ
 7586: イルドカードにマッチしません.このオプションを複数回与えると便利なとき
 7587: もあります.例えば,以下のようにします.
 7588: 
 7589: @smallexample
 7590: $ ls --ignore='.??*' --ignore='.[^.]' --ignore='#*'
 7591: @end smallexample
 7592: 
 7593: @c The first option ignores names of length 3 or more that start with @samp{.},
 7594: @c the second ignores all two-character names that start with @samp{.}
 7595: @c except @samp{..}, and the third ignores names that start with @samp{#}.
 7596: @c 
 7597: 最初のオプションは,@samp{.}で始まる長さが3文字以上の名前を無視し,二
 7598: 番目は@samp{..}以外の@samp{.}で始まる全ての2文字の名前を無視し,三番目
 7599: は@samp{#}で始まる名前を無視します.
 7600: 
 7601: @item -L
 7602: @itemx --dereference
 7603: @opindex -L
 7604: @opindex --dereference
 7605: @cindex symbolic links, dereferencing
 7606: @c When showing file information for a symbolic link, show information
 7607: @c for the file the link references rather than the link itself.
 7608: @c 
 7609: 長いリストで,シンボリックリンク自身ではなくシンボリックリンクが参照す
 7610: るファイルの情報(例えば,時間や許可)を表示します.
 7611: 
 7612: @item -R
 7613: @itemx --recursive
 7614: @opindex -R
 7615: @opindex --recursive
 7616: @cindex recursive directory listing
 7617: @cindex directory listing, recursive
 7618: @c List the contents of all directories recursively.
 7619: @c 
 7620: 全てのディレクトリの内容を,再帰的にリストアップします.
 7621: 
 7622: @end table
 7623: 
 7624: 
 7625: @node What information is listed
 7626: @c @subsection What information is listed
 7627: @subsection リストアップされる情報
 7628: 
 7629: @c These options affect the information that @command{ls} displays.  By
 7630: @c default, only file names are shown.
 7631: @c 
 7632: これらのオプションは,@command{ls}が表示する情報に影響します.デフォル
 7633: トで,ファイル名のみ表示されます.
 7634: 
 7635: @table @samp
 7636: 
 7637: @item --author
 7638: @opindex --author
 7639: @cindex hurd, author, printing
 7640: @c List each file's author when producing long format directory listings.
 7641: @c In GNU/Hurd, file authors can differ from their owners, but in other
 7642: @c operating systems the two are the same.
 7643: @c 
 7644: 長い書式のディレクトリのリストを生成するとき,それぞれのファイルの著者
 7645: をリストアップします.GNU/Hurdでは,ファイルの著者はその所有者とは異な
 7646: りますが,他のオペレーティングシステムではその二つは同じです.
 7647: 
 7648: @item -D
 7649: @itemx --dired
 7650: @opindex -D
 7651: @opindex --dired
 7652: @cindex dired Emacs mode support
 7653: @c With the long listing (@option{-l}) format, print an additional line after
 7654: @c the main output:
 7655: @c 
 7656: 長いリスト(@option{-l})の書式を用いた場合,主な出力の後に追加して以下
 7657: を出力します.
 7658: 
 7659: @example
 7660: //DIRED// @var{beg1} @var{end1} @var{beg2} @var{end2} @dots{}
 7661: @end example
 7662: 
 7663: @noindent
 7664: @c The @var{begN} and @var{endN} are unsigned integers that record the
 7665: @c byte position of the beginning and end of each file name in the output.
 7666: @c This makes it easy for Emacs to find the names, even when they contain
 7667: @c unusual characters such as space or newline, without fancy searching.
 7668: @c 
 7669: @var{begN}と@var{endN}は,出力のそれぞれのファイル名の始めと終りのバイ
 7670: ト位置を記録する符号無し整数です.これで,たとえスペースや改行といった
 7671: 通常用いない文字を含むときも,異常な検索をすることなく,Emacsで簡単に
 7672: 名前を見つかるようになります.
 7673: 
 7674: @c If directories are being listed recursively (@code{-R}), output a similar
 7675: @c line with offsets for each subdirectory name:
 7676: @c 
 7677: ディレクトリが再帰的(@option{-R})にリストアップされる場合,出力はそれ
 7678: ぞれのサブディレクトリの後に,良く似た行を出力します.
 7679: @example
 7680: //SUBDIRED// @var{beg1} @var{end1} @dots{}
 7681: @end example
 7682: 
 7683: @c Finally, output a line of the form:
 7684: @c 
 7685: 最終的に以下の形式の行を出力します.
 7686: @example
 7687: //DIRED-OPTIONS// --quoting-style=@var{word}
 7688: @end example
 7689: @c where @var{word} is the quoting style (@pxref{Formatting the file names}).
 7690: @c 
 7691: @var{word}は引用形式です(@pxref{Formatting the file names}).
 7692: 
 7693: @c Here is an actual example:
 7694: @c 
 7695: 以下は実際の例です.
 7696: 
 7697: @example
 7698: $ mkdir -p a/sub/deeper a/sub2
 7699: $ touch a/f1 a/f2
 7700: $ touch a/sub/deeper/file
 7701: $ ls -gloRF --dired a
 7702:   a:
 7703:   total 8
 7704:   -rw-r--r--    1        0 Nov  9 18:30 f1
 7705:   -rw-r--r--    1        0 Nov  9 18:30 f2
 7706:   drwxr-xr-x    3     4096 Nov  9 18:30 sub/
 7707:   drwxr-xr-x    2     4096 Nov  9 18:30 sub2/
 7708: 
 7709:   a/sub:
 7710:   total 4
 7711:   drwxr-xr-x    2     4096 Nov  9 18:30 deeper/
 7712: 
 7713:   a/sub/deeper:
 7714:   total 0
 7715:   -rw-r--r--    1        0 Nov  9 18:30 file
 7716: 
 7717:   a/sub2:
 7718:   total 0
 7719: //DIRED// 55 57 98 100 141 144 186 190 252 258 327 331
 7720: //SUBDIRED// 2 3 195 200 263 275 335 341
 7721: //DIRED-OPTIONS// --quoting-style=literal
 7722: @end example
 7723: 
 7724: @c Note that the pairs of offsets on the @samp{//DIRED//} line above delimit
 7725: @c these names: @file{f1}, @file{f2}, @file{sub}, @file{sub2}, @file{deeper},
 7726: @c @file{file}.
 7727: @c The offsets on the @samp{//SUBDIRED//} line delimit the following
 7728: @c directory names: @file{a}, @file{a/sub}, @file{a/sub/deeper}, @file{a/sub2}.
 7729: @c 
 7730: 上記の@samp{//DIRED//}行のオフセットの組が,以下の名前@file{f1},
 7731: @file{f2},@file{sub},@file{sub2},@file{deeper},@file{file}を分離し
 7732: ていることに注意して下さい.@samp{//SUBDIRED//}行のオフセットは,以下
 7733: のディレクトリ名@file{a},@file{a/sub},@file{a/sub/deeper},
 7734: @file{a/sub2}を分離しています.
 7735: 
 7736: @c Here is an example of how to extract the fifth entry name, @samp{deeper},
 7737: @c corresponding to the pair of offsets, 252 and 258:
 7738: @c 
 7739: 以下は,五番目の項目名を抽出する方法,@samp{deeper}の例で,対応するオ
 7740: フセットの組は,252と258です.
 7741: 
 7742: @example
 7743: $ ls -gloRF --dired a > out
 7744: $ dd bs=1 skip=252 count=6 < out 2>/dev/null; echo
 7745: deeper
 7746: @end example
 7747: 
 7748: @c Note that although the listing above includes a trailing slash
 7749: @c for the @samp{deeper} entry, the offsets select the name without
 7750: @c the trailing slash.  However, if you invoke @command{ls} with @option{--dired}
 7751: @c along with an option like @option{--escape} (aka @option{-b}) and operate
 7752: @c on a file whose name contains special characters, notice that the backslash
 7753: @c @emph{is} included:
 7754: @c 
 7755: 上記のリストには,@samp{deeper}の項目に対してスラッシュが後置されてい
 7756: ますが,オフセットは,最後のスラッシュを用いていない名前を選択している
 7757: ことに注意して下さい.しかし,@command{ls}を
 7758: @option{--escape}(@option{-b}) のようなオプションとともに
 7759: @option{--dired}を用いて呼び出し,特殊文字を含むファイル名を処理する場
 7760: 合,バックスラッシュが含まれる@emph{こと}に注意して下さい.
 7761: 
 7762: @example
 7763: $ touch 'a b'
 7764: $ ls -blog --dired 'a b'
 7765:   -rw-r--r--    1        0 Nov  9 18:41 a\ b
 7766: //DIRED// 40 44
 7767: //DIRED-OPTIONS// --quoting-style=escape
 7768: @end example
 7769: 
 7770: @c If you use a quoting style that adds quote marks
 7771: @c (e.g., @option{--quoting-style=c}), then the offsets include the quote marks.
 7772: @c So beware that the user may select the quoting style via the environment
 7773: @c variable @env{QUOTING_STYLE}.  Hence, applications using @option{--dired}
 7774: @c should either specify an explicit @option{--quoting-style=literal} option
 7775: @c (aka @option{-N} or @option{--literal}) on the command line, or else be
 7776: @c prepared to parse the escaped names.
 7777: @c 
 7778: 引用の印(例えば@option{--quoting-style=c})を追加して,引用形式を使用し
 7779: ている場合,オフセットには引用の印が含まれます.そのため,ユーザが環境
 7780: 変数@env{QUOTING_STYLE}で,引用形式を選択している可能性があることに注
 7781: 意して下さい.このため,@option{--dired}を使用しているアプリケーション
 7782: では,明示的にコマンドラインで@option{--quoting-style=literal}オプショ
 7783: ン(@option{-N}または@option{--literal})を指定する,またはエスケープさ
 7784: れた名前のパーサを用意しておいて下さい.
 7785: 
 7786: @item --full-time
 7787: @opindex --full-time
 7788: @c Produce long format directory listings, and list times in full.  It is
 7789: @c equivalent to using @option{--format=long} with
 7790: @c @option{--time-style=full-iso} (@pxref{Formatting file timestamps}).
 7791: @c 
 7792: 長い形式のディレクトリリストの書式と,完全な時間のリストを生成します.
 7793: @option{--time-style=full-iso}とともに@option{--format=long}を使用する
 7794: ことと等価です(@pxref{Formatting file timestamps}).
 7795: 
 7796: @item -g
 7797: @opindex -g
 7798: @c Produce long format directory listings, but don't display owner information.
 7799: @c 
 7800: 長い書式のディレクトリのリスト表示ですが,所有者の情報は表示しません.
 7801: 
 7802: @item -G
 7803: @itemx --no-group
 7804: @opindex -G
 7805: @opindex --no-group
 7806: @c Inhibit display of group information in a long format directory listing.
 7807: @c (This is the default in some non-@sc{gnu} versions of @command{ls}, so we
 7808: @c provide this option for compatibility.)
 7809: @c 
 7810: 長い書式のディレクトリのリスト表示で,グループ情報の表示を禁止します.
 7811: (これは@sc{gnu}ではないバージョンの@command{ls}ではデフォルトで,我々
 7812: は互換性のためにこのオプションを提供します.)
 7813: 
 7814: @item -h
 7815: @itemx --human-readable
 7816: @opindex -h
 7817: @opindex --human-readable
 7818: @cindex human-readable output
 7819: @c Append a size letter to each size, such as @samp{M} for mebibytes.
 7820: @c Powers of 1024 are used, not 1000; @samp{M} stands for 1,048,576 bytes.
 7821: @c This option is equivalent to @option{--block-size=human} (@pxref{Block size}).
 7822: @c Use the @option{--si} option if you prefer powers of 1000.
 7823: @c 
 7824: それぞれの大きさに,メガバイトに対する@samp{M}のようなサイズ文字を追加
 7825: します.1000倍ではなく1024倍が使用されます.@samp{M}は1,048,576バイト
 7826: を意味します.このオプションは,@option{--block-size=human}と等価です
 7827: (@pxref{Block size}).1000倍を望む場合,@option{--si}オプションを使用
 7828: してください.
 7829: 
 7830: @item -i
 7831: @itemx --inode
 7832: @opindex -i
 7833: @opindex --inode
 7834: @cindex inode number, printing
 7835: @c Print the inode number (also called the file serial number and index
 7836: @c number) of each file to the left of the file name.  (This number
 7837: @c uniquely identifies each file within a particular filesystem.)
 7838: @c 
 7839: それぞれのファイルのinode番号(ファイルシリアル番号とインデックス番号と
 7840: も呼ばれています)を,ファイル名の左に出力します.(この番号は,特定のファ
 7841: イルシステム内の,それぞれのファイルを単一のものとして識別します.)
 7842: 
 7843: @item -l
 7844: @itemx --format=long
 7845: @itemx --format=verbose
 7846: @opindex -l
 7847: @opindex --format
 7848: @opindex long ls @r{format}
 7849: @opindex verbose ls @r{format}
 7850: @c In addition to the name of each file, print the file type, permissions,
 7851: @c number of hard links, owner name, group name, size, and
 7852: @c timestamp (@pxref{Formatting file timestamps}), normally
 7853: @c the modification time.
 7854: @c 
 7855: それぞれのファイル名に加えて,ファイル形式,許可,ハードリンク数,所有
 7856: 者名,バイトのサイズ,そして通常は編集した時間となっているタイムスタン
 7857: プ(@pxref{Formatting file timestamps})を出力します.
 7858: 
 7859: @c Normally the size is printed as a byte count without punctuation, but
 7860: @c this can be overridden (@pxref{Block size}).  For example, @option{-h}
 7861: @c prints an abbreviated, human-readable count, and
 7862: @c @samp{--block-size="'1"} prints a byte count with the thousands
 7863: @c separator of the current locale.
 7864: @c 
 7865: 通常,サイズは句読点を用いずバイト数を出力しますが,これは優先可能です
 7866: (@pxref{Block size}).例えば,@option{-h}では,人間が読み易い省略した
 7867: ものを出力し,@samp{--block-size="'1"}は,現在のロケールで千単位で分離
 7868: してバイト数を出力します.
 7869: 
 7870: @c For each directory that is listed, preface the files with a line
 7871: @c @samp{total @var{blocks}}, where @var{blocks} is the total disk allocation
 7872: @c for all files in that directory.  The block size currently defaults to 1024
 7873: @c bytes, but this can be overridden (@pxref{Block size}).
 7874: @c The @var{blocks} computed counts each hard link separately;
 7875: @c this is arguably a deficiency.
 7876: @c 
 7877: リストアップされているそれぞれのディレクトリに対し,@samp{total
 7878: @var{blocks}}という行をファイルに前置し,そこでの@var{blocks}は,その
 7879: ディレクトリの全てのファイルに対する全体的なディスク占有量です.ブロッ
 7880: クサイズは,現在デフォルトで1024バイトですが,これに優先させることが可
 7881: 能です(@pxref{Block size}).@var{blocks}は,それぞれのハードリンクを別々
 7882: に数えて計算します.これはおそらく欠陥です.
 7883: 
 7884: @cindex permissions, output by @command{ls}
 7885: @c The permissions listed are similar to symbolic mode specifications
 7886: @c (@pxref{Symbolic Modes}).  But @command{ls} combines multiple bits into the
 7887: @c third character of each set of permissions as follows:
 7888: @c 
 7889: リストアップされる許可は,象徴的なモードでの指定に似ています
 7890: (@pxref{Symbolic Modes}).しかし,@command{ls}は,それぞれの許可の設定
 7891: を複数のビットを三番目の文字に組み合わせ,以下のようにします.
 7892: @table @samp
 7893: @item s
 7894: @c If the setuid or setgid bit and the corresponding executable bit
 7895: @c are both set.
 7896: @c 
 7897: setuidやsetgidビットと対応する実行可能ビットが,両方設定されている場合.
 7898: 
 7899: @item S
 7900: @c If the setuid or setgid bit is set but the corresponding executable bit
 7901: @c is not set.
 7902: @c 
 7903: setuidやsetgidビットは設定されているが,対応する実行可能ビットが設定さ
 7904: れていない場合.
 7905: 
 7906: @item t
 7907: @c If the sticky bit and the other-executable bit are both set.
 7908: @c 
 7909: stickyビットとotherの実行可能ビットが両方設定されている場合.
 7910: 
 7911: @item T
 7912: @c If the sticky bit is set but the other-executable bit is not set.
 7913: @c 
 7914: stickyビットは設定されているが,otherの実行可能ビットが設定されていな
 7915: い場合.
 7916: 
 7917: @item x
 7918: @c If the executable bit is set and none of the above apply.
 7919: @c 
 7920: 実行可能ビットが設定されていて,上記は何も適応されない場合.
 7921: 
 7922: @item -
 7923: @c Otherwise.
 7924: @c 
 7925: それ以外.
 7926: @end table
 7927: 
 7928: @c Following the permission bits is a single character that specifies
 7929: @c whether an alternate access method applies to the file.  When that
 7930: @c character is a space, there is no alternate access method.  When it
 7931: @c is a printing character (e.g., @samp{+}), then there is such a method.
 7932: @c 
 7933: 許可ビットに続くものは,ファイルに適用するアクセス手法の変更を指定する
 7934: 単一の文字です.文字がスペースのとき,アクセス手法の変更はありません.
 7935: 印刷可能な文字(例えば@samp{+})のとき,そのような手法があります.
 7936: 
 7937: @item -n
 7938: @itemx --numeric-uid-gid
 7939: @opindex -n
 7940: @opindex --numeric-uid-gid
 7941: @cindex numeric uid and gid
 7942: @c Produce long format directory listings, but
 7943: @c display numeric UIDs and GIDs instead of the owner and group names.
 7944: @c 
 7945: 長い書式でディレクトリのリストを生成しますが,所有者とグループの名前の
 7946: 代わりに数値のUIDとGIDをリストアップします.
 7947: 
 7948: @item -o
 7949: @opindex -o
 7950: @c Produce long format directory listings, but don't display group information.
 7951: @c It is equivalent to using @option{--format=long} with @option{--no-group} .
 7952: @c 
 7953: 長いディレクトリのリストの書式を生成しますが,グループ情報は表示しませ
 7954: ん.それは,@option{--no-group}を用いた@option{--format=long}の使用と
 7955: 同じです.
 7956: 
 7957: @item -s
 7958: @itemx --size
 7959: @opindex -s
 7960: @opindex --size
 7961: @cindex disk allocation
 7962: @cindex size of files, reporting
 7963: @c Print the disk allocation of each file to the left of the file name.
 7964: @c This is the amount of disk space used by the file, which is usually a
 7965: @c bit more than the file's size, but it can be less if the file has holes.
 7966: @c 
 7967: ファイル名の左側に,それぞれのファイルのディスク占有量を出力します.こ
 7968: れは,ファイルが使用しているディスクスペースの総量で,それは通常ファイ
 7969: ルサイズよりわずかに多くなりますが,ファイルに欠陥がある場合は,より小
 7970: さくなるはずです.
 7971: 
 7972: @c Normally the disk allocation is printed in units of
 7973: @c 1024 bytes, but this can be overridden (@pxref{Block size}).
 7974: @c 
 7975: 通常ディスクの占有量は1024バイト単位で出力されますが,これに優先させる
 7976: ことが可能です(@pxref{Block size}).
 7977: 
 7978: @cindex NFS mounts from BSD to HP-UX
 7979: @c For files that are NFS-mounted from an HP-UX system to a BSD system,
 7980: @c this option reports sizes that are half the correct values.  On HP-UX
 7981: @c systems, it reports sizes that are twice the correct values for files
 7982: @c that are NFS-mounted from BSD systems.  This is due to a flaw in HP-UX;
 7983: @c it also affects the HP-UX @command{ls} program.
 7984: @c 
 7985: HP-UXシステムからBSDシステムに,NFSでマウントされているファイルに対し,
 7986: このオプションは,正しい値の半分のサイズを報告します.HP-UXシステムで
 7987: は,BSDシステムからNFSでマウントされているファイルに対し,正しい値の2
 7988: 倍のサイズを報告します.これは,HP-UXの欠点のためです.それはHP-UXの
 7989: @command{ls}プログラムにも影響します.
 7990: 
 7991: @itemx --si
 7992: @opindex --si
 7993: @cindex SI output
 7994: @c Append an SI-style abbreviation to each size, such as @samp{MB} for
 7995: @c megabytes.  Powers of 1000 are used, not 1024; @samp{MB} stands for
 7996: @c 1,000,000 bytes.  This option is equivalent to
 7997: @c @option{--block-size=si}.  Use the @option{-h} or
 7998: @c @option{--human-readable} option if
 7999: @c you prefer powers of 1024.
 8000: @c 
 8001: それぞれの大きさに,メガバイトに対する@samp{MB}のようなSI形式のサイズ
 8002: の略語を追加します.1024倍ではなく1000倍が使用されます.@samp{MB}は
 8003: 1,000,000バイトを意味します.このオプションは@option{--block-size=si}
 8004: と等価です.1024倍を望む場合,@option{-h}または
 8005: @option{--human-readable}オプションを使用してください.
 8006: 
 8007: @end table
 8008: 
 8009: 
 8010: @node Sorting the output
 8011: @c @subsection Sorting the output
 8012: @subsection 出力の並べ替え
 8013: 
 8014: @cindex sorting @command{ls} output
 8015: @c These options change the order in which @command{ls} sorts the information
 8016: @c it outputs.  By default, sorting is done by character code
 8017: @c (e.g., @acronym{ASCII} order).
 8018: @c 
 8019: これらのオプションは,@command{ls}が並べ替える出力の情報の順序を変更し
 8020: ます.デフォルトで,並べ替えは文字コードによって行われます(例えば,
 8021: ASCIIの順番です).
 8022: 
 8023: @table @samp
 8024: 
 8025: @item -c
 8026: @itemx --time=ctime
 8027: @itemx --time=status
 8028: @itemx --time=use
 8029: @opindex -c
 8030: @opindex --time
 8031: @opindex ctime@r{, printing or sorting by}
 8032: @opindex status time@r{, printing or sorting by}
 8033: @opindex use time@r{, printing or sorting files by}
 8034: @c If the long listing format (e.g., @option{-l}, @option{-o}) is being used,
 8035: @c print the status change time (the @samp{ctime} in the inode) instead of
 8036: @c the modification time.
 8037: @c When explicitly sorting by time (@option{--sort=time} or @option{-t})
 8038: @c or when not using a long listing format,
 8039: @c sort according to the status change time.
 8040: @c 
 8041: 長いリスト書式(例えば,@option{-l},@option{-o})が使用されている場合,
 8042: 編集時間の代わりにステータス変更時間(inodeの@samp{ctime})が出力されま
 8043: す.時間(@option{--sort=time}または@option{-t})で明示的に並べ替えをし
 8044: たり,長いリストの書式を使用しないとき,ステータスの変更時間によって並
 8045: べ替えます.
 8046: 
 8047: @item -f
 8048: @opindex -f
 8049: @cindex unsorted directory listing
 8050: @cindex directory order, listing by
 8051: @c Primarily, like @option{-U}---do not sort; list the files in whatever
 8052: @c order they are stored in the directory.  But also enable @option{-a} (list
 8053: @c all files) and disable @option{-l}, @option{--color}, and @option{-s} (if they
 8054: @c were specified before the @option{-f}).
 8055: @c 
 8056: 主に,@option{-U}に似ています --- 並べ替えしません.ディレクトリに保存
 8057: されているファイルの順番に,それらをリストアップします.しかし,
 8058: @option{-a}(すべてのファイルをリストアップ)も利用可能で,(前に
 8059: @option{-f}が指定されている場合)@option{-l},@option{--color},そして
 8060: @option{-s}は利用不可能です.
 8061: 
 8062: @item -r
 8063: @itemx --reverse
 8064: @opindex -r
 8065: @opindex --reverse
 8066: @cindex reverse sorting
 8067: @c Reverse whatever the sorting method is---e.g., list files in reverse
 8068: @c alphabetical order, youngest first, smallest first, or whatever.
 8069: @c 
 8070: 並べ替えのあらゆる手法を反転します --- 例えば,アルファベットの逆順,
 8071: 新しいものを最初,小さいものを最初,またはすべて逆順にリストアップしま
 8072: す.
 8073: 
 8074: @item -S
 8075: @itemx --sort=size
 8076: @opindex -S
 8077: @opindex --sort
 8078: @opindex size of files@r{, sorting files by}
 8079: @c Sort by file size, largest first.
 8080: @c 
 8081: ファイルサイズで,大きいものを最初にして並べ替えます.
 8082: 
 8083: @item -t
 8084: @itemx --sort=time
 8085: @opindex -t
 8086: @opindex --sort
 8087: @opindex modification time@r{, sorting files by}
 8088: @c Sort by modification time (the @samp{mtime} in the inode), newest first.
 8089: @c 
 8090: 編集時間(inodeの@samp{mtime})で,新しいものを最初にして並べ替えます.
 8091: 
 8092: @item -u
 8093: @itemx --time=atime
 8094: @itemx --time=access
 8095: @opindex -u
 8096: @opindex --time
 8097: @opindex use time@r{, printing or sorting files by}
 8098: @opindex atime@r{, printing or sorting files by}
 8099: @opindex access time@r{, printing or sorting files by}
 8100: @c If the long listing format (e.g., @option{--format=long}) is being used,
 8101: @c print the last access time (the @samp{atime} in the inode).
 8102: @c When explicitly sorting by time (@option{--sort=time} or @option{-t})
 8103: @c or when not using a long listing format, sort according to the access time.
 8104: @c 
 8105: 長いリスト書式(例えば,@option{--format=long})が使用されている場合,最
 8106: 後にアクセスした時間(inodeの@samp{atime})が出力されます.時間
 8107: (@option{--sort=time}または@option{-t})で明示的に並べ替えをしたり,長
 8108: いリストの書式を使用しないとき,アクセスした時間によって並べ替えます.
 8109: 
 8110: @item -U
 8111: @itemx --sort=none
 8112: @opindex -U
 8113: @opindex --sort
 8114: @opindex none@r{, sorting option for @command{ls}}
 8115: @c Do not sort; list the files in whatever order they are
 8116: @c stored in the directory.  (Do not do any of the other unrelated things
 8117: @c that @option{-f} does.)  This is especially useful when listing very large
 8118: @c directories, since not doing any sorting can be noticeably faster.
 8119: @c 
 8120: 並べ替えしません.ディレクトリに保存されている順番にファイルをリストアッ
 8121: プします.(@option{-f}が行う,他と関連することは何もしません.) 並べ替
 8122: えを行わないことで,目立って速くすることが可能なので,非常に大きなディ
 8123: レクトリをリストアップするとき,これは特に便利です.
 8124: 
 8125: @item -v
 8126: @itemx --sort=version
 8127: @opindex -v
 8128: @opindex --sort
 8129: @opindex version@r{, sorting option for @command{ls}}
 8130: @c Sort by version name and number, lowest first.  It behaves like a default
 8131: @c sort, except that each sequence of decimal digits is treated numerically
 8132: @c as an index/version number.  (@xref{More details about version sort}.)
 8133: @c 
 8134: バージョン名と数字で,小さいものを最初にして並べ替えます.それはデフォ
 8135: ルトの並べ替えに似ている動作で,それぞれの10進数の並びが,索引/バージョ
 8136: ン番号として数値的に扱われることが期待されます.(@xref{More details
 8137: about version sort}.)
 8138: 
 8139: @item -X
 8140: @itemx --sort=extension
 8141: @opindex -X
 8142: @opindex --sort
 8143: @opindex extension@r{, sorting files by}
 8144: @c Sort directory contents alphabetically by file extension (characters
 8145: @c after the last @samp{.}); files with no extension are sorted first.
 8146: @c 
 8147: ディレクトリの内容を,ファイルの拡張子(最後の@samp{.}の後の文字)で,ア
 8148: ルファベット順に並べ替えます.ファイルの拡張子がないものが最初になりま
 8149: す.
 8150: 
 8151: @end table
 8152: 
 8153: 
 8154: @node More details about version sort
 8155: @c @subsection More details about version sort
 8156: @subsection バージョンの並べ替えの詳細
 8157: 
 8158: @c The version sort takes into account the fact that file names frequently include
 8159: @c indices or version numbers.  Standard sorting functions usually do not produce
 8160: @c the ordering that people expect because comparisons are made on a
 8161: @c character-by-character basis.  The version
 8162: @c sort addresses this problem, and is especially useful when browsing
 8163: @c directories that contain many files with indices/version numbers in their
 8164: @c names:
 8165: @c 
 8166: バージョンの並べ替えは,ファイル名が索引やバージョン番号を含むことが多
 8167: いという事実を考慮にいれています.標準的な並べ替え機能は,一文字づつを
 8168: 基本に比較するため,通常,人々が期待する順序を生成しません.バージョン
 8169: の並べ替えは,この問題を提出し,その名前に索引/バージョン番号を伴うファ
 8170: イルを多く含むディレクトリを眺めるとき特に役に立ちます.
 8171: 
 8172: @example
 8173:       > ls -1            > ls -1v
 8174:       foo.zml-1.gz       foo.zml-1.gz
 8175:       foo.zml-100.gz     foo.zml-2.gz
 8176:       foo.zml-12.gz      foo.zml-6.gz
 8177:       foo.zml-13.gz      foo.zml-12.gz
 8178:       foo.zml-2.gz       foo.zml-13.gz
 8179:       foo.zml-25.gz      foo.zml-25.gz
 8180:       foo.zml-6.gz       foo.zml-100.gz
 8181: @end example
 8182: 
 8183: @c Note also that numeric parts with leading zeroes are considered as
 8184: @c fractional one:
 8185: @c 
 8186: 数字の部分にゼロが前置されていても,分数として考慮されることに注意して
 8187: 下さい.
 8188: 
 8189: @example
 8190:       > ls -1            > ls -1v
 8191:       abc-1.007.tgz      abc-1.007.tgz
 8192:       abc-1.012b.tgz     abc-1.01a.tgz
 8193:       abc-1.01a.tgz      abc-1.012b.tgz
 8194: @end example
 8195: 
 8196: @node General output formatting
 8197: @c @subsection General output formatting
 8198: @subsection 一般的な出力書式
 8199: 
 8200: @c These options affect the appearance of the overall output.
 8201: @c 
 8202: これらのオプションは,出力の外観に影響します.
 8203: 
 8204: @table @samp
 8205: 
 8206: @item -1
 8207: @itemx --format=single-column
 8208: @opindex -1
 8209: @opindex --format
 8210: @opindex single-column @r{output of files}
 8211: @c List one file per line.  This is the default for @command{ls} when standard
 8212: @c output is not a terminal.
 8213: @c 
 8214: ファイルを一行ごとにリストアップします.これは,標準出力が端末でないと
 8215: きのデフォルトです.
 8216: 
 8217: @item -C
 8218: @itemx --format=vertical
 8219: @opindex -C
 8220: @opindex --format
 8221: @opindex vertical @r{sorted files in columns}
 8222: @c List files in columns, sorted vertically.  This is the default for
 8223: @c @command{ls} if standard output is a terminal.  It is always the default
 8224: @c for the @command{dir} and @command{d} programs.
 8225: @c @sc{gnu} @command{ls} uses variable width columns to display as many files as
 8226: @c possible in the fewest lines.
 8227: @c 
 8228: 列で縦方向に並べ替えされてリストアップされます.標準出力が端末の場合,
 8229: これはデフォルトです.@command{dir}と@code{d}プログラムに対し,それは
 8230: 常にデフォルトです.@sc{gnu} @command{ls}は,最も少ない行で可能な限り
 8231: 多くのファイルを表示できるように,列の幅を変更して使用します.
 8232: 
 8233: @item --color [=@var{when}]
 8234: @opindex --color
 8235: @cindex color, distinguishing file types with
 8236: @c Specify whether to use color for distinguishing file types.  @var{when}
 8237: @c may be omitted, or one of:
 8238: @c 
 8239: ファイル形式を区別するため使用する色を指定します.@var{when}は省略され
 8240: る,または以下の一つになります.
 8241: @itemize @bullet
 8242: @item none
 8243: @vindex none @r{color option}
 8244: @c - Do not use color at all.  This is the default.
 8245: @c 
 8246: - 色を全く使用しません.これはデフォルトです.
 8247: @item auto
 8248: @vindex auto @r{color option}
 8249: @cindex terminal, using color iff
 8250: @c - Only use color if standard output is a terminal.
 8251: @c 
 8252: - 標準出力が端末の場合のみ色を使用します.
 8253: @item always
 8254: @vindex always @r{color option}
 8255: @c - Always use color.
 8256: @c 
 8257: - 常に色を使用します.
 8258: @end itemize
 8259: @c Specifying @option{--color} and no @var{when} is equivalent to
 8260: @c @option{--color=always}.
 8261: @c Piping a colorized listing through a pager like @command{more} or
 8262: @c @command{less} usually produces unreadable results.  However, using
 8263: @c @code{more -f} does seem to work.
 8264: @c 
 8265: @option{--color}を指定し@var{when}が無いのは,@option{--color=always}
 8266: と同じです.色付きのリストを@command{more}や@command{less}の様なページャ
 8267: にパイプで渡すと,通常読むことができない結果を生成します.しかし,
 8268: @code{more -f}を使用すると動作するでしょう.
 8269: 
 8270: @item -F
 8271: @itemx --classify
 8272: @itemx --indicator-style=classify
 8273: @opindex -F
 8274: @opindex --classify
 8275: @opindex --indicator-style
 8276: @cindex file type and executables, marking
 8277: @cindex executables and file type, marking
 8278: @c Append a character to each file name indicating the file type.  Also,
 8279: @c for regular files that are executable, append @samp{*}.  The file type
 8280: @c indicators are @samp{/} for directories, @samp{@@} for symbolic links,
 8281: @c @samp{|} for FIFOs, @samp{=} for sockets, and nothing for regular files.
 8282: @c 
 8283: ファイル形式を示す文字を,それぞれのファイル名に追加します.また,実行
 8284: 可能な標準ファイルに対し,@samp{*}を加えます.ファイル形式表示子は,ディ
 8285: レクトリに対する@samp{/},シンボリックリンクに対する@samp{@@},FIFOに
 8286: 対する@samp{|},ソケットに対する@samp{=}で,標準ファイルは何もありませ
 8287: ん.
 8288: @c The following sentence is the same as the one for -d.
 8289: @c 
 8290: @c Do not follow symbolic links listed on the
 8291: @c command line unless the @option{--dereference-command-line} (@option{-H}),
 8292: @c @option{--dereference} (@option{-L}), or
 8293: @c @option{--dereference-command-line-symlink-to-dir} options are specified.
 8294: @c 
 8295: @option{--dereference-command-line} (@option{-H}),
 8296: @option{--dereference} (@option{-L}),または
 8297: @option{--dereference-command-line-symlink-to-dir}オプションが指定され
 8298: ていない限り,コマンドラインでリストアップされているシンボリックリンク
 8299: をたどりません.
 8300: 
 8301: @item --indicator-style=@var{word}
 8302: @opindex --indicator-style
 8303: @c Append a character indicator with style @var{word} to entry names,
 8304: @c as follows:
 8305: @c 
 8306: エントリー名にスタイル@var{word}文字表示子を以下のように追加します.
 8307: @table @samp
 8308: @item none
 8309: @c Do not append any character indicator; this is the default.
 8310: @c 
 8311: あらゆる文字表示子を追加しません.これはデフォルトです.
 8312: @item file-type
 8313: @c Append @samp{/} for directories, @samp{@@} for symbolic links, @samp{|}
 8314: @c for FIFOs, @samp{=} for sockets, and nothing for regular files.  This is
 8315: @c the same as the @option{-p} or @option{--file-type} option.
 8316: @c 
 8317: ディレクトリに対し@samp{/},シンボリックリンクに対し@samp{@@},FIFOに
 8318: 対し@samp{|},ソケットに対し@samp{=}を追加し,標準ファイルには何も追加
 8319: しません.これは@option{-p}や@option{--file-type}オプションと同じです.
 8320: @item classify
 8321: @c Append @samp{*} for executable regular files, otherwise behave as for
 8322: @c @samp{file-type}.  This is the same as the @option{-F} or
 8323: @c @option{--classify} option.
 8324: @c 
 8325: 実行可能な標準ファイルに@samp{*}を加え,それ以外は@samp{file-type}とし
 8326: て動作します.これは,@option{-F}や@option{--classify}オプションと同じ
 8327: です.
 8328: @end table
 8329: 
 8330: @item -k
 8331: @opindex -k
 8332: @c Print file sizes in 1024-byte blocks, overriding the default block
 8333: @c size (@pxref{Block size}).
 8334: @c This option is equivalent to @option{--block-size=1K}.
 8335: @c 
 8336: ファイルの大きさを1024バイトブロックで出力し,デフォルトのブロックサイ
 8337: ズ(@pxref{Block size})に優先します.
 8338: 
 8339: @item -m
 8340: @itemx --format=commas
 8341: @opindex -m
 8342: @opindex --format
 8343: @opindex commas@r{, outputting between files}
 8344: @c List files horizontally, with as many as will fit on each line,
 8345: @c separated by @samp{, } (a comma and a space).
 8346: @c 
 8347: それぞれの行にできるだけ多くフィットするように,@samp{, } (カンマとス
 8348: ペース)で分けて,水平方向にリストアップします.
 8349: 
 8350: @item -p
 8351: @itemx --file-type
 8352: @itemx --indicator-style=file-type
 8353: @opindex --file-type
 8354: @opindex --indicator-style
 8355: @cindex file type, marking
 8356: @c Append a character to each file name indicating the file type. This is
 8357: @c like @option{-F}, except that executables are not marked.
 8358: @c 
 8359: それぞれのファイル名にファイル形式を示す文字を追加します.これは
 8360: @option{-F}に似ていますが,実行可能なものは印を付けません.
 8361: 
 8362: @item -x @var{format}
 8363: @itemx --format=across
 8364: @itemx --format=horizontal
 8365: @opindex -x
 8366: @opindex --format
 8367: @opindex across@r{, listing files}
 8368: @opindex horizontal@r{, listing files}
 8369: @c List the files in columns, sorted horizontally.
 8370: @c 
 8371: ファイルを列に,水平にソートしてリストアップします.
 8372: 
 8373: @item -T @var{cols}
 8374: @itemx --tabsize=@var{cols}
 8375: @opindex -T
 8376: @opindex --tabsize
 8377: @c Assume that each tabstop is @var{cols} columns wide.  The default is 8.
 8378: @c @command{ls} uses tabs where possible in the output, for efficiency.  If
 8379: @c @var{cols} is zero, do not use tabs at all.
 8380: @c 
 8381: それぞれのタブストップが@var{cols}列の幅だと考えます.デフォルトは8で
 8382: す.@command{ls}は,効率のために出力可能なところではタブを使用します.
 8383: @var{cols}が0の場合はタブを全く使用しません.
 8384: 
 8385: @item -w
 8386: @itemx --width=@var{cols}
 8387: @opindex -w
 8388: @opindex --width
 8389: @vindex COLUMNS
 8390: @c Assume the screen is @var{cols} columns wide.  The default is taken
 8391: @c from the terminal settings if possible; otherwise the environment
 8392: @c variable @env{COLUMNS} is used if it is set; otherwise the default
 8393: @c is 80.
 8394: @c 
 8395: 画面が@var{cols}列の幅だと考えます.可能な場合,デフォルトは端末の設定
 8396: で与えられます.それ以外で,環境変数@env{COLUMNS}が設定されている場合,
 8397: それが使用されます.それ以外の場合,デフォルトの80です.
 8398: 
 8399: @end table
 8400: 
 8401: 
 8402: @node Formatting file timestamps
 8403: @c @subsection Formatting file timestamps
 8404: @subsection ファイルのタイムスタンプの書式化
 8405: 
 8406: @c By default, file timestamps are listed in abbreviated form.  Most
 8407: @c locales use a timestamp like @samp{2002-03-30 23:45}.  However, the
 8408: @c default @acronym{POSIX} locale uses a date like @samp{Mar 30@ @ 2002}
 8409: @c for non-recent timestamps, and a date-without-year and time like
 8410: @c @samp{Mar 30 23:45} for recent timestamps.
 8411: @c 
 8412: デフォルトで,ファイルのタイムスタンプは短縮した様式でリストアップされ
 8413: ます.ほとんどのロケールで@samp{2002-03-30 23:45}のようなタイムスタン
 8414: プが使用されます.しかし,デフォルトの@acronym{POSIX}ロケールでは,昔
 8415: のタイムスタンプに対し@samp{Mar 30@ @ 2002}のような日付を使用し,最近
 8416: のタイムスタンプに対し,@samp{Mar 30 23:45}のように年が無い日付と時間
 8417: を使用します.
 8418: 
 8419: @c A timestamp is considered to be @dfn{recent} if it is less than six
 8420: @c months old, and is not dated in the future.  If a timestamp dated
 8421: @c today is not listed in recent form, the timestamp is in the future,
 8422: @c which means you probably have clock skew problems which may break
 8423: @c programs like @command{make} that rely on file timestamps.
 8424: @c 
 8425: タイムスタンプは,六カ月未満のものを@dfn{最近のもの(recent)}と考え,未
 8426: 来のものは日付がつきません.タイムスタンプが今日の場合は,最近のものの
 8427: 形式でリストアップされず,タイムスタンプが未来のものは,おそらく時間の
 8428: 歪みの問題があることを意味し,@command{make}のようにファイルのタイムス
 8429: タンプに依存しているプログラムでは問題になる可能性があります.
 8430: 
 8431: @c The following option changes how file timestamps are printed.
 8432: @c 
 8433: 以下のオプションで,ファイルのタイムスタンプを出力する方法を変更します.
 8434: 
 8435: @table @samp
 8436: @item --time-style=@var{style}
 8437: @opindex --time-style
 8438: @cindex time style
 8439: @c List timestamps in style @var{style}.  The @var{style} should
 8440: @c be one of the following:
 8441: @c 
 8442: タイムスタンプを@var{style}の形式でリストアップします.@var{style}は以
 8443: 下の一つにします.
 8444: 
 8445: @table @samp
 8446: @item +@var{format}
 8447: @vindex LC_TIME
 8448: @c List timestamps using @var{format}, where @var{format} is interpreted
 8449: @c like the format argument of @command{date} (@pxref{date invocation}).
 8450: @c For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes
 8451: @c @command{ls} to list timestamps like @samp{2002-03-30 23:45:56}.  As
 8452: @c with @command{date}, @var{format}'s interpretation is affected by the
 8453: @c @env{LC_TIME} locale category.
 8454: @c 
 8455: @var{format}を使用してタイムスタンプをリストアップし,@var{format}は
 8456: @command{date}の書式化引数のように解釈されます(@pxref{date
 8457: invocation}).例えば,@option{--time-style="+%Y-%m-%d %H:%M:%S"}で
 8458: @command{ls}は@samp{2002-03-30 23:45:56}のようにタイムスタンプをリスト
 8459: アップします.@command{date}同様,@var{format}の解釈では@env{LC_TIME} 
 8460: ロケールカテゴリの影響を受けます.
 8461: 
 8462: @c If @var{format} contains two format strings separated by a newline,
 8463: @c the former is used for non-recent files and the latter for recent
 8464: @c files; if you want output columns to line up, you may need to insert
 8465: @c spaces in one of the two formats.
 8466: @c 
 8467: @var{format}に二つの書式化文字列が,改行で分けられて存在する場合,前者
 8468: は最近のものではないファイルに使用され,後者は最近のファイルに使用され
 8469: ます.出力列を並べたい場合,二つの書式の一つにスペースを挿入する必要が
 8470: あるかもしれません.
 8471: 
 8472: @item full-iso
 8473: @c List timestamps in full using @acronym{ISO} 8601 date, time, and time zone
 8474: @c format with nanosecond precision, e.g., @samp{2002-03-30
 8475: @c 23:45:56.477817180 -0700}.  This style is equivalent to
 8476: @c @samp{+%Y-%m-%d %H:%M:%S.%N %z}.
 8477: @c 
 8478: 完全な@acronym{ISO} 8601の日付,時間,タイムゾーンを,ナノ秒の精度を使
 8479: 用してタイムスタンプをリストアップし,例えば,@samp{2002-03-30
 8480: 23:45:56.477817180 -0700}のようにします.この形式は@samp{+%Y-%m-%d
 8481: %H:%M:%S.%N %z}と等価です.
 8482: 
 8483: @c This is useful because the time output includes all the information that
 8484: @c is available from the operating system.  For example, this can help
 8485: @c explain @command{make}'s behavior, since @acronym{GNU} @command{make}
 8486: @c uses the full timestamp to determine whether a file is out of date.
 8487: @c 
 8488: オペレーティングシステムで利用可能なすべての情報を含んでいる時間の出力
 8489: になるので,これは役に立ちます.例えば,ファイルが最新かどうかを決定す
 8490: るため,@acronym{GNU} @command{make}は完全なタイムスタンプを使用するの
 8491: で,@command{make}の動作を解釈する助けとなります.
 8492: 
 8493: @item long-iso
 8494: @c List @acronym{ISO} 8601 date and time in minutes, e.g.,
 8495: @c @samp{2002-03-30 23:45}.  These timestamps are shorter than
 8496: @c @samp{full-iso} timestamps, and are usually good enough for everyday
 8497: @c work.  This style is equivalent to @samp{%Y-%m-%d %H:%M}.
 8498: @c 
 8499: @acronym{ISO} 8601の日付,分単位の時間でリストアップし,例えば,
 8500: @samp{2002-03-30 23:45}のようにします.これらのタイムスタンプは,
 8501: @samp{full-iso}のタイムスタンプより短く,毎日の作業では通常十分に利用
 8502: できるものです.この形式は@samp{%Y-%m-%d %H:%M}と等価です.
 8503: 
 8504: @item iso
 8505: @c List @acronym{ISO} 8601 dates for non-recent timestamps (e.g.,
 8506: @c @samp{2002-03-30@ }), and @acronym{ISO} 8601 month, day, hour, and
 8507: @c minute for recent timestamps (e.g., @samp{03-30 23:45}).  These
 8508: @c timestamps are uglier than @samp{long-iso} timestamps, but they carry
 8509: @c nearly the same information in a smaller space and their brevity helps
 8510: @c @command{ls} output fit within traditional 80-column output lines.
 8511: @c The following two @command{ls} invocations are equivalent:
 8512: @c 
 8513: 最近のものではないタイムスタンプは@acronym{ISO} 8601(例えば,
 8514: @samp{2002-03-30@ })で,最近のものは,月,日,時間,そして分でリストアッ
 8515: プします(例えば,@samp{03-30 23:45}).これらのタイムスタンプは,
 8516: @samp{long-iso}のタイムスタンプより悪くなりますが,より小さなスペース
 8517: で同じ情報を提供し,また簡潔なので@command{ls}の出力は伝統的な80列の出
 8518: 力行に適しています.以下の二つの@command{ls}の呼び出しは等価です.
 8519: 
 8520: @example
 8521: newline='
 8522: '
 8523: ls -l --time-style="+%Y-%m-%d $newline%m-%d %H:%M"
 8524: ls -l --time-style="iso"
 8525: @end example
 8526: 
 8527: @item locale
 8528: @vindex LC_TIME
 8529: @c List timestamps in a locale-dependent form.  For example, a Finnish
 8530: @c locale might list non-recent timestamps like @samp{maalis 30@ @ 2002}
 8531: @c and recent timestamps like @samp{maalis 30 23:45}.  Locale-dependent
 8532: @c timestamps typically consume more space than @samp{iso} timestamps and
 8533: @c are harder for programs to parse because locale conventions vary so
 8534: @c widely, but they are easier for many people to read.
 8535: @c 
 8536: タイムスタンプをロケール依存の様式でリストアップします.例えば,フィン
 8537: ランドのロケールでは,最近のものではないタイムスタンプを@samp{maalis
 8538: 30@ @ 2002}のように,そして最近のもののタイムスタンプを@samp{maalis 30
 8539: 23:45}のようにリストアップするでしょう.ロケール依存のタイムスタンプは,
 8540: 通常,@samp{iso}のタイムスタンプよりスペースを使用し,また,ロケールの
 8541: 慣習は幅広く,プログラムでパースするのはより難しくなりますが,多くの人々
 8542: はそれで読み易くなります.
 8543: 
 8544: @c The @env{LC_TIME} locale category specifies the timestamp format.  The
 8545: @c default @acronym{POSIX} locale uses timestamps like @samp{Mar 30@
 8546: @c @ 2002} and @samp{Mar 30 23:45}; in this locale, the following two
 8547: @c @command{ls} invocations are equivalent:
 8548: @c 
 8549: @env{LC_TIME}ロケールカテゴリはタイムスタンプの書式を指定します.デフォ
 8550: ルトの@acronym{POSIX}ロケールは,@samp{Mar 30@ 2002}と@samp{Mar 30
 8551: 23:45}のようなタイムスタンプを使用します.このロケールでは,以下の二つ
 8552: の@command{ls}の呼び出しは等価です.
 8553: 
 8554: @example
 8555: newline='
 8556: '
 8557: ls -l --time-style="+%b %e  %Y$newline%b %e %H:%M"
 8558: ls -l --time-style="locale"
 8559: @end example
 8560: 
 8561: @c Other locales behave differently.  For example, in a German locale,
 8562: @c @option{--time-style="locale"} might be equivalent to
 8563: @c @option{--time-style="+%e. %b %Y $newline%e. %b %H:%M"}
 8564: @c and might generate timestamps like @samp{30. M@"ar 2002@ } and
 8565: @c @samp{30. M@"ar 23:45}.
 8566: @c 
 8567: それ以外のロケールでは動作は異なります.例えばドイツのロケールでは,
 8568: @option{--time-style="locale"}は@option{--time-style="+%e. %b %Y
 8569: $newline%e. %b %H:%M"}と等価で,@samp{30. M@"ar 2002@ }と
 8570: @samp{30. M@"ar 23:45}のようなタイムスタンプを生成するでしょう.
 8571: 
 8572: @item posix-@var{style}
 8573: @vindex LC_TIME
 8574: @c List @acronym{POSIX}-locale timestamps if the @env{LC_TIME} locale
 8575: @c category is @acronym{POSIX}, @var{style} timestamps otherwise.  For
 8576: @c example, the default style, which is @samp{posix-long-iso}, lists
 8577: @c timestamps like @samp{Mar 30@ @ 2002} and @samp{Mar 30 23:45} when in
 8578: @c the @acronym{POSIX} locale, and like @samp{2002-03-30 23:45} otherwise.
 8579: @c 
 8580: @env{LC_TIME}ロケールが@acronym{POSIX}の場合,タイムスタンプを
 8581: @acronym{POSIX}ロケールで,それ以外では@var{style}のタイムスタンプでリ
 8582: ストアップします.例えば,デフォルトのスタイル@samp{posix-long-iso}で
 8583: は,@acronym{POSIX}ロケールのときは,@samp{Mar 30@ @ 2002}と@samp{Mar
 8584: 30 23:45}のようなタイムスタンプで,それ以外では@samp{2002-03-30 23:45} 
 8585: のようなタイムスタンプでリストアップします.
 8586: 
 8587: @end table
 8588: @end table
 8589: 
 8590: @vindex TIME_STYLE
 8591: @c You can specify the default value of the @option{--time-style} option
 8592: @c with the environment variable @env{TIME_STYLE}; if @env{TIME_STYLE} is not set
 8593: @c the default style is @samp{posix-long-iso}.  @acronym{GNU} Emacs 21 and
 8594: @c later can parse @acronym{ISO} dates, but older Emacs versions do not, so if
 8595: @c you are using an older version of Emacs and specify a non-@acronym{POSIX}
 8596: @c locale, you may need to set @samp{TIME_STYLE="locale"}.
 8597: @c 
 8598: @option{--time-style}オプションのデフォルト値を,環境変数
 8599: @env{TIME_STYLE}を用いて指定することが可能です.@env{TIME_STYLE}が設定
 8600: されていない場合,デフォルトのスタイルは@samp{posix-long-iso}です.
 8601: @acronym{GNU} Emacs 21とそれ以降では,@acronym{ISO}の日付をパースする
 8602: ことは可能ですが,それより古いEmacsのバージョンではそうではないので,
 8603: 古いバージョンのEmacsを使用していて,@acronym{POSIX}以外のロケールを指
 8604: 定している場合,@samp{TIME_STYLE="locale"}を設定する必要があるかもしれ
 8605: ません.
 8606: 
 8607: 
 8608: @node Formatting the file names
 8609: @c @subsection Formatting the file names
 8610: @subsection ファイル名の書式化
 8611: 
 8612: @c These options change how file names themselves are printed.
 8613: @c 
 8614: これらのオプションは,ファイル名自身を出力する方法を変更します.
 8615: 
 8616: @table @samp
 8617: 
 8618: @item -b
 8619: @itemx --escape
 8620: @itemx --quoting-style=escape
 8621: @opindex -b
 8622: @opindex --escape
 8623: @opindex --quoting-style
 8624: @cindex backslash sequences for file names
 8625: @c Quote nongraphic characters in file names using alphabetic and octal
 8626: @c backslash sequences like those used in C.
 8627: @c 
 8628: ファイル名の表示不可能な文字を,Cで使用されるような,アルファベットと
 8629: 八進数のバックスラッシュシーケンスを用いて引用符で囲みます.
 8630: 
 8631: @item -N
 8632: @itemx --literal
 8633: @itemx --quoting-style=literal
 8634: @opindex -N
 8635: @opindex --literal
 8636: @opindex --quoting-style
 8637: @c Do not quote file names.
 8638: @c 
 8639: ファイル名を引用符で囲みません.
 8640: 
 8641: @item -q
 8642: @itemx --hide-control-chars
 8643: @opindex -q
 8644: @opindex --hide-control-chars
 8645: @c Print question marks instead of nongraphic characters in file names.
 8646: @c This is the default if the output is a terminal and the program is
 8647: @c @command{ls}.
 8648: @c 
 8649: ファイル名の表示不能な文字の代わりに疑問符を出力します.出力が端末の場
 8650: 合と,プログラムが@command{ls}の場合,これはデフォルトです.
 8651: 
 8652: @item -Q
 8653: @itemx --quote-name
 8654: @itemx --quoting-style=c
 8655: @opindex -Q
 8656: @opindex --quote-name
 8657: @opindex --quoting-style
 8658: @c Enclose file names in double quotes and quote nongraphic characters as
 8659: @c in C.
 8660: @c 
 8661: 二重引用符でファイル名を囲み,表示不可能な文字をCのように引用符で囲み
 8662: ます.
 8663: 
 8664: @item --quoting-style=@var{word}
 8665: @opindex --quoting-style
 8666: @cindex quoting style
 8667: @c Use style @var{word} to quote output names.  The @var{word} should
 8668: @c be one of the following:
 8669: @c 
 8670: 出力名の引用符に形式@var{word}を使用します.@var{word}は以下の一つにな
 8671: ります.
 8672: @table @samp
 8673: @item literal
 8674: @c Output names as-is; this is the same as the @option{-N} or
 8675: @c @option{--literal} option.
 8676: @c 
 8677: 現状のまま名前を出力します.これは,@option{-N}や@option{--literal}オ
 8678: プションと同じです.
 8679: @item shell
 8680: @c Quote names for the shell if they contain shell metacharacters or would
 8681: @c cause ambiguous output.
 8682: @c 
 8683: 名前にシェルのメタ文字を含んでいたり,不明瞭な出力を生じる場合,引用符
 8684: で囲みます.
 8685: @item shell-always
 8686: @c Quote names for the shell, even if they would normally not require quoting.
 8687: @c 
 8688: シェルに対して,通常は引用符が不要な場合でも名前を引用符で囲みます.
 8689: @item c
 8690: @c Quote names as for a C language string; this is the same as the
 8691: @c @option{-Q} or @option{--quote-name} option.
 8692: @c 
 8693: C言語の文字列のように名前を引用符で囲みます.これは@option{-Q}や
 8694: @option{--quote-name}オプションと同じです.
 8695: @item escape
 8696: @c Quote as with @samp{c} except omit the surrounding double-quote
 8697: @c characters; this is the same as the @option{-b} or @option{--escape} option.
 8698: @c 
 8699: 周囲の二重引用符を省略した@samp{c}を引用符として用います.これは,
 8700: @option{-b}や@option{--escape}オプションと同じです.
 8701: @item clocale
 8702: @c Quote as with @samp{c} except use quotation marks appropriate for the
 8703: @c locale.
 8704: @c 
 8705: ロケールに適切な引用符を使用する以外は,@samp{c}を用いたように引用符で
 8706: 囲みます.
 8707: @item locale
 8708: @c Use @t instead of @samp to avoid duplicate quoting in some output styles.
 8709: @c 
 8710: @c Like @samp{clocale}, but quote @t{`like this'} instead of @t{"like
 8711: @c this"} in the default C locale.  This looks nicer on many displays.
 8712: @c 
 8713: @samp{clocale}に似ていますが,デフォルトのCロケール@t{"like this"}の代
 8714: わりに,@t{`like this'}で囲みます.これは多くのディスプレイでより良く
 8715: 見えます.
 8716: @end table
 8717: 
 8718: @c You can specify the default value of the @option{--quoting-style} option
 8719: @c with the environment variable @env{QUOTING_STYLE}.  If that environment
 8720: @c variable is not set, the default value is @samp{literal}, but this
 8721: @c default may change to @samp{shell} in a future version of this package.
 8722: @c 
 8723: @option{--quoting-style}オプションのデフォルト値を,環境変数
 8724: @env{QUOTING_STYLE}で指定することが可能です.環境変数が設定されていな
 8725: い場合,デフォルト値は@samp{literal}ですが,このデフォルトは,このパッ
 8726: ケージの将来のバージョンで@samp{shell}に変更されるかもしれません.
 8727: 
 8728: @item --show-control-chars
 8729: @opindex --show-control-chars
 8730: @c Print nongraphic characters as-is in file names.
 8731: @c This is the default unless the output is a terminal and the program is
 8732: @c @command{ls}.
 8733: @c 
 8734: ファイル名の出力不可能な文字をそのまま出力します.出力が端末の場合やプ
 8735: ログラムが@command{ls}の場合以外では,これがデフォルトです.
 8736: 
 8737: @end table
 8738: 
 8739: 
 8740: @node dir invocation
 8741: @c @section @command{dir}: Briefly list directory contents
 8742: @section @command{dir}: ディレクトリの内容の短いリスト
 8743: 
 8744: @pindex dir
 8745: @cindex directory listing, brief
 8746: 
 8747: @c @command{dir} (also installed as @command{d}) is equivalent to @code{ls -C
 8748: @c -b}; that is, by default files are listed in columns, sorted vertically,
 8749: @c and special characters are represented by backslash escape sequences.
 8750: @c 
 8751: @command{dir}(と@code{d}としてインストールされるもの)は,@code{ls -C
 8752: -b}と同じです.すなわち,デフォルトでファイルは列にリストアップされ,
 8753: 縦方向に並べ替えされ,そして特殊文字はバックスペースエスケープシーケン
 8754: スで再表現されます.
 8755: 
 8756: @xref{ls invocation, @command{ls}}.
 8757: 
 8758: 
 8759: @node vdir invocation
 8760: @c @section @command{vdir}: Verbosely list directory contents
 8761: @section @command{vdir}: ディレクトリの内容の冗長なリスト
 8762: 
 8763: @pindex vdir
 8764: @cindex directory listing, verbose
 8765: 
 8766: @c @command{vdir} (also installed as @command{v}) is equivalent to @code{ls -l
 8767: @c -b}; that is, by default files are listed in long format and special
 8768: @c characters are represented by backslash escape sequences.
 8769: @c 
 8770: @command{vdir}は(@code{v}としてインストールされるものも),@code{ls -l
 8771: -b}と同じです.すなわち,デフォルトでファイルは長い書式でリストアップ
 8772: され,特殊文字はバックスペースエスケープシーケンスで再表現されます.
 8773: 
 8774: @node dircolors invocation
 8775: @c @section @command{dircolors}: Color setup for @command{ls}
 8776: @section @command{dircolors}: @command{ls}の色をセットアップ
 8777: 
 8778: @pindex dircolors
 8779: @cindex color setup
 8780: @cindex setup for color
 8781: 
 8782: @c @command{dircolors} outputs a sequence of shell commands to set up the
 8783: @c terminal for color output from @command{ls} (and @command{dir}, etc.).
 8784: @c Typical usage:
 8785: @c 
 8786: @command{dircolors}は,@command{ls} (と@command{dir}等)から出力する色
 8787: のために端末を設定する連続したシェルコマンドを出力します.一般的な使用
 8788: 方法は以下の通りです.
 8789: 
 8790: @example
 8791: eval `dircolors [@var{option}]@dots{} [@var{file}]`
 8792: @end example
 8793: 
 8794: @c If @var{file} is specified, @command{dircolors} reads it to determine which
 8795: @c colors to use for which file types and extensions.  Otherwise, a
 8796: @c precompiled database is used.  For details on the format of these files,
 8797: @c run @samp{dircolors --print-database}.
 8798: @c 
 8799: @var{file}が指定されている場合,@command{dircolors}は,ファイル形式と
 8800: 拡張子に対して使用する色を決定するために,それを読み込みます.それ以外
 8801: の場合,前もってコンパイルされたデータベースが使用されます.これらのファ
 8802: イルの書式の詳細のため,@samp{dircolors --print-database}を実行してく
 8803: ださい.
 8804: 
 8805: @vindex LS_COLORS
 8806: @vindex SHELL @r{environment variable, and color}
 8807: @c The output is a shell command to set the @env{LS_COLORS} environment
 8808: @c variable.  You can specify the shell syntax to use on the command line,
 8809: @c or @command{dircolors} will guess it from the value of the @env{SHELL}
 8810: @c environment variable.
 8811: @c 
 8812: 出力は,@env{LS_COLORS}環境変数を設定するためのシェルコマンドです.コ
 8813: マンドラインで使用するシェル構文を指定することが可能で,そうでなければ
 8814: @command{dircolors}は@code{SHELL}環境変数の値から判別します.
 8815: 
 8816: @c The program accepts the following options.  Also see @ref{Common options}.
 8817: @c 
 8818: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
 8819: してください.
 8820: 
 8821: @table @samp
 8822: @item -b
 8823: @itemx --sh
 8824: @itemx --bourne-shell
 8825: @opindex -b
 8826: @opindex --sh
 8827: @opindex --bourne-shell
 8828: @cindex Bourne shell syntax for color setup
 8829: @cindex @command{sh} syntax for color setup
 8830: @c Output Bourne shell commands.  This is the default if the @env{SHELL}
 8831: @c environment variable is set and does not end with @samp{csh} or
 8832: @c @samp{tcsh}.
 8833: @c 
 8834: Bourneシェルコマンドを出力します.@env{SHELL}環境変数が設定されていて,
 8835: @samp{csh}や@samp{tcsh}で終わらない場合,これはデフォルトです.
 8836: 
 8837: @item -c
 8838: @itemx --csh
 8839: @itemx --c-shell
 8840: @opindex -c
 8841: @opindex --csh
 8842: @opindex --c-shell
 8843: @cindex C shell syntax for color setup
 8844: @cindex @command{csh} syntax for color setup
 8845: @c Output C shell commands.  This is the default if @code{SHELL} ends with
 8846: @c @command{csh} or @command{tcsh}.
 8847: @c 
 8848: Cシェルコマンドを出力します.@env{SHELL}が@samp{csh}や@samp{tcsh}で終
 8849: わる場合,これがデフォルトです.
 8850: 
 8851: @item -p
 8852: @itemx --print-database
 8853: @opindex -p
 8854: @opindex --print-database
 8855: @cindex color database, printing
 8856: @cindex database for color setup, printing
 8857: @cindex printing color database
 8858: @c Print the (compiled-in) default color configuration database.  This
 8859: @c output is itself a valid configuration file, and is fairly descriptive
 8860: @c of the possibilities.
 8861: @c 
 8862: (組み込みの)デフォルトカラーの設定データベースを出力します.この出力は,
 8863: それ自身有効な設定ファイルで,可能性をすべて記述しています.
 8864: 
 8865: @end table
 8866: 
 8867: 
 8868: @node Basic operations
 8869: @c @chapter Basic operations
 8870: @chapter 基本的なオペレーション
 8871: 
 8872: @cindex manipulating files
 8873: 
 8874: @c This chapter describes the commands for basic file manipulation:
 8875: @c copying, moving (renaming), and deleting (removing).
 8876: @c 
 8877: この章は,基本的なファイル操作に対するコマンドを記述します.コピー,移
 8878: 動(名前の変更),そして削除(リムーブ)です.
 8879: 
 8880: @menu
 8881: * cp invocation::               Copy files.
 8882: * dd invocation::               Convert and copy a file.
 8883: * install invocation::          Copy files and set attributes.
 8884: * mv invocation::               Move (rename) files.
 8885: * rm invocation::               Remove files or directories.
 8886: * shred invocation::            Remove files more securely.
 8887: @end menu
 8888: 
 8889: 
 8890: @node cp invocation
 8891: @c @section @command{cp}: Copy files and directories
 8892: @section @command{cp}: ファイルとディレクトリのコピー
 8893: 
 8894: @pindex cp
 8895: @cindex copying files and directories
 8896: @cindex files, copying
 8897: @cindex directories, copying
 8898: 
 8899: @c @command{cp} copies files (or, optionally, directories).  The copy is
 8900: @c completely independent of the original.  You can either copy one file to
 8901: @c another, or copy arbitrarily many files to a destination directory.
 8902: @c Synopsis:
 8903: @c 
 8904: @command{cp}は,ファイル(または,オプションでディレクトリ)をコピーしま
 8905: す.コピーはオリジナルから完全に独立しています.一つのファイルをもう一
 8906: つにコピーする,または,任意の多くのファイルをコピー先のディレクトリに
 8907: コピーすることのいずれかが可能です.概要です.
 8908: 
 8909: @example
 8910: cp [@var{option}]@dots{} @var{source} @var{dest}
 8911: cp [@var{option}]@dots{} @var{source}@dots{} @var{directory}
 8912: @end example
 8913: 
 8914: @c If the last argument names an existing directory, @command{cp} copies each
 8915: @c @var{source} file into that directory (retaining the same name).
 8916: @c Otherwise, if only two files are given, it copies the first onto the
 8917: @c second.  It is an error if the last argument is not a directory and more
 8918: @c than two non-option arguments are given.
 8919: @c 
 8920: 最後の引数が既存のディレクトリを指す場合,@command{cp}はそれぞれの
 8921: @var{source}ファイルをそのディレクトリに(同じ名前のままで)コピーします.
 8922: それ以外で,二つのファイルが与えられた場合,最初のものを二番目のものに
 8923: コピーします.最後の引数がディレクトリでなく,二つ以上のオプションでな
 8924: い引数が与えられた場合エラーとなります.
 8925: 
 8926: @c Generally, files are written just as they are read.  For exceptions,
 8927: @c see the @option{--sparse} option below.
 8928: @c 
 8929: 一般的に,ファイルは読み込まれたとおりに書き込まれます.例外は,以下の
 8930: @option{--sparse}オプションを参照してください.
 8931: 
 8932: @c By default, @command{cp} does not copy directories.  However, the
 8933: @c @option{-R}, @option{-a}, and @option{-r} options cause @command{cp} to
 8934: @c copy recursively by descending into source directories and copying files
 8935: @c to corresponding destination directories.
 8936: @c 
 8937: デフォルトで,@command{cp}はディレクトリをコピーしません.しかし,
 8938: @option{-R},@option{-a},そして@option{-r}オプションでは,
 8939: @command{cp}は元のディレクトリを下り,対応するコピー先のディレクトリに
 8940: ファイルをコピーすることで,再帰的にコピーします.
 8941: 
 8942: @c By default, @command{cp} follows symbolic links only when not copying
 8943: @c recursively.  This default can be overridden with the
 8944: @c @option{--archive} (@option{-a}), @option{-d}, @option{--dereference}
 8945: @c (@option{-L}), @option{--no-dereference} (@option{-P}), and
 8946: @c @option{-H} options.  If more than one of these options is specified,
 8947: @c the last one silently overrides the others.
 8948: @c 
 8949: デフォルトで,@command{cp}は再帰的にコピーしないときのみ,シンボリック
 8950: リンクをたどります.このデフォルトは,@option{--no-dereference}
 8951: (@option{-d}),@option{--dereference} (@option{-L}),そして@option{-H}
 8952: オプションで優先することが可能です.これらのオプションの一つ以上が指定
 8953: されている場合,最後のものが他のものに対して,そのまま優先します.
 8954: 
 8955: @c By default, @command{cp} copies the contents of special files only
 8956: @c when not copying recursively.  This default can be overridden with the
 8957: @c @option{--copy-contents} option.
 8958: @c 
 8959: デフォルトで,@command{cp}は,再帰的なコピーではないときだけ特殊ファイ
 8960: ルの内容をコピーします.このデフォルトは,@option{--copy-contents}オプ
 8961: ションで優先させることが可能です.
 8962: 
 8963: @cindex self-backups
 8964: @cindex backups, making only
 8965: @c @command{cp} generally refuses to copy a file onto itself, with the
 8966: @c following exception: if @option{--force --backup} is specified with
 8967: @c @var{source} and @var{dest} identical, and referring to a regular file,
 8968: @c @command{cp} will make a backup file, either regular or numbered, as
 8969: @c specified in the usual ways (@pxref{Backup options}).  This is useful when
 8970: @c you simply want to make a backup of an existing file before changing it.
 8971: @c 
 8972: @command{cp}は一般的に,以下の例外はありますが,ファイルの自分自身への
 8973: コピーを拒絶します.@option{--force --backup}が同一の@var{source}と
 8974: @var{dest}で指定され,通常のファイルを参照している場合,@command{cp}は,
 8975: 通常の方法(@pxref{Backup options})で指定されたように,通常または番号付
 8976: きのバックアップファイルを作成します.これは,変更前に既存のファイルの
 8977: バックアップを単に作成したいとき役に立ちます.
 8978: 
 8979: @c The program accepts the following options.  Also see @ref{Common options}.
 8980: @c 
 8981: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
 8982: してください.
 8983: 
 8984: @table @samp
 8985: @item -a
 8986: @itemx --archive
 8987: @opindex -a
 8988: @opindex --archive
 8989: @c Preserve as much as possible of the structure and attributes of the
 8990: @c original files in the copy (but do not attempt to preserve internal
 8991: @c directory structure; i.e., @samp{ls -U} may list the entries in a copied
 8992: @c directory in a different order).
 8993: @c Equivalent to @option{-dpPR}.
 8994: @c 
 8995: コピー時に,元のファイルの構造と属性を可能な限り保持します(しかし,ディ
 8996: レクトリ構造の保持は試みません.すなわち,@samp{ls -U}はコピーされてい
 8997: るディレクトリの項目を,異なる順序でリストアップする可能性があります).
 8998: @option{-dpR}と同じです.
 8999: 
 9000: @item -b
 9001: @itemx @w{@kbd{--backup}[=@var{method}]}
 9002: @opindex -b
 9003: @opindex --backup
 9004: @vindex VERSION_CONTROL
 9005: @cindex backups, making
 9006: @c @xref{Backup options}.
 9007: @c Make a backup of each file that would otherwise be overwritten or removed.
 9008: @c As a special case, @command{cp} makes a backup of @var{source} when the force
 9009: @c and backup options are given and @var{source} and @var{dest} are the same
 9010: @c name for an existing, regular file.  One useful application of this
 9011: @c combination of options is this tiny Bourne shell script:
 9012: @c 
 9013: @xref{Backup options}.  上書きされたり削除されたりするそれぞれのファイ
 9014: ルのバックアップを作成します.特殊な場合として,強制とバックアップのオ
 9015: プションが指定され,@var{source}と@var{dest}が同じ名前で存在していると
 9016: き,通常のファイルとして,@command{cp}は@var{source}のバックアップを作
 9017: 成します.このオプションの組合わせの役に立つ応用の一つは,以下の小さな
 9018: Bourneシェルスクリプトです.
 9019: 
 9020: @example
 9021: #!/bin/sh
 9022: # Usage: backup FILE...
 9023: # Create a @sc{gnu}-style backup of each listed FILE.
 9024: for i; do
 9025:   cp --backup --force "$i" "$i"
 9026: done
 9027: @end example
 9028: 
 9029: @item --copy-contents
 9030: @cindex directories, copying recursively
 9031: @cindex copying directories recursively
 9032: @cindex recursively copying directories
 9033: @cindex non-directories, copying as special files
 9034: @c If copying recursively, copy the contents of any special files (e.g.,
 9035: @c FIFOs and device files) as if they were regular files.  This means
 9036: @c trying to read the data in each source file and writing it to the
 9037: @c destination.  It is usually a mistake to use this option, as it
 9038: @c normally has undesirable effects on special files like FIFOs and the
 9039: @c ones typically found in the @file{/dev} directory.  In most cases,
 9040: @c @code{cp -R --copy-contents} will hang indefinitely trying to read
 9041: @c from FIFOs and special files like @file{/dev/console}, and it will
 9042: @c fill up your destination disk if you use it to copy @file{/dev/zero}.
 9043: @c This option has no effect unless copying recursively, and it does not
 9044: @c affect the copying of symbolic links.
 9045: @c 
 9046: 再帰的にコピーをしている場合,特殊ファイル(例えばFIFOとデバイスファイ
 9047: ル)の内容を通常のファイルのようにコピーします.これは,それぞれのソー
 9048: スファイルからデータを読み込み,それをコピー先に書き込むことを意味しま
 9049: す.通常は,FIFOと@file{/dev}ディレクトリで見つかるような特殊ファイル
 9050: では好ましくない効果があるので,このオプションの使い方はよく誤解されま
 9051: す.ほとんどの状況で,FIFOと@file{/dev/console}のような特殊ファイルを
 9052: 読み込もうとして@code{cp -R --copy-contents}は限りなく読み込み続け,
 9053: @file{/dev/zero}をコピーで使用している場合,コピー先のディスクはいっぱ
 9054: いになるでしょう.このオプションは,再帰的にコピーしていない限り効果が
 9055: 無く,シンボリックリンクのコピーにも影響しません.
 9056: 
 9057: @item -d
 9058: @opindex -d
 9059: @cindex symbolic links, copying
 9060: @cindex hard links, preserving
 9061: @c Copy symbolic links as symbolic links rather than copying the files that
 9062: @c they point to, and preserve hard links between source files in the copies.
 9063: @c Equivalent to @option{--no-dereference --preserve=links}.
 9064: @c 
 9065: シンボリックリンクを,それが示すファイルをコピーするのではなく,シンボ
 9066: リックリンクとしてコピーし,コピーのソースファイル間のハードリンクを保
 9067: 持します.@option{--no-dereference --preserve=links}と等価です.
 9068: 
 9069: @item -f
 9070: @itemx --force
 9071: @opindex -f
 9072: @opindex --force
 9073: @c When copying without this option and an existing destination file cannot
 9074: @c be opened for writing, the copy fails.  However, with @option{--force}),
 9075: @c when a destination file cannot be opened, @command{cp} then unlinks it and
 9076: @c tries to open it again.  Contrast this behavior with that enabled by
 9077: @c @option{--link} and @option{--symbolic-link}, whereby the destination file
 9078: @c is never opened but rather is unlinked unconditionally.  Also see the
 9079: @c description of @option{--remove-destination}.
 9080: @c 
 9081: このオプションを使用せずコピーし,コピー先のファイルが存在し,書き込み
 9082: で開くことができないとき,コピーは失敗します.しかし,@option{--force} 
 9083: を用いた場合,コピー先のファイルが開けないとき,@command{cp}はそれをア
 9084: ンリンクし,もう一度開こうとします.この動作は,@option{--link}と
 9085: @option{--symbolic-link}でそれを可能にすることとは異なり,それによって
 9086: コピー先ファイルは開かれることなく,無条件にアンリンクされます.
 9087: @option{--remove-destination}の記述も参照してください.
 9088: 
 9089: @item -H
 9090: @opindex -H
 9091: @c If a command line argument specifies a symbolic link, then copy the
 9092: @c file it points to rather than the symbolic link itself.  However,
 9093: @c copy (preserving its nature) any symbolic link that is encountered
 9094: @c via recursive traversal.
 9095: @c 
 9096: コマンドライン引数がシンボリックリンクを指定している場合,シンボリック
 9097: リンクではなく,ファイルをその位置にコピーします.しかし,再帰的にたどっ
 9098: ていて見つかったすべてのシンボリックリンクを(その元を保存して)コピーし
 9099: ます.
 9100: 
 9101: @item -i
 9102: @itemx --interactive
 9103: @opindex -i
 9104: @opindex --interactive
 9105: @c Prompt whether to overwrite existing regular destination files.
 9106: @c 
 9107: 既存の通常のコピー先のファイルを上書きするかどうか,プロンプトを表示し
 9108: ます.
 9109: 
 9110: @item -l
 9111: @itemx --link
 9112: @opindex -l
 9113: @opindex --link
 9114: @c Make hard links instead of copies of non-directories.
 9115: @c 
 9116: ディレクトリ以外はコピーの代わりにハードリンクを作成します.
 9117: 
 9118: @item -L
 9119: @itemx --dereference
 9120: @opindex -L
 9121: @opindex --dereference
 9122: @c Always follow symbolic links.
 9123: @c 
 9124: 常にシンボリックリンクをたどります.
 9125: 
 9126: @item -P
 9127: @itemx --no-dereference
 9128: @opindex -P
 9129: @opindex --no-dereference
 9130: @cindex symbolic links, copying
 9131: @c Copy symbolic links as symbolic links rather than copying the files that
 9132: @c they point to.
 9133: @c 
 9134: シンボリックリンクを,それが示すファイルをコピーするのではなくシンボリッ
 9135: クリンクとしてコピーします.
 9136: 
 9137: @item -p
 9138: @itemx @w{@kbd{--preserve}[=@var{attribute_list}]}
 9139: @opindex -p
 9140: @opindex --preserve
 9141: @cindex file information, preserving
 9142: @c Preserve the specified attributes of the original files.
 9143: @c If specified, the @var{attribute_list} must be a comma-separated list
 9144: @c of one or more of the following strings:
 9145: @c 
 9146: 指定されている元のファイルの属性を保持します.指定する場合,
 9147: @var{attribute_list}は以下の文字列の一つ以上を,カンマで分離されたリス
 9148: トにする必要があります.
 9149: 
 9150: @table @samp
 9151: @itemx mode
 9152: @c Preserve the permission attributes.
 9153: @c 
 9154: 許可の属性を保持します.
 9155: @itemx ownership
 9156: @c Preserve the owner and group.  On most modern systems,
 9157: @c only the super-user may change the owner of a file, and regular users
 9158: @c may preserve the group ownership of a file only if they happen to be
 9159: @c a member of the desired group.
 9160: @c 
 9161: 所有者とグループの属性を保持します.最近のシステムでは,スーパーユーザ
 9162: のみファイルの所有者を変更することが可能で,通常のユーザは,要求される
 9163: グループのメンバーの場合のみ,ファイルの所有者のグループを保持すること
 9164: が可能です.
 9165: @itemx timestamps
 9166: @c Preserve the times of last access and last modification.
 9167: @c 
 9168: 最後のアクセスと最後の編集のタイムスタンプを保持します.
 9169: @itemx links
 9170: @c Preserve in the destination files
 9171: @c any links between corresponding source files.
 9172: @c 
 9173: 対応するソースファイル間のリンクをコピー先のファイルに保持します.
 9174: @c Give examples illustrating how hard links are preserved.
 9175: @c Also, show how soft links map to hard links with -L and -H.
 9176: @itemx all
 9177: @c Preserve all file attributes.
 9178: @c Equivalent to specifying all of the above.
 9179: @c 
 9180: すべてのファイル属性を保持します.上記のすべてを指定したものと等価です.
 9181: @c Mention ACLs here.
 9182: @end table
 9183: 
 9184: @c Using @option{--preserve} with no @var{attribute_list} is equivalent
 9185: @c to @option{--preserve=mode,ownership,timestamps}.
 9186: @c 
 9187: @var{attribute_list}を用いずに@option{--preserve}を使用することは,
 9188: @option{--preserve=mode,ownership,timestamps}と等価です.
 9189: 
 9190: @c In the absence of this option, each destination file is created with the
 9191: @c permissions of the corresponding source file, minus the bits set in the
 9192: @c umask and minus the set-user-id and set-group-id bits. @xref{File permissions}.
 9193: @c 
 9194: このオプションがないとき,それぞれのコピー先のファイルは,元のファイル
 9195: に対応するパーミッションで作成され,umaskで設定されているビットがなく
 9196: なり,そして,set-user-idビットとset-group-idビットがなくなります.
 9197: @xref{File permissions}.
 9198: 
 9199: 
 9200: @itemx @w{@kbd{--no-preserve}=@var{attribute_list}}
 9201: @cindex file information, preserving
 9202: @c Do not preserve the specified attributes.  The @var{attribute_list}
 9203: @c has the same form as for @option{--preserve}.
 9204: @c 
 9205: 指定された属性を保持しません.@var{attribute_list}は
 9206: @option{--preserve}の形式と同じです.
 9207: 
 9208: @itemx --parents
 9209: @opindex --parents
 9210: @cindex parent directories and @command{cp}
 9211: @c Form the name of each destination file by appending to the target
 9212: @c directory a slash and the specified name of the source file.  The last
 9213: @c argument given to @command{cp} must be the name of an existing directory.
 9214: @c For example, the command:
 9215: @c 
 9216: それぞれのコピー先のファイル名を,ターゲットディレクトリにスラッシュと
 9217: 指定されたソースファイルの名前を追加したものとして作成します.
 9218: @command{cp}に与える最後の引数は,既存のディレクトリ名にする必要があり
 9219: ます.例えば,以下のようなコマンドを入力します.
 9220: 
 9221: @example
 9222: cp --parents a/b/c existing_dir
 9223: @end example
 9224: 
 9225: @noindent
 9226: @c copies the file @file{a/b/c} to @file{existing_dir/a/b/c}, creating
 9227: @c any missing intermediate directories.
 9228: @c 
 9229: これはファイル@file{a/b/c}を@file{existing_dir/a/b/c}にコピーし,存在
 9230: しないあらゆる中間ディレクトリを作成します.
 9231: 
 9232: @itemx @w{@kbd{--reply}[=@var{how}]}
 9233: @opindex --reply
 9234: @cindex interactivity
 9235: @c Using @option{--reply=yes} makes @command{cp} act as if @samp{yes} were
 9236: @c given as a response to every prompt about a destination file.  That effectively
 9237: @c cancels any preceding @option{--interactive} or @option{-i} option.
 9238: @c Specify @option{--reply=no} to make @command{cp} act as if @samp{no} were
 9239: @c given as a response to every prompt about a destination file.
 9240: @c Specify @option{--reply=query} to make @command{cp} prompt the user
 9241: @c about each existing destination file.
 9242: @c 
 9243: @option{--reply=yes}を使用すると,コピー先のファイルに関するすべてのプ
 9244: ロンプトに対する応答として@samp{yes}が与えられたかのように@command{cp} 
 9245: が動作します.それは,それまでに使用されていた@option{--interactive}や
 9246: @option{-i}オプションを効果的に停止します.コピー先のファイルに関する
 9247: すべてのプロンプトに対する応答として@samp{no}が与えられたかのように
 9248: @command{cp}に動作させるため,@option{--reply=no}を指定して下さい.そ
 9249: れぞれ既存のコピー先のファイルに関して,@command{cp}がユーザにプロンプ
 9250: トを表示するようにするため,@option{--reply=query}を指定して下さい.
 9251: 
 9252: @item -R
 9253: @itemx -r
 9254: @itemx --recursive
 9255: @opindex -R
 9256: @opindex -r
 9257: @opindex --recursive
 9258: @cindex directories, copying recursively
 9259: @cindex copying directories recursively
 9260: @cindex recursively copying directories
 9261: @cindex non-directories, copying as special files
 9262: @c Copy directories recursively.  Symbolic links are not followed by
 9263: @c default; see the @option{--archive} (@option{-a}), @option{-d},
 9264: @c @option{--dereference} (@option{-L}), @option{--no-dereference}
 9265: @c (@option{-P}), and @option{-H} options.  Special files are copied by
 9266: @c creating a destination file of the same type as the source; see the
 9267: @c @option{--copy-contents} option.  It is not portable to use
 9268: @c @option{-r} to copy symbolic links or special files.  On some
 9269: @c non-@sc{gnu} systems, @option{-r} implies the equivalent of
 9270: @c @option{-L} and @option{--copy-contents} for historical reasons.
 9271: @c Also, it is not portable to use @option{-R} to copy symbolic links
 9272: @c unless you also specify @option{-P}, as @acronym{POSIX} allows
 9273: @c implementations that dereference symbolic links by default.
 9274: @c 
 9275: 再帰的にディレクトリをコピーします.デフォルトではシンボリックリンクを
 9276: たどりません.@option{--archive} (@option{-a}),@option{-d},
 9277: @option{--dereference} (@option{-L}),@option{--no-dereference}
 9278: (@option{-P}),そして@option{-H}オプションを参照して下さい.特殊ファイ
 9279: ルは,元となるファイルと同じ形式でコピー先のファイルを作成することでコ
 9280: ピーします.@option{--copy-contents}オプションを参照して下さい.シンボ
 9281: リックリンクや特殊ファイルをコピーするために@option{-r}を使用すること
 9282: には移植性がありません.@sc{gnu}以外のシステムには,歴史的な理由から
 9283: @option{-r}で@option{-L}と@option{--copy-contents}の等価物を暗黙に指定
 9284: するものもあります.また,シンボリックリンクをコピーするため
 9285: @option{-R}を使用することは,@option{-P}も指定しない限り移植性が無く,
 9286: それは,デフォルトでシンボリックリンクの間接参照を行なう実装が
 9287: @acronym{POSIX}で許可されているためです.
 9288: 
 9289: @item --remove-destination
 9290: @opindex --remove-destination
 9291: @c Remove each existing destination file before attempting to open it
 9292: @c (contrast with @option{-f} above).
 9293: @c 
 9294: それぞれの既存のコピー先ファイルを,それを開く前に削除します(上記の
 9295: @option{-f}とは異なります).
 9296: 
 9297: @item --sparse=@var{when}
 9298: @opindex --sparse=@var{when}
 9299: @cindex sparse files, copying
 9300: @cindex holes, copying files with
 9301: @findex read @r{system call, and holes}
 9302: @c A @dfn{sparse file} contains @dfn{holes}---a sequence of zero bytes that
 9303: @c does not occupy any physical disk blocks; the @samp{read} system call
 9304: @c reads these as zeroes.  This can both save considerable disk space and
 9305: @c increase speed, since many binary files contain lots of consecutive zero
 9306: @c bytes.  By default, @command{cp} detects holes in input source files via a crude
 9307: @c heuristic and makes the corresponding output file sparse as well.
 9308: @c 
 9309: @dfn{まばらなファイル(sparse file)}は@dfn{穴(holes)} --- 物理的なディ
 9310: スクブロックには発生しないゼロバイトの列 --- を含みます.@samp{read}シ
 9311: ステムコールはこれらをゼロとして読み込みます.バイナリファイルには連続
 9312: するゼロバイトを含むことが多いので,これでディスクスペースの節約と速度
 9313: の増加の両方を達成することが可能です.デフォルトでは,@command{cp}は発
 9314: 見的手法を用いて入力された元ファイルの穴を見付け,対応する出力ファイル
 9315: に同様にまばらにします.
 9316: 
 9317: @c The @var{when} value can be one of the following:
 9318: @c 
 9319: @var{when}の値は以下の一つになります.
 9320: @table @samp
 9321: @item auto
 9322: @c The default behavior: the output file is sparse if the input file is sparse.
 9323: @c 
 9324: デフォルトの動作です:入力ファイルがまばらの場合,出力ファイルはまばら
 9325: になります.
 9326: 
 9327: @item always
 9328: @c Always make the output file sparse.  This is useful when the input
 9329: @c file resides on a filesystem that does not support sparse files (the
 9330: @c most notable example is @samp{efs} filesystems in SGI IRIX 5.3 and
 9331: @c earlier), but the output file is on another type of filesystem.
 9332: @c 
 9333: 常に,出力ファイルをまばらにします.まばらなファイルをサポートしないファ
 9334: イルシステム(最も顕著な例は,SGI IRIX 5.3とそれ以前の@samp{efs}ファイ
 9335: ルシステム)に存在する入力ファイルで,出力ファイルはそれ以外のファイル
 9336: システムのときこれは役に立ちます.
 9337: 
 9338: @item never
 9339: @c Never make the output file sparse.
 9340: @c This is useful in creating a file for use with the @command{mkswap} command,
 9341: @c since such a file must not have any holes.
 9342: @c 
 9343: 出力ファイルをまばらにしません.@command{mkswap}コマンドを用いてファイ
 9344: ルを作成するとき,そのようなファイルには穴があってはならないので,これ
 9345: が役に立ちます.
 9346: @end table
 9347: 
 9348: @itemx @w{@kbd{--strip-trailing-slashes}}
 9349: @opindex --strip-trailing-slashes
 9350: @cindex stripping trailing slashes
 9351: @c Remove any trailing slashes from each @var{source} argument.
 9352: @c @xref{Trailing slashes}.
 9353: @c 
 9354: それぞれの@var{source}引数から,後置されるスラッシュを削除します.
 9355: @xref{Trailing slashes}.
 9356: 
 9357: @item -s
 9358: @itemx --symbolic-link
 9359: @opindex -s
 9360: @opindex --symbolic-link
 9361: @cindex symbolic links, copying with
 9362: @c Make symbolic links instead of copies of non-directories.  All source
 9363: @c file names must be absolute (starting with @samp{/}) unless the
 9364: @c destination files are in the current directory.  This option merely
 9365: @c results in an error message on systems that do not support symbolic links.
 9366: @c 
 9367: ディレクトリでないものをコピーする代わりにシンボリックリンクを作成しま
 9368: す.すべての元ファイル名は,リンク先のファイルが現在のディレクトリにあ
 9369: る場合以外,絶対的である(@samp{/}で始まる)必要があります.シンボリック
 9370: リンクをサポートしないシステムでは,このオプションは結果としてエラーメッ
 9371: セージを返すだけです.
 9372: 
 9373: @item -S @var{suffix}
 9374: @itemx --suffix=@var{suffix}
 9375: @opindex -S
 9376: @opindex --suffix
 9377: @c Append @var{suffix} to each backup file made with @option{-b}.
 9378: @c @xref{Backup options}.
 9379: @c 
 9380: それぞれの@option{-b}でのバックアップファイルに@var{suffix}を追加しま
 9381: す.@xref{Backup options}.
 9382: 
 9383: @itemx @w{@kbd{--target-directory}=@var{directory}}
 9384: @opindex --target-directory
 9385: @cindex target directory
 9386: @cindex destination directory
 9387: @c Specify the destination @var{directory}.
 9388: @c @xref{Target directory}.
 9389: @c 
 9390: コピー先の@var{directory}を指定します.@xref{Target directory}.
 9391: 
 9392: @item -v
 9393: @itemx --verbose
 9394: @opindex -v
 9395: @opindex --verbose
 9396: @c Print the name of each file before copying it.
 9397: @c 
 9398: コピーする前にそれぞれのファイル名を出力します.
 9399: 
 9400: @item -V @var{method}
 9401: @itemx --version-control=@var{method}
 9402: @opindex -V
 9403: @opindex --version-control
 9404: @c Change the type of backups made with @option{-b}.  The @var{method}
 9405: @c argument can be @samp{none} (or @samp{off}), @samp{numbered} (or
 9406: @c @samp{t}), @samp{existing} (or @samp{nil}), or @samp{never} (or
 9407: @c @samp{simple}).  @xref{Backup options}.
 9408: @c 
 9409: @option{-b}で作成するバックアップの形式を変更します.@var{method}引数
 9410: は,@samp{none} (または@samp{off}),@samp{numbered} (または@samp{t}),
 9411: @samp{existing} (または@samp{nil}),または@samp{never} (または
 9412: @samp{simple})が可能です.@xref{Backup options}.
 9413: 
 9414: @item -x
 9415: @itemx --one-file-system
 9416: @opindex -x
 9417: @opindex --one-file-system
 9418: @cindex filesystems, omitting copying to different
 9419: @c Skip subdirectories that are on different filesystems from the one that
 9420: @c the copy started on.
 9421: @c However, mount point directories @emph{are} copied.
 9422: @c 
 9423: コピーを開始したファイルシステムと異なるサブディレクトリを省略します.
 9424: しかし,マウントポイントのディレクトリはコピー@emph{されます}.
 9425: 
 9426: @end table
 9427: 
 9428: 
 9429: @node dd invocation
 9430: @c @section @command{dd}: Convert and copy a file
 9431: @section @command{dd}: ファイルの変換とコピー
 9432: 
 9433: @pindex dd
 9434: @cindex converting while copying a file
 9435: 
 9436: @c @command{dd} copies a file (from standard input to standard output, by
 9437: @c default) with a changeable I/O block size, while optionally performing
 9438: @c conversions on it.  Synopsis:
 9439: @c 
 9440: @command{dd}は,変更可能なI/Oブロックサイズを用いて,(デフォルトで,標
 9441: 準入力から標準出力に)ファイルをコピーし,オプションの動作でそれを変更
 9442: します.概要です.
 9443: 
 9444: @example
 9445: dd [@var{option}]@dots{}
 9446: @end example
 9447: 
 9448: @c The program accepts the following options.  Also see @ref{Common options}.
 9449: @c 
 9450: プログラムは,以下のオプションも受け入れます.@ref{Common options}も参
 9451: 照してください.
 9452: 
 9453: @cindex multipliers after numbers
 9454: @c The numeric-valued options below (@var{bytes} and @var{blocks}) can be
 9455: @c followed by a multiplier: @samp{b}=512, @samp{c}=1,
 9456: @c @samp{w}=2, @samp{x@var{m}}=@var{m}, or any of the
 9457: @c standard block size suffixes like @samp{k}=1024 (@pxref{Block size}).
 9458: @c 
 9459: 以下の(@var{bytes}と@var{blocks})数値的な値のオプションを続けて倍数に
 9460: することが可能です.それは,@samp{b}=512,@samp{c}=1,@samp{w}=2,
 9461: @samp{x@var{m}}=@var{m},または@samp{k}=1024のようなあらゆるブロックサ
 9462: イズ接尾子です(@pxref{Block size}).
 9463: 
 9464: @c Use different @command{dd} invocations to use different block sizes for
 9465: @c skipping and I/O.  For example, the following shell commands copy data
 9466: @c in 512 KiB blocks between a disk and a tape, but do not save or restore a
 9467: @c 4 KiB label at the start of the disk:
 9468: @c 
 9469: スキップとI/Oに対し異なるブロックサイズを使用するためは,@command{dd} 
 9470: の呼び出しを別々に行なってください.例えば,以下のシェルコマンドでは,
 9471: ディスクとテープの間で512kBブロックでデータをコピーしますが,ディスク
 9472: の最初の4kBのラベルは,保存されたり復元されたりしません.
 9473: 
 9474: @example
 9475: disk=/dev/rdsk/c0t1d0s2
 9476: tape=/dev/rmt/0
 9477: 
 9478: # Copy all but the label from disk to tape.
 9479: (dd bs=4k skip=1 count=0 && dd bs=512k) <$disk >$tape
 9480: 
 9481: # Copy from tape back to disk, but leave the disk label alone.
 9482: (dd bs=4k seek=1 count=0 && dd bs=512k) <$tape >$disk
 9483: @end example
 9484: 
 9485: @table @samp
 9486: 
 9487: @item if=@var{file}
 9488: @opindex if
 9489: @c Read from @var{file} instead of standard input.
 9490: @c 
 9491: 標準入力の代わりに@var{file}から読み込みます.
 9492: 
 9493: @item of=@var{file}
 9494: @opindex of
 9495: @c Write to @var{file} instead of standard output.  Unless
 9496: @c @samp{conv=notrunc} is given, @command{dd} truncates @var{file} to zero
 9497: @c bytes (or the size specified with @samp{seek=}).
 9498: @c 
 9499: 標準出力の代わりに@var{file}に書き出します.@samp{conv=notrunc}が与え
 9500: られていない場合,@command{dd}は@var{file}をゼロバイト(または,
 9501: @samp{seek=}で指定されたサイズ)に切り詰めます.
 9502: 
 9503: @item ibs=@var{bytes}
 9504: @opindex ibs
 9505: @cindex block size of input
 9506: @cindex input block size
 9507: @c Read @var{bytes} bytes at a time.
 9508: @c 
 9509: 一度に@var{bytes}バイト読み込みます.
 9510: 
 9511: @item obs=@var{bytes}
 9512: @opindex obs
 9513: @cindex block size of output
 9514: @cindex output block size
 9515: @c Write @var{bytes} bytes at a time.
 9516: @c 
 9517: 一度に@var{bytes}バイト書き出します.
 9518: 
 9519: @item bs=@var{bytes}
 9520: @opindex bs
 9521: @cindex block size
 9522: @c Both read and write @var{bytes} bytes at a time.  This overrides
 9523: @c @samp{ibs} and @samp{obs}.
 9524: @c 
 9525: 一度に@var{bytes}バイト読み書きします.これは@samp{ibs}と@samp{obs}に
 9526: 優先します.
 9527: 
 9528: @item cbs=@var{bytes}
 9529: @opindex cbs
 9530: @cindex block size of conversion
 9531: @cindex conversion block size
 9532: @c Convert @var{bytes} bytes at a time.
 9533: @c 
 9534: 一度に@var{bytes}バイト変換します.
 9535: 
 9536: @item skip=@var{blocks}
 9537: @opindex skip
 9538: @c Skip @var{blocks} @samp{ibs}-byte blocks in the input file before copying.
 9539: @c 
 9540: コピーする前に入力ファイルで,@var{blocks} @samp{ibs}バイトブロックを
 9541: 読み飛ばします.
 9542: 
 9543: @item seek=@var{blocks}
 9544: @opindex seek
 9545: @c Skip @var{blocks} @samp{obs}-byte blocks in the output file before copying.
 9546: @c 
 9547: コピーする前に出力ファイルで,@var{blocks} @samp{ibs}バイトブロックを
 9548: 読み飛ばします.
 9549: 
 9550: @item count=@var{blocks}
 9551: @opindex count
 9552: @c Copy @var{blocks} @samp{ibs}-byte blocks from the input file, instead
 9553: @c of everything until the end of the file.
 9554: @c 
 9555: ファイルの終りまでのすべてではなく,入力ファイルから@var{blocks}
 9556: @samp{ibs}バイトブロックコピーします.
 9557: 
 9558: @item conv=@var{conversion}[,@var{conversion}]@dots{}
 9559: @opindex conv
 9560: @c Convert the file as specified by the @var{conversion} argument(s).
 9561: @c (No spaces around any comma(s).)
 9562: @c 
 9563: @var{conversion}引数で指定されたようにファイルを変換します.(カンマの
 9564: 回りにスペースはありません.)
 9565: 
 9566: @c Conversions:
 9567: @c 
 9568: 以下の変換です.
 9569: 
 9570: @table @samp
 9571: 
 9572: @item ascii
 9573: @opindex ascii@r{, converting to}
 9574: @c Convert @acronym{EBCDIC} to @acronym{ASCII}.
 9575: @c 
 9576: EBCDICをASCIIに変換します.
 9577: 
 9578: @item ebcdic
 9579: @opindex ebcdic@r{, converting to}
 9580: @c Convert @acronym{ASCII} to @acronym{EBCDIC}.
 9581: @c 
 9582: ASCIIをEBCDICに変換します.
 9583: 
 9584: @item ibm
 9585: @opindex alternate ebcdic@r{, converting to}
 9586: @c Convert @acronym{ASCII} to alternate @acronym{EBCDIC}.
 9587: @c 
 9588: ASCIIを別のEBCDICに変換します.
 9589: 
 9590: @item block
 9591: @opindex block @r{(space-padding)}
 9592: @c For each line in the input, output @samp{cbs} bytes, replacing the
 9593: @c input newline with a space and padding with spaces as necessary.
 9594: @c 
 9595: 入力のそれぞれの行に対し,入力の改行をスペースに置換し,必要なスペース
 9596: を埋め込みながら,@samp{cbs}バイト出力します.
 9597: 
 9598: @item unblock
 9599: @opindex unblock
 9600: @c Replace trailing spaces in each @samp{cbs}-sized input block with a
 9601: @c newline.
 9602: @c 
 9603: それぞれの@samp{cbs}の大きさの入力ブロックで,末尾のスペースを改行に置
 9604: 換します.
 9605: 
 9606: @item lcase
 9607: @opindex lcase@r{, converting to}
 9608: @c Change uppercase letters to lowercase.
 9609: @c 
 9610: 大文字を小文字に変換します.
 9611: 
 9612: @item ucase
 9613: @opindex ucase@r{, converting to}
 9614: @c Change lowercase letters to uppercase.
 9615: @c 
 9616: 小文字を大文字に変換します.
 9617: 
 9618: @item swab
 9619: @opindex swab @r{(byte-swapping)}
 9620: @cindex byte-swapping
 9621: @c Swap every pair of input bytes.  @sc{gnu} @command{dd}, unlike others, works
 9622: @c when an odd number of bytes are read---the last byte is simply copied
 9623: @c (since there is nothing to swap it with).
 9624: @c 
 9625: 入力バイトのすべての組を入れ替えます.@sc{gnu} @command{dd}は他と異な
 9626: り,偶数バイトを読み込んだとき動作します --- 最後のバイトは,単にコピー
 9627: されます.(入れ替えるバイトがないからです).
 9628: 
 9629: @item noerror
 9630: @opindex noerror
 9631: @cindex read errors, ignoring
 9632: @c Continue after read errors.
 9633: @c 
 9634: 読み込みエラー後も続けます.
 9635: 
 9636: @item notrunc
 9637: @opindex notrunc
 9638: @cindex truncating output file, avoiding
 9639: @c Do not truncate the output file.
 9640: @c 
 9641: 出力ファイルを切り詰めません.
 9642: 
 9643: @item sync
 9644: @opindex sync @r{(padding with nulls)}
 9645: @c Pad every input block to size of @samp{ibs} with trailing zero bytes.
 9646: @c When used with @samp{block} or @samp{unblock}, pad with spaces instead of
 9647: @c zero bytes.
 9648: @c 
 9649: すべての入力ブロックを,後置するゼロバイトを埋め込み@samp{ibs}サイズに
 9650: します.@samp{block}や@samp{unblock}を使用するとき,ゼロバイトの代わり
 9651: にスペースで埋め込みます.
 9652: @end table
 9653: 
 9654: @end table
 9655: 
 9656: 
 9657: @node install invocation
 9658: @c @section @command{install}: Copy files and set attributes
 9659: @section @command{install}: ファイルのコピーと属性の設定
 9660: 
 9661: @pindex install
 9662: @cindex copying files and setting attributes
 9663: 
 9664: @c @command{install} copies files while setting their permission modes and, if
 9665: @c possible, their owner and group.  Synopses:
 9666: @c 
 9667: @command{install}は,許可モードと,可能な場合は所有者とグループ設定し
 9668: ながらファイルをコピーします.概要です.
 9669: 
 9670: @example
 9671: install [@var{option}]@dots{} @var{source} @var{dest}
 9672: install [@var{option}]@dots{} @var{source}@dots{} @var{directory}
 9673: install -d [@var{option}]@dots{} @var{directory}@dots{}
 9674: @end example
 9675: 
 9676: @c In the first of these, the @var{source} file is copied to the @var{dest}
 9677: @c target file.  In the second, each of the @var{source} files are copied
 9678: @c to the destination @var{directory}.  In the last, each @var{directory}
 9679: @c (and any missing parent directories) is created.
 9680: @c 
 9681: これらの最初のものは,@var{source}ファイルは@var{dest}ターゲットファイ
 9682: ルにコピーされます.二番目では,それぞれの@var{source}ファイルはコピー
 9683: 先の@var{directory}にコピーされます.最後では,それぞれの
 9684: @var{directory}(と足りない親ディレクトリ)がコピーされます.
 9685: 
 9686: @cindex Makefiles, installing programs in
 9687: @c @command{install} is similar to @command{cp}, but allows you to control the
 9688: @c attributes of destination files.  It is typically used in Makefiles to
 9689: @c copy programs into their destination directories.  It refuses to copy
 9690: @c files onto themselves.
 9691: @c 
 9692: @command{install}は@command{cp}に似ていますが,コピー先のファイルの属
 9693: 性を制御することが可能になっています.それはMakefileで一般的に使用され,
 9694: プログラムをコピー先のディレクトリにコピーします.自分自身にファイルを
 9695: コピーすることは拒否されます.
 9696: 
 9697: @c The program accepts the following options.  Also see @ref{Common options}.
 9698: @c 
 9699: プログラムは,以下のオプションも受け入れます.@ref{Common options}も参
 9700: 照してください.
 9701: 
 9702: @table @samp
 9703: 
 9704: @item -b
 9705: @itemx @w{@kbd{--backup}[=@var{method}]}
 9706: @opindex -b
 9707: @opindex --backup
 9708: @vindex VERSION_CONTROL
 9709: @cindex backups, making
 9710: @c @xref{Backup options}.
 9711: @c Make a backup of each file that would otherwise be overwritten or removed.
 9712: @c 
 9713: @xref{Backup options}. 上書きされたり削除されたりするファイルのバック
 9714: アップを作成します.
 9715: 
 9716: @item -c
 9717: @opindex -c
 9718: @c Ignored; for compatibility with old Unix versions of @command{install}.
 9719: @c 
 9720: 無視されます.古いUnixバージョンの@command{install}の互換性のためです.
 9721: 
 9722: @item -d
 9723: @itemx --directory
 9724: @opindex -d
 9725: @opindex --directory
 9726: @cindex directories, creating with given attributes
 9727: @cindex parent directories, creating missing
 9728: @cindex leading directories, creating missing
 9729: @c Create each given directory and any missing parent directories, setting
 9730: @c the owner, group and mode as given on the command line or to the
 9731: @c defaults.  It also gives any parent directories it creates those
 9732: @c attributes.  (This is different from the SunOS 4.x @command{install}, which
 9733: @c gives directories that it creates the default attributes.)
 9734: @c 
 9735: 与えられたそれぞれのディレクトリと足りない親ディレクトリを,コマンドラ
 9736: インで与えられたやデフォルトの所有者,グループとモードに設定しながら作
 9737: 成します.親ディレクトリも与えられた属性で作成されます.(これはSunOS
 9738: 4.x @command{install}と異なり,そこではディレクトリはデフォルトの属性
 9739: が与えられます.)
 9740: 
 9741: @item -g @var{group}
 9742: @itemx --group=@var{group}
 9743: @opindex -g
 9744: @opindex --group
 9745: @cindex group ownership of installed files, setting
 9746: @c Set the group ownership of installed files or directories to
 9747: @c @var{group}. The default is the process' current group.  @var{group}
 9748: @c may be either a group name or a numeric group id.
 9749: @c 
 9750: インストールされるファイルやディレクトリのグループ所有権を,
 9751: @var{group} に設定します.デフォルトは,プロセスの現在のグループです.
 9752: @var{group}は,グループ名や数値的なグループIDが可能です.
 9753: 
 9754: @item -m @var{mode}
 9755: @itemx --mode=@var{mode}
 9756: @opindex -m
 9757: @opindex --mode
 9758: @cindex permissions of installed files, setting
 9759: @c Set the permissions for the installed file or directory to @var{mode},
 9760: @c which can be either an octal number, or a symbolic mode as in
 9761: @c @command{chmod}, with 0 as the point of departure (@pxref{File
 9762: @c permissions}).  The default mode is @samp{u=rwx,go=rx}---read, write,
 9763: @c and execute for the owner, and read and execute for group and other.
 9764: @c 
 9765: インストールされるファイルやディレクトリの許可を@var{mode}に設定し,そ
 9766: れは八進数や@command{chmod}の象徴的なモードが可能で,0が出発点となりま
 9767: す(@pxref{File permissions}).デフォルトモードは@samp{u=rwx,go=rx}です 
 9768: --- 所有者の読み書き実行,グループとそれ以外は読み込みと実行です.
 9769: 
 9770: @item -o @var{owner}
 9771: @itemx --owner=@var{owner}
 9772: @opindex -o
 9773: @opindex --owner
 9774: @cindex ownership of installed files, setting
 9775: @cindex appropriate privileges
 9776: @vindex root @r{as default owner}
 9777: @c If @command{install} has appropriate privileges (is run as root), set the
 9778: @c ownership of installed files or directories to @var{owner}. The default
 9779: @c is @code{root}.  @var{owner} may be either a user name or a numeric user
 9780: @c ID.
 9781: @c 
 9782: @command{install}が適切な特権(ルートとして実行)を持つ場合,インストー
 9783: ルされるファイルやディレクトリの所有権は@var{owner}に設定されます.デ
 9784: フォルトは@code{root}です.@var{owner}は,ユーザ名または,数値のユーザ
 9785: IDが可能です.
 9786: 
 9787: @item -p
 9788: @itemx --preserve-timestamps
 9789: @opindex -p
 9790: @opindex --preserve-timestamps
 9791: @cindex timestamps of installed files, preserving
 9792: @c Set the time of last access and the time of last modification of each
 9793: @c installed file to match those of each corresponding original file.
 9794: @c When a file is installed without this option, its last access and
 9795: @c last modification times are both set to the time of installation.
 9796: @c This option is useful if you want to use the last modification times
 9797: @c of installed files to keep track of when they were last built as opposed
 9798: @c to when they were last installed.
 9799: @c 
 9800: インストールされたそれぞれのファイルの,最後にアクセスした時間と最後に
 9801: 編集した時間を,対応するそれぞれの元ファイルにマッチさせます.このオプ
 9802: ション無しでファイルがインストールされたとき,最後にアクセスした時間と
 9803: 最後に編集した時間は,どちらもインストールされた時間に設定されます.こ
 9804: のオプションは,最後にインストールされた時ではなく,最後にビルドされた
 9805: 時を追跡し続けるため,インストールされたファイルの最後に編集された時間
 9806: を使用する場合,役に立ちます.
 9807: 
 9808: @item -s
 9809: @itemx --strip
 9810: @opindex -s
 9811: @opindex --strip
 9812: @cindex symbol table information, stripping
 9813: @cindex stripping symbol table information
 9814: @c Strip the symbol tables from installed binary executables.
 9815: @c 
 9816: インストールされたバイナリ実行形式から,シンボルテーブルを取り除きます.
 9817: 
 9818: @item -S @var{suffix}
 9819: @itemx --suffix=@var{suffix}
 9820: @opindex -S
 9821: @opindex --suffix
 9822: @c Append @var{suffix} to each backup file made with @option{-b}.
 9823: @c @xref{Backup options}.
 9824: @c 
 9825: @option{-b}で作成されるそれぞれのバックアップファイルに,@var{suffix}
 9826: を追加します.@xref{Backup options}.
 9827: 
 9828: @itemx @w{@kbd{--target-directory}=@var{directory}}
 9829: @opindex --target-directory
 9830: @cindex target directory
 9831: @cindex destination directory
 9832: @c Specify the destination @var{directory}.
 9833: @c @xref{Target directory}.
 9834: @c 
 9835: コピー先の@var{directory}を指定します.@xref{Target directory}.
 9836: 
 9837: @item -v
 9838: @itemx --verbose
 9839: @opindex -v
 9840: @opindex --verbose
 9841: @c Print the name of each file before copying it.
 9842: @c 
 9843: コピーする前に,それぞれのファイル名を出力します.
 9844: 
 9845: @item -V @var{method}
 9846: @itemx --version-control=@var{method}
 9847: @opindex -V
 9848: @opindex --version-control
 9849: @c Change the type of backups made with @option{-b}.  The @var{method}
 9850: @c argument can be @samp{none} (or @samp{off}), @samp{numbered} (or
 9851: @c @samp{t}), @samp{existing} (or @samp{nil}), or @samp{never} (or
 9852: @c @samp{simple}).  @xref{Backup options}.
 9853: @c 
 9854: @option{-b}で作成されるバックアップの形式を変更します.@var{method}引
 9855: 数は,@samp{none} (または@samp{off}),@samp{numbered} (または@samp{t}),
 9856: @samp{existing} (または@samp{nil}),または,@samp{never} (または
 9857: @samp{simple})が可能です.@xref{Backup options}.
 9858: 
 9859: @end table
 9860: 
 9861: 
 9862: @node mv invocation
 9863: @c @section @command{mv}: Move (rename) files
 9864: @section @command{mv}: ファイルの移動(名前の変更)
 9865: 
 9866: @pindex mv
 9867: 
 9868: @c @command{mv} moves or renames files (or directories).  Synopsis:
 9869: @c 
 9870: @command{mv}は,ファイル(やディレクトリ)を移動したり名前を変更したりし
 9871: ます.概要です.
 9872: 
 9873: @example
 9874: mv [@var{option}]@dots{} @var{source} @var{dest}
 9875: mv [@var{option}]@dots{} @var{source}@dots{} @var{directory}
 9876: @end example
 9877: 
 9878: @c If the last argument names an existing directory, @command{mv} moves each
 9879: @c other given file into a file with the same name in that directory.
 9880: @c Otherwise, if only two files are given, it renames the first as
 9881: @c the second.  It is an error if the last argument is not a directory
 9882: @c and more than two files are given.
 9883: @c 
 9884: 最後の引数が,既存のディレクトリを示す場合,@command{mv}は,それ以外の
 9885: 与えられたそれぞれのファイルを,同じファイル名で,そのディレクトリに移
 9886: 動します.それ以外では,二つのファイルが与えられた場合,一番目の名前を
 9887: 二番目に変更します.最後の引数がディレクトリではなく,二つ以上のファイ
 9888: ルが与えられた場合,エラーとなります.
 9889: 
 9890: @c @command{mv} can move any type of file from one filesystem to another.
 9891: @c Prior to version @code{4.0} of the fileutils,
 9892: @c @command{mv} could move only regular files between filesystems.
 9893: @c For example, now @command{mv} can move an entire directory hierarchy
 9894: @c including special device files from one partition to another.  It first
 9895: @c uses some of the same code that's used by @code{cp -a} to copy the
 9896: @c requested directories and files, then (assuming the copy succeeded)
 9897: @c it removes the originals.  If the copy fails, then the part that was
 9898: @c copied to the destination partition is removed.  If you were to copy
 9899: @c three directories from one partition to another and the copy of the first
 9900: @c directory succeeded, but the second didn't, the first would be left on
 9901: @c the destination partition and the second and third would be left on the
 9902: @c original partition.
 9903: @c 
 9904: @command{mv}は,一つのファイルシステムから別のものへ,あらゆる形式のファ
 9905: イル移動が可能です.fileutilsのバージョン@code{4.0}以前では,
 9906: @command{mv}は通常のファイルのみファイルシステム間での移動が可能でした.
 9907: 例えば,現在の@command{mv}は,一つのパーティションから別のものへ,特殊
 9908: なデバイスファイルを含むディレクトリ階層全体を移動することが可能です.
 9909: それは最初に,要求されたディレクトリとファイルをコピーする@code{cp -a} 
 9910: で使用されているものと同じコードを使用し,それから(コピーが成功したと
 9911: 仮定して)元を削除します.コピーが失敗した場合,移動先のパーティション
 9912: にコピーされた部分が削除されます.一つのパーティションから三つのディレ
 9913: クトリを別のものにコピーしていて,最初のディレクトリが成功し,二番目が
 9914: 失敗した場合,最初のものは移動先のパーティションに残り,二番目と三番目
 9915: は元のパーティションに残ります.
 9916: 
 9917: @cindex prompting, and @command{mv}
 9918: @c If a destination file exists but is normally unwritable, standard input
 9919: @c is a terminal, and the @option{-f} or @option{--force} option is not given,
 9920: @c @command{mv} prompts the user for whether to replace the file.  (You might
 9921: @c own the file, or have write permission on its directory.)  If the
 9922: @c response does not begin with @samp{y} or @samp{Y}, the file is skipped.
 9923: @c 
 9924: 移動先のファイルが存在し通常の書き込みが不可で,標準入力が端末で,
 9925: @option{-f}や@option{--force}オプションが与えられていない場合,
 9926: @command{mv}はファイルを置換するかどうか,ユーザにプロンプトを表示しま
 9927: す.(自分が所有するファイル,または,そのディレクトリに書き込み許可が
 9928: ある必要があります.)応答が@samp{y}または@samp{Y}で始まらない場合,ファ
 9929: イルはスキップされます.
 9930: 
 9931: @c @emph{Warning}: If you try to move a symlink that points to a directory,
 9932: @c and you specify the symlink with a trailing slash, then @command{mv}
 9933: @c doesn't move the symlink but instead moves the directory referenced
 9934: @c by the symlink.  @xref{Trailing slashes}.
 9935: @c 
 9936: @emph{警告}:ディレクトリを示すシンボリックリンクを移動しようとし,ス
 9937: ラッシュを後置したシンボリックリンクを指定した場合,@command{mv}はシン
 9938: ボリックリンクを移動しませんが,その代わりにシンボリックリンクが参照す
 9939: るディレクトリを移動します.@xref{Trailing slashes}.
 9940: 
 9941: @c The program accepts the following options.  Also see @ref{Common options}.
 9942: @c 
 9943: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
 9944: してください.
 9945: 
 9946: @table @samp
 9947: 
 9948: @item -b
 9949: @itemx @w{@kbd{--backup}[=@var{method}]}
 9950: @opindex -b
 9951: @opindex --backup
 9952: @vindex VERSION_CONTROL
 9953: @cindex backups, making
 9954: @c @xref{Backup options}.
 9955: @c Make a backup of each file that would otherwise be overwritten or removed.
 9956: @c 
 9957: @xref{Backup options}. 上書きされたり削除されたりするファイルのバック
 9958: アップを作成します.
 9959: 
 9960: @item -f
 9961: @itemx --force
 9962: @opindex -f
 9963: @opindex --force
 9964: @cindex prompts, omitting
 9965: @c Do not prompt the user before removing a destination file.
 9966: @c 
 9967: 移動先のファイルを削除したり上書きしたりする前に,ユーザにプロンプトを
 9968: 表示しません.
 9969: 
 9970: @item -i
 9971: @itemx --interactive
 9972: @opindex -i
 9973: @opindex --interactive
 9974: @cindex prompts, forcing
 9975: @c Prompt whether to overwrite each existing destination file, regardless
 9976: @c of its permissions.  If the response does not begin with @samp{y} or
 9977: @c @samp{Y}, the file is skipped.
 9978: @c 
 9979: ファイルの許可に依存せず,それぞれの既存の移動先のファイルを上書きす
 9980: るかどうかプロンプトを表示します.@samp{y}や@samp{Y}で始まらない返答の
 9981: 場合,ファイルはスキップされます.
 9982: 
 9983: @itemx @w{@kbd{--reply}[=@var{how}]}
 9984: @opindex --reply
 9985: @cindex interactivity
 9986: @c Specifying @option{--reply=yes} is equivalent to using @option{--force}.
 9987: @c Specify @option{--reply=no} to make @command{mv} act as if @samp{no} were
 9988: @c given as a response to every prompt about a destination file.
 9989: @c Specify @option{--reply=query} to make @command{mv} prompt the user
 9990: @c about each existing destination file.
 9991: @c 
 9992: @option{--reply=yes}の指定は,@option{--force}の使用と等価です.
 9993: @command{mv}が移動先のファイルに関するプロンプトに対し@samp{no}が与え
 9994: られているかのように動作させるため,@option{--reply=no}を指定して下さ
 9995: い.移動先のファイルが存在するとき@command{mv}がユーザにプロンプトを表
 9996: 示するようにするため,@option{--reply=query}を指定して下さい.
 9997: 
 9998: @item -u
 9999: @itemx --update
10000: @opindex -u
10001: @opindex --update
10002: @cindex newer files, moving only
10003: @c Do not move a non-directory that has an existing destination with the
10004: @c same or newer modification time.
10005: @c 
10006: 同じまたは新しい編集時間を持つ既存の移動先にディレクトリ以外のものを移
10007: 動しません.
10008: 
10009: @item -v
10010: @itemx --verbose
10011: @opindex -v
10012: @opindex --verbose
10013: @c Print the name of each file before moving it.
10014: @c 
10015: 移動する前にそれぞれのファイル名を出力します.
10016: 
10017: @itemx @w{@kbd{--strip-trailing-slashes}}
10018: @opindex --strip-trailing-slashes
10019: @cindex stripping trailing slashes
10020: @c Remove any trailing slashes from each @var{source} argument.
10021: @c @xref{Trailing slashes}.
10022: @c 
10023: それぞれの@var{source}引数から後置されるスラッシュを削除します.
10024: @xref{Trailing slashes}.
10025: 
10026: @item -S @var{suffix}
10027: @itemx --suffix=@var{suffix}
10028: @opindex -S
10029: @opindex --suffix
10030: @c Append @var{suffix} to each backup file made with @option{-b}.
10031: @c @xref{Backup options}.
10032: @c 
10033: @option{-b}で作成されるそれぞれのバックアップファイルに,@var{suffix}
10034: を追加します.@xref{Backup options}.
10035: 
10036: @itemx @w{@kbd{--target-directory}=@var{directory}}
10037: @opindex --target-directory
10038: @cindex target directory
10039: @cindex destination directory
10040: @c Specify the destination @var{directory}.
10041: @c @xref{Target directory}.
10042: @c 
10043: 移動先の@var{directory}を指定します.@xref{Target directory}.
10044: 
10045: @item -V @var{method}
10046: @itemx --version-control=@var{method}
10047: @opindex -V
10048: @opindex --version-control
10049: @c Change the type of backups made with @option{-b}.  The @var{method}
10050: @c argument can be @samp{none} (or @samp{off}), @samp{numbered} (or
10051: @c @samp{t}), @samp{existing} (or @samp{nil}), or @samp{never} (or
10052: @c @samp{simple}).  @xref{Backup options}.
10053: @c 
10054: @option{-b}で作成されるバックアップの形式を変更します.@var{method}引
10055: 数は,@samp{none} (または@samp{off}),@samp{numbered} (または@samp{t}),
10056: @samp{existing} (または@samp{nil}),または,@samp{never} (または
10057: @samp{simple})が可能です.@xref{Backup options}.
10058: 
10059: @end table
10060: 
10061: 
10062: @node rm invocation
10063: @c @section @command{rm}: Remove files or directories
10064: @section @command{rm}: ファイルやディレクトリの削除
10065: 
10066: @pindex rm
10067: @cindex removing files or directories
10068: 
10069: @c @command{rm} removes each given @var{file}.  By default, it does not remove
10070: @c directories.  Synopsis:
10071: @c 
10072: @command{rm}は与えられた@var{file}を削除します.デフォルトではディレク
10073: トリを削除しません.概要です.
10074: 
10075: @example
10076: rm [@var{option}]@dots{} [@var{file}]@dots{}
10077: @end example
10078: 
10079: @cindex prompting, and @command{rm}
10080: @c If a file is unwritable, standard input is a terminal, and the @option{-f}
10081: @c or @option{--force} option is not given, or the @option{-i} or
10082: @c @option{--interactive} option @emph{is} given, @command{rm} prompts the user
10083: @c for whether to remove the file.  If the response does not begin with
10084: @c @samp{y} or @samp{Y}, the file is skipped.
10085: @c 
10086: ファイルに書き込みができない,標準入力が端末,そして,@option{-f}また
10087: は@option{--force}オプションが与えられていない場合,または,
10088: @option{-i}または@option{--interactive}オプションが与えられて@emph{い
10089: る}場合,@command{rm}はユーザにファイルを削除するかどうかを促すプロン
10090: プトを表示します.@samp{y} や@samp{Y}で始まらない返答の場合,ファイル
10091: は省略されます.
10092: 
10093: @c @emph{Warning}: If you use @command{rm} to remove a file, it is usually
10094: @c possible to recover the contents of that file.  If you want more assurance
10095: @c that the contents are truly unrecoverable, consider using @command{shred}.
10096: 
10097: @emph{警告}:ファイルを削除するために@command{rm}を使用する場合,通常
10098: はファイルの内容を復活させることが可能です.より確実にファイルの内容を
10099: 本当に復活させないようにしたい場合,@command{shred}の使用を検討して下
10100: さい.
10101: 
10102: @c The program accepts the following options.  Also see @ref{Common options}.
10103: @c 
10104: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
10105: してください.
10106: 
10107: @table @samp
10108: 
10109: @item -d
10110: @itemx --directory
10111: @opindex -d
10112: @opindex --directory
10113: @cindex directories, removing with @code{unlink}
10114: @findex unlink
10115: @pindex fsck
10116: @c Attempt to remove directories using the @code{unlink} function rather than
10117: @c the @code{rmdir} function, and
10118: @c don't require a directory to be empty before trying to unlink it.  This works
10119: @c only if you have appropriate privileges and if your operating system supports
10120: @c @code{unlink} for directories.  Because unlinking a directory causes any files
10121: @c in the deleted directory to become unreferenced, it is wise to @command{fsck}
10122: @c the filesystem after doing this.
10123: @c 
10124: @code{rmdir}の代わりに@code{unlink}を用いてディレクトリの削除を試み,
10125: そしてアンリンクを試みる前にディレクトリが空である必要はありません.適
10126: 切な特権を持ち,オペレーティングシステムがディレクトリに対する
10127: @code{unlink}をサポートしている場合のみ,これは動作します.ディレクト
10128: リのアンリンクはディレクトリ内のすべてのファイルを参照できなくなるので,
10129: この後でファイルシステムに@code{fsck}した方が賢明です.
10130: 
10131: @item -f
10132: @itemx --force
10133: @opindex -f
10134: @opindex --force
10135: @c Ignore nonexistent files and never prompt the user.
10136: @c Ignore any previous @option{--interactive} (@option{-i}) option.
10137: @c 
10138: 存在しないファイルを無視し,ユーザにプロンプトを表示しません.前にある
10139: @option{--interactive} (@option{-i})オプションを無視します.
10140: 
10141: @item -i
10142: @itemx --interactive
10143: @opindex -i
10144: @opindex --interactive
10145: @c Prompt whether to remove each file.  If the response does not begin
10146: @c with @samp{y} or @samp{Y}, the file is skipped.
10147: @c Ignore any previous @option{--force} (@option{-f}) option.
10148: @c 
10149: それぞれのファイルを削除するかどうかプロンプトを表示します.@samp{y}や
10150: @samp{Y}で始まらない返答の場合,ファイルはスキップされます.前にある
10151: @option{--force} (@option{-f})オプションを無視します.
10152: 
10153: @item -r
10154: @itemx -R
10155: @itemx --recursive
10156: @opindex -r
10157: @opindex -R
10158: @opindex --recursive
10159: @cindex directories, removing (recursively)
10160: @c Remove the contents of directories recursively.
10161: @c 
10162: ディレクトリの内容を再帰的に削除します.
10163: 
10164: @item -v
10165: @itemx --verbose
10166: @opindex -v
10167: @opindex --verbose
10168: @c Print the name of each file before removing it.
10169: @c 
10170: 削除する前にそれぞれのファイル名を出力します.
10171: 
10172: @end table
10173: 
10174: @cindex files beginning with @samp{-}, removing
10175: @cindex @samp{-}, removing files beginning with
10176: @c One common question is how to remove files whose names begin with a
10177: @c @samp{-}.  @sc{gnu} @command{rm}, like every program that uses the @code{getopt}
10178: @c function to parse its arguments, lets you use the @samp{--} option to
10179: @c indicate that all following arguments are non-options.  To remove a file
10180: @c called @file{-f} in the current directory, you could type either:
10181: @c 
10182: よくある問題の一つは,@samp{-}で始まる名前を持つファイルの削除の方法で
10183: す.@sc{gnu} @command{rm}では,引数を解析する@code{getopt}関数を使用す
10184: るすべてのプログラムに似ていて,以下のすべての引数がオプションでないこ
10185: とを示す@samp{--}オプションを使用します.現在のディレクトリの@file{-f} 
10186: というファイル名を削除するため,以下のどちらかの入力で可能になります.
10187: 
10188: @example
10189: rm -- -f
10190: @end example
10191: 
10192: @noindent
10193: @c or:
10194: @c 
10195: または以下のようにします.
10196: 
10197: @example
10198: rm ./-f
10199: @end example
10200: 
10201: @opindex - @r{and Unix @command{rm}}
10202: @c The Unix @command{rm} program's use of a single @samp{-} for this purpose
10203: @c predates the development of the getopt standard syntax.
10204: @c 
10205: この目的に対する,Unix @command{rm}プログラムの単一の@samp{-}の使用は,
10206: getoptの標準構文の開発以前のものです.
10207: 
10208: 
10209: @node shred invocation
10210: @c @section @command{shred}: Remove files more securely
10211: @section @command{shred}: より安全なファイルの削除
10212: 
10213: @pindex shred
10214: @cindex data, erasing
10215: @cindex erasing data
10216: 
10217: @c @command{shred} overwrites devices or files, to help prevent even
10218: @c very expensive hardware from recovering the data.
10219: @c 
10220: @command{shred}は,非常に高価なハードウェアを用いてもデータの復活を妨
10221: げるように,デバイスやファイルを上書きします.
10222: 
10223: @c Ordinarily when you remove a file (@pxref{rm invocation}), the data is
10224: @c not actually destroyed.  Only the index listing where the file is
10225: @c stored is destroyed, and the storage is made available for reuse.
10226: @c There are undelete utilities that will attempt to reconstruct the index
10227: @c and can bring the file back if the parts were not reused.
10228: @c 
10229: 通常,ファイルを削除するとき(@pxref{rm invocation}),データは実際には
10230: 破壊されません.ファイルが保存されている場所をリストアップしている索引
10231: のみ破壊し,記憶装置は再利用可能になります.索引の再構築を試み,その部
10232: 分が再利用されていない場合,ファイルを元に戻すことが可能なアンデリート
10233: ユーティリティがあります.
10234: 
10235: @c On a busy system with a nearly-full drive, space can get reused in a few
10236: @c seconds.  But there is no way to know for sure.  If you have sensitive
10237: @c data, you may want to be sure that recovery is not possible by actually
10238: @c overwriting the file with non-sensitive data.
10239: @c 
10240: ほとんど満タンのドライブを使用している忙しいシステムでは,スペースは数
10241: 秒で再利用可能になります.しかし,それが確実であることを知る方法はあり
10242: ません.機密データがあり,機密でないデータでファイルを実際に上書きする
10243: ことでリカバリが不可能だということを確かめたいかもしれません.
10244: 
10245: @c However, even after doing that, it is possible to take the disk back
10246: @c to a laboratory and use a lot of sensitive (and expensive) equipment
10247: @c to look for the faint ``echoes'' of the original data underneath the
10248: @c overwritten data.  If the data has only been overwritten once, it's not
10249: @c even that hard.
10250: @c 
10251: しかし,そうした後でも,研究所へディスクを持っていき,上書きされたデー
10252: タの下の元データのかすかな``残響''を探すために感度の高い(そして高価な)
10253: 多くの機器を使用することが可能です.データが一度上書きされただけでは,
10254: それはさほど難しくありません.
10255: 
10256: @c The best way to remove something irretrievably is to destroy the media
10257: @c it's on with acid, melt it down, or the like.  For cheap removable media
10258: @c like floppy disks, this is the preferred method.  However, hard drives
10259: @c are expensive and hard to melt, so the @command{shred} utility tries
10260: @c to achieve a similar effect non-destructively.
10261: @c 
10262: 取り返しができないように何かを削除する最前の方法は,メディアに酸をかけ
10263: て破壊する,溶かしてしまう,またはそれに似たことをすることです.フロッ
10264: ピーディスクのような,安い着脱可能なメディアに対しては,これは好ましい
10265: 方法です.しかし,ハードドライブは高価で,溶かすのが難しいため,
10266: @command{shred}ユーティリティでは破壊することなく類似の効果を達成しよ
10267: うとします.
10268: 
10269: @c This uses many overwrite passes, with the data patterns chosen to
10270: @c maximize the damage they do to the old data.  While this will work on
10271: @c floppies, the patterns are designed for best effect on hard drives.
10272: @c For more details, see the source code and Peter Gutmann's paper
10273: @c @cite{Secure Deletion of Data from Magnetic and Solid-State Memory},
10274: @c from the proceedings of the Sixth USENIX Security Symposium (San Jose,
10275: @c California, 22--25 July, 1996).  The paper is also available online
10276: @c @url{http://www.cs.auckland.ac.nz/~pgut001/pubs/secure_del.html}.
10277: @c 
10278: これは,古いデータに対するダメージを最大にするように選ばれたデータパター
10279: ンで,上書き動作を何回も使用します.これがフロッピーディスクで動作して
10280: いても,パターンはハードドライブで最適な効果があるように設計されている
10281: ものになります.詳細は,ソースコードと,Sixth USENIX Security
10282: Symposium (San Jose, California, 22--25 July, 1996)の予稿から,Peter
10283: Gutmannの論文@cite{Secure Deletion of Data from Magnetic and
10284: Solid-State Memory}を参照してください.論文は
10285: @url{http://www.cs.auckland.ac.nz/~pgut001/pubs/secure_del.html}で,オ
10286: ンラインでも利用可能です.
10287: 
10288: @c @strong{Please note} that @command{shred} relies on a very important assumption:
10289: @c that the filesystem overwrites data in place.  This is the traditional
10290: @c way to do things, but many modern filesystem designs do not satisfy this
10291: @c assumption.  Exceptions include:
10292: @c 
10293: @command{shred}は非常に重要な仮定に依存していることに@strong{注意して
10294: ください}.それは,ファイルシステムがその場所のデータを上書きするとい
10295: うことです.これは伝統的な方法ですが,現代の多くのファイルシステムはこ
10296: の仮定を満足するように設計されていません.例外は以下を含みます.
10297: 
10298: @itemize @bullet
10299: 
10300: @item
10301: @c Log-structured or journaled filesystems, such as those supplied with
10302: @c AIX and Solaris, and JFS, ReiserFS, XFS, Ext3, etc.
10303: @c 
10304: AIXとSolarisが提供するような,Log-structureまたはjournalファイルシステ
10305: ム.
10306: 
10307: @item
10308: @c Filesystems that write redundant data and carry on even if some writes
10309: @c fail, such as RAID-based filesystems.
10310: @c 
10311: RAIDベースのファイルシステムのように,重複したデータを書き込み,書き込
10312: みで失敗した場合でも続けるファイルシステム.
10313: 
10314: @item
10315: @c Filesystems that make snapshots, such as Network Appliance's NFS server.
10316: @c 
10317: Network ApplianceのNFSサーバのような,スナップショットを作成するファイ
10318: ルシステム.
10319: 
10320: @item
10321: @c Filesystems that cache in temporary locations, such as NFS version 3
10322: @c clients.
10323: @c 
10324: NFSのバージョン3のクライアントのような,一時的な位置にキャッシュを作成
10325: するファイルシステム.
10326: 
10327: @item
10328: @c Compressed filesystems.
10329: @c 
10330: 圧縮されているファイルシステム.
10331: @end itemize
10332: 
10333: @c If you are not sure how your filesystem operates, then you should assume
10334: @c that it does not overwrite data in place, which means that shred cannot
10335: @c reliably operate on regular files in your filesystem.
10336: @c 
10337: ファイルシステムがどのように動作しているかよく分からない場合,その場所
10338: に上書きされないと仮定すべきで,それは,そのファイルシステムの通常のファ
10339: イルで,@command{shred}が信頼できる動作を行うことができないことを意味
10340: します.
10341: 
10342: @c Generally speaking, it is more reliable to shred a device than a file,
10343: @c since this bypasses the problem of filesystem design mentioned above.
10344: @c However, even shredding devices is not always completely reliable.  For
10345: @c example, most disks map out bad sectors invisibly to the application; if
10346: @c the bad sectors contain sensitive data, @command{shred} won't be able to
10347: @c destroy it.
10348: @c 
10349: 一般的に言って,上記の手法で設計されたファイルシステムの問題をバイパス
10350: するため,ファイルではなくデバイスに@command{shred}するとより信頼でき
10351: ます.しかし,デバイスを@command{shred}してさえ,常に完全に信頼するこ
10352: とはできません.例えば,ほとんどのディスクは,不良セクタがアプリケーショ
10353: ンに見えないようにをマッピングします.不良セクタが機密データを含む場合,
10354: @command{shred}ではそれを破壊することは不可能です.
10355: 
10356: @c @command{shred} makes no attempt to detect or report this problem, just as
10357: @c it makes no attempt to do anything about backups.  However, since it is
10358: @c more reliable to shred devices than files, @command{shred} by default does
10359: @c not truncate or remove the output file.  This default is more suitable
10360: @c for devices, which typically cannot be truncated and should not be
10361: @c removed.
10362: @c 
10363: @command{shred}は,バックアップについて何もしないように,これらの問題
10364: の検出も報告も試みません.しかし,ファイルではなくデバイスに
10365: @command{shred}する方がより信頼できるので,@command{shred}はデフォルト
10366: で出力ファイルを切り詰めたり削除したりしません.このデフォルトはデバイ
10367: スに対しより適していて,それは通常切り詰めもできませんし,削除もすべき
10368: ではありません.
10369: 
10370: @c Finally, consider the risk of backups and mirrors.
10371: @c File system backups and remote mirrors may contain copies of the
10372: @c file that cannot be removed, and that will allow a shredded file
10373: @c to be recovered later.  So if you keep any data you may later want
10374: @c to destroy using @command{shred}, be sure that it is not backed up or mirrored.
10375: @c 
10376: 最後に,バックアップとミラーの危険性を検討します.ファイルシステムのバッ
10377: クアップとリモートのミラーには,削除不可能なファイルのコピーが含まれ,
10378: それで@command{shred}したファイルを後に復活させることが可能です.その
10379: ため,その後@command{shred}を使用して破壊したいデータを保持している場
10380: 合,バックアップやミラーが無いことを確かめて下さい.
10381: 
10382: @example
10383: shred [@var{option}]@dots{} @var{file}[@dots{}]
10384: @end example
10385: 
10386: @c The program accepts the following options.  Also see @ref{Common options}.
10387: @c 
10388: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
10389: してください.
10390: 
10391: @table @samp
10392: 
10393: @item -f
10394: @itemx --force
10395: @opindex -f
10396: @opindex --force
10397: @cindex force deletion
10398: @c Override file permissions if necessary to allow overwriting.
10399: @c 
10400: 上書き可能が必要な場合,ファイルの許可に優先させます.
10401: 
10402: @item -@var{NUMBER}
10403: @itemx -n @var{NUMBER}
10404: @itemx --iterations=@var{NUMBER}
10405: @opindex -n @var{NUMBER}
10406: @opindex --iterations=@var{NUMBER}
10407: @cindex iterations, selecting the number of
10408: @c By default, @command{shred} uses 25 passes of overwrite.  This is enough
10409: @c for all of the useful overwrite patterns to be used at least once.
10410: @c You can reduce this to save time, or increase it if you have a lot of
10411: @c time to waste.
10412: @c 
10413: デフォルトで,@command{shred}は25回の上書きを使用します.これで,少な
10414: くとも一回の使用で使用される有用な上書きパターンの全てに対して十分にな
10415: ります.時間の節約のため減らしたり,時間の無駄遣いをする場合に増やすこ
10416: とが可能です.
10417: 
10418: @item -s @var{BYTES}
10419: @itemx --size=@var{BYTES}
10420: @opindex -s @var{BYTES}
10421: @opindex --size=@var{BYTES}
10422: @cindex size of file to shred
10423: @c Shred the first @var{BYTES} bytes of the file. The default is to shred
10424: @c the whole file.  @var{BYTES} can be followed by a size specification like
10425: @c @samp{K}, @samp{M}, or @samp{G} to specify a multiple. @xref{Block size}.
10426: @c 
10427: ファイルの最初の@var{BYTES}バイトを@command{shred}します.デフォルトは
10428: ファイル全体を@command{shred}します.@var{BYTES}は乗数を指定するために,
10429: @samp{k},@samp{M},または@samp{G}のようなサイズ指定を続けることができ
10430: ます.@xref{Block size}.
10431: 
10432: @item -u
10433: @itemx --remove
10434: @opindex -u
10435: @opindex --remove
10436: @cindex removing files after shredding
10437: @c After shredding a file, truncate it (if possible) and then remove it.
10438: @c If a file has multiple links, only the named links will be removed.
10439: @c 
10440: ファイルを@command{shred}した後,(可能な場合は)それを切り詰め,そして
10441: 削除します.ファイルが複数のリンクを持つ場合,指名されたリンクのみ削除
10442: されます.
10443: 
10444: @item -v
10445: @itemx --verbose
10446: @opindex -v
10447: @opindex --verbose
10448: @c Display status updates as sterilization proceeds.
10449: @c 
10450: バイ菌の増殖のようにステータスの表示を更新します.
10451: 
10452: @item -x
10453: @itemx --exact
10454: @opindex -x
10455: @opindex --exact
10456: @c By default, @command{shred} rounds the size of a regular file up to the next
10457: @c multiple of the filesystem block size to fully erase the last block of the file.
10458: @c Use @option{--exact} to suppress that behavior.
10459: @c Thus, by default if you shred a 10-byte regular file on a system with 512-byte
10460: @c blocks, the resulting file will be 512 bytes long.  With this option,
10461: @c shred does not increase the apparent size of the file.
10462: @c 
10463: デフォルトで,@command{shred}は,ファイルの最後のブロックまで完全に消
10464: 去するため,通常のファイルのサイズをファイルシステムのブロックサイズの
10465: 次の乗数まで切り上げます.その動作を抑制するため,@option{--exact}を使
10466: 用して下さい.このため,デフォルトでは,512バイトのブロックを持つファ
10467: イルシステム上の,10バイトの通常のファイルを@command{shred}する場合,
10468: 結果としてファイルは512バイトになります.このオプションを用いると,
10469: @command{shred}はファイルのサイズを増加させません.
10470: 
10471: @item -z
10472: @itemx --zero
10473: @opindex -z
10474: @opindex --zero
10475: @c Normally, the last pass that @command{shred} writes is made up of
10476: @c random data.  If this would be conspicuous on your hard drive (for
10477: @c example, because it looks like encrypted data), or you just think
10478: @c it's tidier, the @option{--zero} option adds an additional overwrite pass with
10479: @c all zero bits.  This is in addition to the number of passes specified
10480: @c by the @option{--iterations} option.
10481: @c 
10482: 通常,@command{shred}の書き込みの最終動作は,ランダムデータの作成です.
10483: これが(例えば,暗号化されたデータのように見えるため)ハードディスク上で
10484: 目立つ場合や,より整然とさせたいと考える場合,@option{--zero}オプショ
10485: ンで全てをゼロビットを用いて上書きする動作を追加します.これは,
10486: @option{--iterations}オプションで指定した動作数に追加されます.
10487: 
10488: @item -
10489: @opindex -
10490: @c Shred standard output.
10491: @c 
10492: 標準出力を@command{shred}します.
10493: 
10494: @c This argument is considered an option.  If the common @samp{--} option has
10495: @c been used to indicate the end of options on the command line, then @samp{-}
10496: @c will be interpreted as an ordinary file name.
10497: @c 
10498: この引数はオプションと見なされます.一般的な@samp{--}オプションはコマ
10499: ンドラインのオプションの終りを示すために使用されますが,@samp{-}は普通
10500: のファイルとして解釈されます.
10501: 
10502: @c The intended use of this is to shred a removed temporary file.
10503: @c For example
10504: @c 
10505: この使用目的は,削除された一時ファイルを@command{shred}することです.
10506: 例です.
10507: 
10508: @example
10509: i=`tempfile -m 0600`
10510: exec 3<>"$i"
10511: rm -- "$i"
10512: echo "Hello, world" >&3
10513: shred - >&3
10514: exec 3>-
10515: @end example
10516: 
10517: @c Note that the shell command @samp{shred - >file} does not shred the
10518: @c contents of @var{file}, since it truncates @var{file} before invoking
10519: @c @command{shred}.  Use the command @samp{shred file} or (if using a
10520: @c Bourne-compatible shell) the command @samp{shred - 1<>file} instead.
10521: @c 
10522: シェルコマンド@samp{shred - >file}は,@command{shred}の呼び出しの前に,
10523: それが@var{file}を切り詰めるため,@var{file}の内容を@samp{shred}しない
10524: ことに注意してください.コマンド@samp{shred file},または(Bourne互換シェ
10525: ルを使用している場合は)コマンド@samp{shred - 1<>file}を代わりに使用し
10526: てください.
10527: 
10528: @end table
10529: 
10530: @c You might use the following command to erase all trace of the
10531: @c filesystem you'd created on the floppy disk in your first drive.
10532: @c That command takes about 20 minutes to erase a ``1.44MB'' (actually
10533: @c 1440 KiB) floppy.
10534: @c 
10535: 最初のドライブのフロッピーディスクに作成されたファイルシステムの,全て
10536: の記録を消去するために,以下のコマンドを使用するかもしれません.そのコ
10537: マンドは,1.44MBフロッピーを消去するために約20分かかります.
10538: 
10539: @example
10540: shred --verbose /dev/fd0
10541: @end example
10542: 
10543: @c Similarly, to erase all data on a selected partition of
10544: @c your hard disk, you could give a command like this:
10545: @c 
10546: 同様に,ハードディスクの選択されたパーティションの全てのデータを消去す
10547: るために,以下のようなコマンドを与えることが可能です.
10548: 
10549: @example
10550: shred --verbose /dev/sda5
10551: @end example
10552: 
10553: @node Special file types
10554: @c @chapter Special file types
10555: @chapter 特殊ファイルの形式
10556: 
10557: @cindex special file types
10558: @cindex file types, special
10559: 
10560: @c This chapter describes commands which create special types of files (and
10561: @c @command{rmdir}, which removes directories, one special file type).
10562: @c 
10563: この章は,特殊な形式のファイルを作成する方法(そして,特殊なファイル形
10564: 式の一つのディレクトリを削除する@command{rmdir}方法)を記述します.
10565: 
10566: @cindex special file types
10567: @cindex file types
10568: @c Although Unix-like operating systems have markedly fewer special file
10569: @c types than others, not @emph{everything} can be treated only as the
10570: @c undifferentiated byte stream of @dfn{normal files}.  For example, when a
10571: @c file is created or removed, the system must record this information,
10572: @c which it does in a @dfn{directory}---a special type of file.  Although
10573: @c you can read directories as normal files, if you're curious, in order
10574: @c for the system to do its job it must impose a structure, a certain
10575: @c order, on the bytes of the file.  Thus it is a ``special'' type of file.
10576: @c 
10577: Unixのようなオペレーティングシステムでは,他のものより特殊なファイル形
10578: 式は著しく少ないのですが,@emph{すべて}のものを@dfn{通常のファイル
10579: (normal files)}と差異の無いバイトストリームとして扱うことが可能だとい
10580: うわけではありません.例えば,ファイルを作成したり削除したりするとき,
10581: システムはこの情報を記録する必要があり,それは@dfn{ディレクトリ
10582: (directory)} --- 特殊な形式のファイル --- で行います.興味があれば,ディ
10583: レクトリを通常のファイルとして読み込むことも可能ですが,システムにその
10584: 作業をさせるために,ファイルのバイト上で構造,特定の順序を強制する必要
10585: があります.このためそれは``特殊な''形式のファイルとなります.
10586: 
10587: @c Besides directories, other special file types include named pipes
10588: @c (FIFOs), symbolic links, sockets, and so-called @dfn{special files}.
10589: @c 
10590: ディレクトリ以外では,特殊なファイル形式は,名前付きパイプ(FIFO),シン
10591: ボリックリンク,ソケット,そして@dfn{特殊ファイル(special files)}と呼
10592: ばれるものを含みます.
10593: 
10594: @menu
10595: * link invocation::             Make a hard link via the link syscall
10596: * ln invocation::               Make links between files.
10597: * mkdir invocation::            Make directories.
10598: * mkfifo invocation::           Make FIFOs (named pipes).
10599: * mknod invocation::            Make block or character special files.
10600: * readlink invocation::         Print the referent of a symbolic link.
10601: * rmdir invocation::            Remove empty directories.
10602: * unlink invocation::           Remove files via the unlink syscall
10603: @end menu
10604: 
10605: 
10606: @node link invocation
10607: @c @section @command{link}: Make a hard link via the link syscall
10608: @section @command{link}: linkシステムコールでハードリンクを作成する
10609: 
10610: @pindex link
10611: @cindex links, creating
10612: @cindex hard links, creating
10613: @cindex creating links (hard only)
10614: 
10615: @c @command{link} creates a single hard link at a time.
10616: @c It is a minimalist interface to the system-provided
10617: @c @code{link} function.  @xref{Hard Links, , , libc,
10618: @c The GNU C Library Reference Manual}.
10619: @c Synopsis:
10620: @c 
10621: @command{link}は単一のハードリンクを一度に作成します.それは,システム
10622: が提供する@code{link}関数への最小のインターフェースです.@xref{Hard
10623: Links, , , libc, The GNU C Library Reference Manual}.  概要です.
10624: 
10625: @example
10626: link @var{filename} @var{linkname}
10627: @end example
10628: 
10629: @c @var{filename} must specify an existing file, and @var{linkname}
10630: @c must specify a nonexistent entry in an existing directory.
10631: @c @command{link} simply calls @code{link (@var{filename}, @var{linkname})}
10632: @c to create the link.
10633: @c 
10634: @var{filename}は既存のファイルにする必要があり,@var{linkname}既存のディ
10635: レクトリに存在しないものを指定する必要があります.@command{link}はリン
10636: クを作成するために,単純に@code{link (@var{filename}, @var{linkname})} 
10637: を呼び出します.
10638: 
10639: @node ln invocation
10640: @c @section @command{ln}: Make links between files
10641: @section @command{ln}: ファイル間にリンクを作成
10642: 
10643: @pindex ln
10644: @cindex links, creating
10645: @cindex hard links, creating
10646: @cindex symbolic (soft) links, creating
10647: @cindex creating links (hard or soft)
10648: 
10649: @cindex filesystems and hard links
10650: @c @command{ln} makes links between files.  By default, it makes hard links;
10651: @c with the @option{-s} option, it makes symbolic (or @dfn{soft}) links.
10652: @c Synopses:
10653: @c 
10654: @command{ln}は,ファイル間のリンクを作成します.デフォルトで,それはハー
10655: ドリンクを作成します.@option{-s}を用いると,シンボリック(または
10656: @dfn{ソフト(soft)})リンクを作成します.概要です.
10657: 
10658: @example
10659: ln [@var{option}]@dots{} @var{target} [@var{linkname}]
10660: ln [@var{option}]@dots{} @var{target}@dots{} @var{directory}
10661: @end example
10662: 
10663: @itemize @bullet
10664: 
10665: @c @item If the last argument names an existing directory, @command{ln} creates a
10666: @c link to each @var{target} file in that directory, using the
10667: @c @var{target}s' names.  (But see the description of the
10668: @c @option{--no-dereference} option below.)
10669: @c 
10670: @item
10671: 最後の引数が既存のディレクトリを示す場合,@command{ln}はそのディレクト
10672: リ内のそれぞれの@var{target}ファイルに,@var{target}の名前を使用しなが
10673: らリンクを作成します.(しかし,以下の@option{--no-dereference}オプショ
10674: ンの記述を参照してください.)
10675: 
10676: @c @item If two filenames are given, @command{ln} creates a link from the
10677: @c second to the first.
10678: @c 
10679: @item
10680: 二つのファイル名が与えられた場合,@command{ln}は二番目から一番目へのリ
10681: ンクを作成します.
10682: 
10683: @c @item If one @var{target} is given, @command{ln} creates a link to that
10684: @c file in the current directory.
10685: @c 
10686: @item
10687: 一つの@var{target}が与えられた場合,@command{ln}は,現在のディレクトリ
10688: のそのファイルにリンクを作成します.
10689: 
10690: @c @item It is an error if the last argument is not a directory and more
10691: @c than two files are given.  Without @option{-f} or @option{-i} (see below),
10692: @c @command{ln} will not remove an existing file.  Use the @option{--backup}
10693: @c option to make @command{ln} rename existing files.
10694: @c 
10695: @item
10696: 最後の引数がディレクトリでなく,二つ以上のファイルが与えられた場合はエ
10697: ラーとなります.@option{-f}や@option{-i} (以下を参照)を用いない場合,
10698: @command{ln}は既存のファイルを削除しません.@command{ln}に既存のファイ
10699: ルの名前を変えさせるために,@option{--backup}オプションを使用してくだ
10700: さい.
10701: 
10702: @end itemize
10703: 
10704: @cindex hard link, defined
10705: @cindex inode, and hard links
10706: @c A @dfn{hard link} is another name for an existing file; the link and the
10707: @c original are indistinguishable.  Technically speaking, they share the
10708: @c same inode, and the inode contains all the information about a
10709: @c file---indeed, it is not incorrect to say that the inode @emph{is} the
10710: @c file.  On all existing implementations, you cannot make a hard link to
10711: @c a directory, and hard links cannot cross filesystem boundaries.  (These
10712: @c restrictions are not mandated by @acronym{POSIX}, however.)
10713: @c 
10714: @dfn{ハードリンク(hard link)}は,既存のファイルの別名です.リンクとオ
10715: リジナルは区別できません.技術的には,それらは同じinodeを共有し,inode 
10716: はファイルに関する必要な情報をすべて含んでいます --- 実際,inodeがファ
10717: イル@emph{である}と言っても間違いではありません.既存のすべての実装で
10718: は,ディレクトリにハードリンクを作成できず,ハードリンクはファイルシス
10719: テム間をまたぐことができません.(しかしながら,これらの制限は
10720: @acronym{POSIX}とマッチしません.)
10721: 
10722: @cindex dereferencing symbolic links
10723: @cindex symbolic link, defined
10724: @c @dfn{Symbolic links} (@dfn{symlinks} for short), on the other hand, are
10725: @c a special file type (which not all kernels support: System V release 3
10726: @c (and older) systems lack symlinks) in which the link file actually
10727: @c refers to a different file, by name.  When most operations (opening,
10728: @c reading, writing, and so on) are passed the symbolic link file, the
10729: @c kernel automatically @dfn{dereferences} the link and operates on the
10730: @c target of the link.  But some operations (e.g., removing) work on the
10731: @c link file itself, rather than on its target.  @xref{Symbolic Links,,,
10732: @c libc, The GNU C Library Reference Manual}.
10733: @c 
10734: 一方,@dfn{シンボリックリンク(Symbolic links)} (短く言うと
10735: @dfn{symlinks})は,リンクファイルが実際には名前の異なるファイルを参照
10736: する特殊なファイル形式です(すべてのカーネルがサポートしているわけでは
10737: ありません.System V release 3(とそれより古いもの)はsymlinkがありませ
10738: ん).ほとんどの処理(開く,読み込む,書き出す等)は,シンボリックリンク
10739: を通じて行われ,カーネルは自動的にリンクを@dfn{dereferences}し,リンク
10740: 先を処理します.しかし,リンク先ではなくリンクファイル自身に作用する
10741: (例えば削除)処理もあります.@xref{Symbolic Links,,, library, The GNU C
10742: Library Reference Manual}.
10743: 
10744: @c The program accepts the following options.  Also see @ref{Common options}.
10745: @c 
10746: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
10747: してください.
10748: 
10749: @table @samp
10750: 
10751: @item -b
10752: @itemx @w{@kbd{--backup}[=@var{method}]}
10753: @opindex -b
10754: @opindex --backup
10755: @vindex VERSION_CONTROL
10756: @cindex backups, making
10757: @c @xref{Backup options}.
10758: @c Make a backup of each file that would otherwise be overwritten or removed.
10759: @c 
10760: @xref{Backup options}.  上書きされたり削除されたりするそれぞれのファイ
10761: ルのバックアップを作成します.
10762: 
10763: @item -d
10764: @itemx -F
10765: @itemx --directory
10766: @opindex -d
10767: @opindex -F
10768: @opindex --directory
10769: @cindex hard links to directories
10770: @c Allow the super-user to make hard links to directories.
10771: @c 
10772: スーパーユーザがディレクトリのハードリンクを作成できるようにします.
10773: 
10774: @item -f
10775: @itemx --force
10776: @opindex -f
10777: @opindex --force
10778: @c Remove existing destination files.
10779: @c 
10780: 既存のリンク先ファイルを削除します.
10781: 
10782: @item -i
10783: @itemx --interactive
10784: @opindex -i
10785: @opindex --interactive
10786: @cindex prompting, and @command{ln}
10787: @c Prompt whether to remove existing destination files.
10788: @c 
10789: 既存リンク先ファイルを削除するかどうか,プロンプトを表示します.
10790: 
10791: @item -n
10792: @itemx --no-dereference
10793: @opindex -n
10794: @opindex --no-dereference
10795: @c When given an explicit destination that is a symlink to a directory,
10796: @c treat that destination as if it were a normal file.
10797: @c 
10798: 明示的な,ディレクトリへのシンボリックリンクとなるリンク先が与えられた
10799: とき,リンク先を通常のファイルとして扱います.
10800: 
10801: @c When the destination is an actual directory (not a symlink to one),
10802: @c there is no ambiguity.  The link is created in that directory.
10803: @c But when the specified destination is a symlink to a directory,
10804: @c there are two ways to treat the user's request.  @command{ln} can
10805: @c treat the destination just as it would a normal directory and create
10806: @c the link in it.  On the other hand, the destination can be viewed as a
10807: @c non-directory---as the symlink itself.  In that case, @command{ln}
10808: @c must delete or backup that symlink before creating the new link.
10809: @c The default is to treat a destination that is a symlink to a directory
10810: @c just like a directory.
10811: @c 
10812: リンク先が(シンボリックリンクではない)実際のディレクトリのとき,不明瞭
10813: なことはありません.しかし,指定されたリンク先がディレクトリへのシンボ
10814: リックリンクの時,ユーザの要求の扱い方は,二通りあります.@command{ln} 
10815: は,リンク先を通常のディレクトリとして扱い,それに対するリンクを作成す
10816: ることができます.一方,リンク先を非ディレクトリ --- シンボリックリン
10817: ク --- として見ることもできます.その場合,@command{ln}は,新しいリン
10818: クを作成する前に,そのシンボリックリンクを削除またはバックアップする必
10819: 要があります.デフォルトでは,ディレクトリへのシンボリックリンクである
10820: リンク先を,ディレクトリと同様に扱います.
10821: 
10822: @item -s
10823: @itemx --symbolic
10824: @opindex -s
10825: @opindex --symbolic
10826: @c Make symbolic links instead of hard links.  This option merely produces
10827: @c an error message on systems that do not support symbolic links.
10828: @c 
10829: ハードリンクの代わりにシンボリックリンクを作成します.このオプションは,
10830: シンボリックリンクをサポートしていないシステムでは,単にエラーメッセー
10831: ジを生成します.
10832: 
10833: @item -S @var{suffix}
10834: @itemx --suffix=@var{suffix}
10835: @opindex -S
10836: @opindex --suffix
10837: @c Append @var{suffix} to each backup file made with @option{-b}.
10838: @c @xref{Backup options}.
10839: @c 
10840: @option{-b}を用いて生成されるそれぞれのバックアップファイルに
10841: @var{suffix}を追加します.@xref{Backup options}.
10842: 
10843: @itemx @w{@kbd{--target-directory}=@var{directory}}
10844: @opindex --target-directory
10845: @cindex target directory
10846: @cindex destination directory
10847: @c Specify the destination @var{directory}.
10848: @c @xref{Target directory}.
10849: @c 
10850: リンク先@var{directory}を指定します.@xref{Target directory}.
10851: 
10852: @item -v
10853: @itemx --verbose
10854: @opindex -v
10855: @opindex --verbose
10856: @c Print the name of each file before linking it.
10857: @c 
10858: リンクする前にそれぞれのファイル名を出力します.
10859: 
10860: @item -V @var{method}
10861: @itemx --version-control=@var{method}
10862: @opindex -V
10863: @opindex --version-control
10864: @c Change the type of backups made with @option{-b}.  The @var{method}
10865: @c argument can be @samp{none} (or @samp{off}), @samp{numbered} (or
10866: @c @samp{t}), @samp{existing} (or @samp{nil}), or @samp{never} (or
10867: @c @samp{simple}).  @xref{Backup options}.
10868: @c 
10869: @option{-b}で作成されるバックアップの形式を変更します.@var{method}引
10870: 数は,@samp{none} (または@samp{off}),@samp{numbered} (または@samp{t}),
10871: @samp{existing} (または@samp{nil}),または,@samp{never} (または
10872: @samp{simple})が可能です.@xref{Backup options}.
10873: 
10874: @end table
10875: 
10876: @c Examples:
10877: @c 
10878: 以下は例です.
10879: 
10880: @smallexample
10881: ln -s /some/name  # creates link ./name pointing to /some/name
10882: ln -s /some/name myname  # creates link ./myname pointing to /some/name
10883: ln -s a b ..      # creates links ../a and ../b pointing to ./a and ./b
10884: @end smallexample
10885: 
10886: 
10887: @node mkdir invocation
10888: @c @section @command{mkdir}: Make directories
10889: @section @command{mkdir}: ディレクトリの作成
10890: 
10891: @pindex mkdir
10892: @cindex directories, creating
10893: @cindex creating directories
10894: 
10895: @c @command{mkdir} creates directories with the specified names.  Synopsis:
10896: @c 
10897: @command{mkdir}は指定された名前でディレクトリを作成します.概要です.
10898: 
10899: @example
10900: mkdir [@var{option}]@dots{} @var{name}@dots{}
10901: @end example
10902: 
10903: @c If a @var{name} is an existing file but not a directory, @command{mkdir} prints a
10904: @c warning message on stderr and will exit with a status of 1 after
10905: @c processing any remaining @var{name}s.  The same is done when a @var{name} is an
10906: @c existing directory and the -p option is not given.  If a @var{name} is an
10907: @c existing directory and the -p option is given, @command{mkdir} will ignore it.
10908: @c That is, @command{mkdir} will not print a warning, raise an error, or change
10909: @c the mode of the directory (even if the -m option is given), and will
10910: @c move on to processing any remaining @var{name}s.
10911: @c 
10912: @var{name}が既存のファイルでディレクトリではない場合,@command{mkdir} 
10913: は標準エラー出力に警告メッセージを出力し,残っている@var{name}を処理し
10914: た後,1のステータスで終了します.@var{name}が既存のディレクトリで,
10915: @samp{-p}オプションが与えられていないときも同じです.@var{name}が既存
10916: のディレクトリで,@samp{-p}オプションが与えられている場合,
10917: @command{mkdir}はそれを無視します.すなわち,@command{mkdir}は警告の出
10918: 力も,エラーの発生も,(@samp{-m}オプションが与えられていても)ディレク
10919: トリのモードの変更もせず,残りの@var{name}の処理を続けます.
10920: 
10921: @c The program accepts the following options.  Also see @ref{Common options}.
10922: @c 
10923: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
10924: してください.
10925: 
10926: @table @samp
10927: 
10928: @item -m @var{mode}
10929: @itemx --mode=@var{mode}
10930: @opindex -m
10931: @opindex --mode
10932: @cindex modes of created directories, setting
10933: @c Set the mode of created directories to @var{mode}, which is symbolic as
10934: @c in @command{chmod} and uses @samp{a=rwx} (read, write and execute allowed for
10935: @c everyone) minus the bits set in the umask for the point of the
10936: @c departure.  @xref{File permissions}.
10937: @c 
10938: 作成されるディレクトリのモードを@var{mode}で設定し,それは
10939: @command{chmod}で設定する抽象的なもので,(読み書きと実行を全員に許可す
10940: る)@samp{a=rwx}から目的のポイントのためにumaskのビットセットを引いたも
10941: のを使用します.@xref{File permissions}.
10942: 
10943: @item -p
10944: @itemx --parents
10945: @opindex -p
10946: @opindex --parents
10947: @cindex parent directories, creating
10948: @c Make any missing parent directories for each argument.  The mode for parent
10949: @c directories is set to the umask modified by @samp{u+wx}.
10950: @c Ignore arguments corresponding to existing directories.
10951: @c 
10952: それぞれの引数に対し,足りない親ディレクトリを作成します.親ディレクト
10953: リのモードは@samp{u+wx}で編集されたumaskに設定します.既存のディレクト
10954: リに対する引数は無視します.
10955: 
10956: @item -v
10957: @item --verbose
10958: @opindex -v
10959: @opindex --verbose
10960: @c Print a message for each created directory.  This is most useful with
10961: @c @option{--parents}.
10962: @c 
10963: 作成されるそれぞれのディレクトリに対しメッセージを出力します.これは
10964: @option{--parents}とともに用いると最も便利です.
10965: @end table
10966: 
10967: 
10968: @node mkfifo invocation
10969: @c @section @command{mkfifo}: Make FIFOs (named pipes)
10970: @section @command{mkfifo}: FIFO(名前付きパイプ)の作成
10971: 
10972: @pindex mkfifo
10973: @cindex FIFOs, creating
10974: @cindex named pipes, creating
10975: @cindex creating FIFOs (named pipes)
10976: 
10977: @c @command{mkfifo} creates FIFOs (also called @dfn{named pipes}) with the
10978: @c specified names.  Synopsis:
10979: @c 
10980: @command{mkfifo}はFIFO(@dfn{名前付きパイプ(named pipes)}とも呼ばれる)
10981: を指定された名前で作成します.概要です.
10982: 
10983: @example
10984: mkfifo [@var{option}] @var{name}@dots{}
10985: @end example
10986: 
10987: @c A @dfn{FIFO} is a special file type that permits independent processes
10988: @c to communicate.  One process opens the FIFO file for writing, and
10989: @c another for reading, after which data can flow as with the usual
10990: @c anonymous pipe in shells or elsewhere.
10991: @c 
10992: @dfn{FIFO}は,個別のプロセス間の通信を可能にする特殊なファイル形式です.
10993: 一つのプロセスは書き込みで,もう一つは読み込みでFIFOを開き,データは,
10994: シェルやその他の通常の名前無しパイプのように流れます.
10995: 
10996: @c The program accepts the following option.  Also see @ref{Common options}.
10997: @c 
10998: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
10999: してください.
11000: 
11001: @table @samp
11002: 
11003: @item -m @var{mode}
11004: @itemx --mode=@var{mode}
11005: @opindex -m
11006: @opindex --mode
11007: @cindex modes of created FIFOs, setting
11008: @c Set the mode of created FIFOs to @var{mode}, which is symbolic as in
11009: @c @command{chmod} and uses @samp{a=rw} (read and write allowed for everyone) minus
11010: @c the bits set in the umask for the point of departure.  @xref{File permissions}.
11011: @c 
11012: 作成されるFIFOのモードを@var{mode}に設定し,それは@command{chmod}で設
11013: 定する抽象的なもので,(読み込みと書き出しを全員に許可する)@samp{a=rw}
11014: から目的のポイントのためにumaskのビットセットを引いたものを使用します.
11015: @xref{File permissions}.
11016: 
11017: @end table
11018: 
11019: 
11020: @node mknod invocation
11021: @c @section @command{mknod}: Make block or character special files
11022: @section @command{mknod}: ブロックやキャラクタ特殊ファイルの作成
11023: 
11024: @pindex mknod
11025: @cindex block special files, creating
11026: @cindex character special files, creating
11027: 
11028: @c @command{mknod} creates a FIFO, character special file, or block special
11029: @c file with the specified name.  Synopsis:
11030: @c 
11031: @command{mknod}は,FIFO,キャラクタ特殊ファイルや,ブロック特殊ファイ
11032: ルを指定された名前で作成します.概要です.
11033: 
11034: @example
11035: mknod [@var{option}]@dots{} @var{name} @var{type} [@var{major} @var{minor}]
11036: @end example
11037: 
11038: @cindex special files
11039: @cindex block special files
11040: @cindex character special files
11041: @c Unlike the phrase ``special file type'' above, the term @dfn{special
11042: @c file} has a technical meaning on Unix: something that can generate or
11043: @c receive data.  Usually this corresponds to a physical piece of hardware,
11044: @c e.g., a printer or a disk.  (These files are typically created at
11045: @c system-configuration time.)  The @command{mknod} command is what creates
11046: @c files of this type.  Such devices can be read either a character at a
11047: @c time or a ``block'' (many characters) at a time, hence we say there are
11048: @c @dfn{block special} files and @dfn{character special} files.
11049: @c 
11050: 上記の``特殊ファイル形式''と異なり,@dfn{特殊ファイル(special file)}と
11051: いう用語は,Unix上で技術的な意味があります.それはデータを生成または受
11052: 信するものです.これは通常,ハードウェアの物理的な部分に対応します.
11053: (これらのファイルは,通常,システム設定時に作成されます.)
11054: @command{mknod}コマンドは,この形式のファイルを作成するものです.その
11055: ようなデバイスは,一度に一文字または一度に一``ブロック''(多くの文字)読
11056: み込むことが可能で,そのため,@dfn{ブロック特殊(block special)}ファイ
11057: ルと@dfn{キャラクタ特殊(character special)}ファイルがあると我々は述べ
11058: ています.
11059: 
11060: @c The arguments after @var{name} specify the type of file to make:
11061: @c 
11062: @var{name}の後の引数は作成するファイルの形式を指定します.
11063: 
11064: @table @samp
11065: 
11066: @item p
11067: @opindex p @r{for FIFO file}
11068: @c for a FIFO
11069: @c 
11070: FIFOに対応します.
11071: 
11072: @item b
11073: @opindex b @r{for block special file}
11074: @c for a block special file
11075: @c 
11076: ブロック特殊ファイルに対応します.
11077: 
11078: @item c
11079: @c Don't document the `u' option -- it's just a synonym for `c'.
11080: @c Do *any* versions of mknod still use it?
11081: @c @itemx u
11082: @opindex c @r{for character special file}
11083: @c @opindex u @r{for character special file}
11084: @c for a character special file
11085: @c 
11086: キャラクタ特殊ファイルに対応します.
11087: 
11088: @end table
11089: 
11090: @c When making a block or character special file, the major and minor
11091: @c device numbers must be given after the file type.
11092: @c If a major or minor device number begins with @samp{0x} or @samp{0X},
11093: @c it is interpreted as hexadecimal; otherwise, if it begins with @samp{0},
11094: @c as octal; otherwise, as decimal.
11095: @c 
11096: ブロックやキャラクタ特殊ファイルを作成しているとき,メジャーとマイナー
11097: デバイス番号をファイル形式の後に与える必要があります.メジャーまたはマ
11098: イナーのデバイス番号が@samp{0x}や@samp{0X}で始まる場合,それは16進数と
11099: して解釈されます.それ以外で@samp{0}で始まる場合は八進数,それ以外では
11100: 十進数です.
11101: 
11102: @c The program accepts the following option.  Also see @ref{Common options}.
11103: @c 
11104: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
11105: してください.
11106: 
11107: @table @samp
11108: 
11109: @item -m @var{mode}
11110: @itemx --mode=@var{mode}
11111: @opindex -m
11112: @opindex --mode
11113: @c Set the mode of created files to @var{mode}, which is symbolic as in
11114: @c @command{chmod} and uses @samp{a=rw} minus the bits set in the umask as the point
11115: @c of departure.  @xref{File permissions}.
11116: @c 
11117: 作成されるファイルのモードを@var{mode}に設定し,それは@command{chmod}
11118: で設定する抽象的なもので,@samp{a=rw}から目的のポイントのためにumaskの
11119: ビットセットを引いたものを使用します.@xref{File permissions}.
11120: 
11121: @end table
11122: 
11123: 
11124: @node readlink invocation
11125: @c @section @command{readlink}: Print the referent of a symbolic link
11126: @section @command{readlink}: シンボリックリンクの対象を出力
11127: 
11128: @pindex readlink
11129: @cindex displaying value of a symbolic link
11130: 
11131: @c @command{readlink} may work in one of two supported modes:
11132: @c 
11133: @command{readlink}は,サポートされている二つのモードの一つで動作します.
11134: 
11135: @table @samp
11136: 
11137: @c @item Readlink mode
11138: @item readlinkモード
11139: 
11140: @c @command{readlink} outputs the value of the given symbolic link.
11141: @c If @command{readlink} is invoked with an argument other than the pathname
11142: @c of a symbolic link, it exits with a non-zero exit code.
11143: @c 
11144: @command{readlink}は,与えられたシンボリックリンクの値を出力します.
11145: @command{readlink}がシンボリックリンクのパス名以外の引数で呼び出される
11146: 場合,ゼロ以外の終了コードで終了します.
11147: 
11148: @c @item Canonicalize mode
11149: @item canonicalizeモード
11150: 
11151: @c @command{readlink} outputs the absolute name of the given file which contains
11152: @c no `.', `..' components nor any repeated path separators (`/') or symlinks.
11153: @c In any of the path components is missing or unavailable,
11154: @c it exits with a non-zero exit code.
11155: @c 
11156: @command{readlink}は,`.',`..' も,繰返されるパス分離子(`/')もシンボ
11157: リックリンクも含めず,与えられた絶対的なファイル名を出力します.構成要
11158: 素が足りない,または利用不可能なパスでは,ゼロ以外の終了コードで終了し
11159: ます.
11160: 
11161: @end table
11162: 
11163: @example
11164: readlink [@var{option}] @var{file}
11165: @end example
11166: 
11167: @c By default, @command{readlink} operates in readlink mode.
11168: @c 
11169: デフォルトで,@command{readlink}はreadlinkモードで処理します.
11170: 
11171: @c The program accepts the following options.  Also see @ref{Common options}.
11172: @c 
11173: プログラムは以下のオプションを受け入れます.@ref{Common options}も参照
11174: して下さい.
11175: 
11176: @table @samp
11177: 
11178: @item -f
11179: @itemx --canonicalize
11180: @opindex -f
11181: @opindex --canonicalize
11182: @c Activate canonicalize mode.
11183: @c 
11184: canonicalizeモードで実行します.
11185: 
11186: @item -n
11187: @itemx --no-newline
11188: @opindex -n
11189: @opindex --no-newline
11190: @c Do not output the trailing newline.
11191: @c 
11192: 後置される改行を出力しません.
11193: 
11194: @item -s
11195: @itemx -q
11196: @itemx --silent
11197: @itemx --quiet
11198: @opindex -s
11199: @opindex -q
11200: @opindex --silent
11201: @opindex --quiet
11202: @c Suppress most error messages.
11203: @c 
11204: ほとんどのエラーメッセージを抑制します.
11205: 
11206: @item -v
11207: @itemx --verbose
11208: @opindex -v
11209: @opindex --verbose
11210: @c Report error messages.
11211: @c 
11212: エラーメッセージを報告します.
11213: 
11214: @end table
11215: 
11216: @c The @command{readlink} utility first appeared in OpenBSD 2.1.
11217: @c 
11218: @command{readlink}は,OpenBSD 2.1で最初に書かれました.
11219: 
11220: 
11221: @node rmdir invocation
11222: @c @section @command{rmdir}: Remove empty directories
11223: @section @command{rmdir}: 空のディレクトリの削除
11224: 
11225: @pindex rmdir
11226: @cindex removing empty directories
11227: @cindex directories, removing empty
11228: 
11229: @c @command{rmdir} removes empty directories.  Synopsis:
11230: @c 
11231: @command{rmdir}は空のディレクトリを削除します.概要です.
11232: 
11233: @example
11234: rmdir [@var{option}]@dots{} @var{directory}@dots{}
11235: @end example
11236: 
11237: @c If any @var{directory} argument does not refer to an existing empty
11238: @c directory, it is an error.
11239: @c 
11240: @var{directory}引数が既存の空のディレクトリを参照していない場合,エラー
11241: となります.
11242: 
11243: @c The program accepts the following option.  Also see @ref{Common options}.
11244: @c 
11245: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
11246: してください.
11247: 
11248: @table @samp
11249: 
11250: @item --ignore-fail-on-non-empty
11251: @opindex --ignore-fail-on-non-empty
11252: @cindex directory deletion, ignoring failures
11253: @c Ignore each failure to remove a directory that is solely because
11254: @c the directory is non-empty.
11255: @c 
11256: ディレクトリが空でないため,それぞれ単独であるディレクトリ削除の失敗を
11257: 無視します.
11258: 
11259: @item -p
11260: @itemx --parents
11261: @opindex -p
11262: @opindex --parents
11263: @cindex parent directories, removing
11264: @c Remove @var{directory}, then try to remove each component of @var{directory}.
11265: @c So, for example, @samp{rmdir -p a/b/c} is similar to @samp{rmdir a/b/c a/b a}.
11266: @c As such, it fails if any of those directories turns out not to be empty.
11267: @c Use the @option{--ignore-fail-on-non-empty} option to make it so such
11268: @c a failure does not evoke a diagnostic and does not cause @command{rmdir} to
11269: @c exit unsuccessfully.
11270: @c 
11271: @var{directory}を削除し,それぞれの@var{directory}の構成要素の削除を試
11272: みます.そのため,例えば,@samp{rmdir -p a/b/c}は@samp{rmdir a/b/c a/b
11273: a}に似ています.同様に,これらのディレクトリが空でないと判明した場合は
11274: 失敗します.そのような失敗で,診断を引き起こし,@command{rmdir}を失敗
11275: で終了させないため,@option{--ignore-fail-on-non-empty}オプションを使
11276: 用してください.
11277: 
11278: @item -v
11279: @item --verbose
11280: @opindex -v
11281: @opindex --verbose
11282: @cindex directory deletion, reporting
11283: @c Give a diagnostic for each successful removal.
11284: @c @var{directory} is removed.
11285: @c 
11286: 削除に成功したそれぞれの診断を提唱します.@var{directory}は削除されま
11287: す.
11288: 
11289: @end table
11290: 
11291: @c @xref{rm invocation}, for how to remove non-empty directories (recursively).
11292: @c 
11293: 空でないディレクトリの(再帰的な)削除方法は,@xref{rm invocation}.
11294: 
11295: @node unlink invocation
11296: @c @section @command{unlink}: Remove files via the unlink syscall
11297: @section @command{unlink}: unlinkシステムコールでファイルを削除
11298: 
11299: @pindex unlink
11300: @cindex removing files or directories (via the unlink syscall)
11301: 
11302: @c @command{unlink} deletes a single specified file name.
11303: @c It is a minimalist interface to the system-provided
11304: @c @code{unlink} function.  @xref{Deleting Files, , , libc,
11305: @c The GNU C Library Reference Manual}.  Synopsis:
11306: @c 
11307: @command{unlink}は,単一の指定されたファイル名を削除します.それは,シ
11308: ステムが提供する@code{unlink}関数の最小のインターフェースです.
11309: @xref{Deleting Files, , , libc, The GNU C Library Reference
11310: Manual}. 概要です.
11311: 
11312: @example
11313: unlink @var{filename}
11314: @end example
11315: 
11316: @c On some systems @code{unlink} can be used to delete the name of a
11317: @c directory.  On others, it can be used that way only by a privileged user.
11318: @c In the GNU system @code{unlink} can never delete the name of a directory.
11319: @c 
11320: システムには,@code{unlink}を削除するディレクトリ名として使用可能なも
11321: のもあります.その他に,特権ユーザだけがそうすることが可能なものもあり
11322: ます.GNUシステムでは,@code{unlink}でディレクトリ名を削除することはあ
11323: りません.
11324: 
11325: @c By default, @command{unlink} honors the @option{--help} and @option{--version}
11326: @c options.  That makes it a little harder to remove files named
11327: @c @code{--help} and @code{--version}, so when the environment variable
11328: @c @env{POSIXLY_CORRECT} is set, @command{unlink} treats such a command line
11329: @c arguments not as an option, but as an operand.
11330: @c 
11331: デフォルトで,@command{unlink}は@option{--help}と@option{--version}オ
11332: プションを尊重します.それによって,@code{--help}や@code{--version}と
11333: 命名されたファイルの削除がちょっと難しくなるので,環境変数
11334: @env{POSIXLY_CORRECT}が設定されているときは,@command{unlink}はそのよ
11335: うなコマンドライン引数をオプションではなくオペランドとして扱います.
11336: 
11337: 
11338: @node Changing file attributes
11339: @c @chapter Changing file attributes
11340: @chapter ファイル属性の変更
11341: 
11342: @cindex changing file attributes
11343: @cindex file attributes, changing
11344: @cindex attributes, file
11345: 
11346: @c A file is not merely its contents, a name, and a file type
11347: @c (@pxref{Special file types}).  A file also has an owner (a userid), a
11348: @c group (a group id), permissions (what the owner can do with the file,
11349: @c what people in the group can do, and what everyone else can do), various
11350: @c timestamps, and other information.  Collectively, we call these a file's
11351: @c @dfn{attributes}.
11352: @c 
11353: ファイルとは,その内容,名前,そしてファイル形式(@pxref{Special file
11354: types})だけの存在ではありません.ファイルには,所有者(ユーザID),グルー
11355: プ(グループID),許可(所有者がファイルに行えること,グループの人ができ
11356: ること,そして,その他誰でも可能であること),様々なタイムスタンプ,そ
11357: してその他の情報があります.まとめて,これらをファイルの@dfn{属性
11358: (attributes)}と呼びます.
11359: 
11360: @c These commands change file attributes.
11361: @c 
11362: これらのコマンドはファイルの属性を変更します.
11363: 
11364: @menu
11365: * chgrp invocation::            Change file groups.
11366: * chmod invocation::            Change access permissions.
11367: * chown invocation::            Change file owners and groups.
11368: * touch invocation::            Change file timestamps.
11369: @end menu
11370: 
11371: 
11372: @node chown invocation
11373: @c @section @command{chown}: Change file owner and group
11374: @section @command{chown}: ファイルの所有者とグループの変更
11375: 
11376: @pindex chown
11377: @cindex file ownership, changing
11378: @cindex group ownership, changing
11379: @cindex changing file ownership
11380: @cindex changing group ownership
11381: 
11382: @c @command{chown} changes the user and/or group ownership of each given @var{file}
11383: @c to @var{new-owner} or to the user and group of an existing reference file.
11384: @c Synopsis:
11385: @c 
11386: @command{chown}は,与えられたそれぞれの@var{file}のユーザと/またはグルー
11387: プの所有権を,@var{new-owner}や,既存の参照ファイルのユーザとグループ
11388: に変更します.概要です.
11389: 
11390: @example
11391: chown [@var{option}]@dots{} @{@var{new-owner} | --reference=@var{ref_file}@} @var{file}@dots{}
11392: @end example
11393: 
11394: @c If used, @var{new-owner} specifies the new owner and/or group as follows
11395: @c (with no embedded white space):
11396: @c 
11397: @var{new-owner}が使用された場合,新しい所有者と/またはグループを以下の
11398: ように指定します(空白は含みません).
11399: 
11400: @example
11401: [@var{owner}] [ [:] [@var{group}] ]
11402: @end example
11403: 
11404: @c Specifically:
11405: @c 
11406: 具体例です.
11407: 
11408: @table @var
11409: @item owner
11410: @c If only an @var{owner} (a user name or numeric user id) is given, that
11411: @c user is made the owner of each given file, and the files' group is not
11412: @c changed.
11413: @c 
11414: @var{owner} (ユーザ名または数値的なユーザID)のみ与えられた場合,そのユー
11415: ザが与えられたそれぞれのファイルの所有者になり,ファイルのグループは変
11416: 更されません.
11417: 
11418: @itemx owner@samp{:}group
11419: @c If the @var{owner} is followed by a colon and a @var{group} (a
11420: @c group name or numeric group id), with no spaces between them, the group
11421: @c ownership of the files is changed as well (to @var{group}).
11422: @c 
11423: @var{owner}にコロンと@var{group} (グループ名または数値的なグループID) 
11424: が,それら間にスペースを置かずに続いている場合,ファイルのグループ所有
11425: 権を(@var{group}に)同様に変更します.
11426: 
11427: @itemx owner@samp{:}
11428: @c If a colon but no group name follows @var{owner}, that user is
11429: @c made the owner of the files and the group of the files is changed to
11430: @c @var{owner}'s login group.
11431: @c 
11432: コロンはあるが,グループ名が@var{owner}に続かない場合,ユーザがファイ
11433: ルの所有者になり,ファイルのグループは@var{owner}のログイングループに
11434: 変更されます.
11435: 
11436: @itemx @samp{:}group
11437: @c If the colon and following @var{group} are given, but the owner
11438: @c is omitted, only the group of the files is changed; in this case,
11439: @c @command{chown} performs the same function as @command{chgrp}.
11440: @c 
11441: コロンとそれに続く@var{group}が与えられているが所有者が省略されている
11442: 場合,ファイルのグループのみ変更されます.この場合,@command{chown}は
11443: @command{chgrp} と同じ機能を果たします.
11444: 
11445: @end table
11446: 
11447: @c You may use @samp{.} in place of the @samp{:} separator.  This is a
11448: @c @sc{gnu} extension for compatibility with older scripts.
11449: @c New scripts should avoid the use of @samp{.} because @sc{gnu} @command{chown}
11450: @c may fail if @var{owner} contains @samp{.} characters.
11451: @c 
11452: @samp{:}セパレータの場所に@samp{.}を使用することが可能です.これは古い
11453: スクリプトへの互換性のための@sc{gnu}の拡張です.@sc{gnu}
11454: @command{chown}は,@var{owner}が@samp{.}文字を含む場合は失敗する可能性
11455: があるので,新しいスクリプトでは@samp{.}の使用を避けるべきです.
11456: 
11457: @c The program accepts the following options.  Also see @ref{Common options}.
11458: @c 
11459: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
11460: してください.
11461: 
11462: @table @samp
11463: 
11464: @item -c
11465: @itemx --changes
11466: @opindex -c
11467: @opindex --changes
11468: @cindex changed owners, verbosely describing
11469: @c Verbosely describe the action for each @var{file} whose ownership
11470: @c actually changes.
11471: @c 
11472: 所有権が実際に変更されるそれぞれの@var{file}に対する動作を,冗長に記述
11473: します.
11474: 
11475: @item -f
11476: @itemx --silent
11477: @itemx --quiet
11478: @opindex -f
11479: @opindex --silent
11480: @opindex --quiet
11481: @cindex error messages, omitting
11482: @c Do not print error messages about files whose ownership cannot be
11483: @c changed.
11484: @c 
11485: 所有権を変更できないファイルについてのエラーメッセージを出力しません.
11486: 
11487: @itemx @w{@kbd{--from}=@var{old-owner}}
11488: @opindex --from
11489: @cindex symbolic links, changing owner
11490: @c Change a @var{file}'s ownership only if it has current attributes specified
11491: @c by @var{old-owner}.  @var{old-owner} has the same form as @var{new-owner}
11492: @c described above.
11493: @c This option is useful primarily from a security standpoint in that
11494: @c it narrows considerably the window of potential abuse.
11495: @c For example, to reflect a UID numbering change for one user's files
11496: @c without an option like this, @code{root} might run
11497: @c 
11498: @var{old-owner}で指定されている現在の属性がある場合,@var{file}の所有
11499: 権を変更します.@var{old-owner}は,上記の@var{new-owner}の記述と同じ形
11500: 式です.このオプションは,潜在的な悪習の窓をかなり狭めるという点で,セ
11501: キュリティの立場から主に役に立ちます.例えば,以下のように,このオプショ
11502: ンを使用しないで,ユーザのファイルに対してUIDの変更を反映させるために,
11503: @code{root}が実行したとします.
11504: 
11505: @smallexample
11506: find / -owner OLDUSER -print0 | xargs -0 chown NEWUSER
11507: @end smallexample
11508: 
11509: @c But that is dangerous because the interval between when the @command{find}
11510: @c tests the existing file's owner and when the @command{chown} is actually run
11511: @c may be quite large.
11512: @c One way to narrow the gap would be to invoke chown for each file
11513: @c as it is found:
11514: @c 
11515: しかし,@command{find}が既存のファイルの所有者をテストしたときと,
11516: @command{chown}が実際に実行したときの間が非常に長い可能性があるので,
11517: それは危険です.ギャップを小さくするひとつの方法は,それぞれのファイル
11518: に対し見つかったときに@command{chown}を呼び出すことです.
11519: 
11520: @example
11521: find / -owner OLDUSER -exec chown NEWUSER @{@} \;
11522: @end example
11523: 
11524: @c But that is very slow if there are many affected files.
11525: @c With this option, it is safer (the gap is narrower still)
11526: @c though still not perfect:
11527: @c 
11528: しかし,影響されるファイルが多い場合は,それは非常に遅くなります.この
11529: オプションを用いると,(ギャップを狭めたままで)完全ではありませんが,そ
11530: れは安全になります.
11531: 
11532: @example
11533: chown -R --from=OLDUSER NEWUSER /
11534: @end example
11535: 
11536: @item --dereference
11537: @opindex --dereference
11538: @cindex symbolic links, changing owner
11539: @findex lchown
11540: @c Do not act on symbolic links themselves but rather on what they point to.
11541: @c 
11542: シンボリックリンク自身に動作せず,それが示すものに動作します.
11543: 
11544: @item -h
11545: @itemx --no-dereference
11546: @opindex -h
11547: @opindex --no-dereference
11548: @cindex symbolic links, changing owner
11549: @findex lchown
11550: @c Act on symbolic links themselves instead of what they point to.
11551: @c This is the default.
11552: @c This mode relies on the @code{lchown} system call.
11553: @c On systems that do not provide the @code{lchown} system call,
11554: @c @command{chown} fails when a file specified on the command line
11555: @c is a symbolic link.
11556: @c By default, no diagnostic is issued for symbolic links encountered
11557: @c during a recursive traversal, but see @option{--verbose}.
11558: @c 
11559: シンボリックリンクが示すものではなく,それ自身に動作します.これはデフォ
11560: ルトです.このモードは@code{lchown}システムコールに依存します.
11561: @code{lchown}システムコールが提供されていないシステムでは,コマンドラ
11562: インで指定されるファイルがシンボリックリンクの時,@command{chown}は失
11563: 敗します.デフォルトで,再帰的な処理の間に発見されるシンボリックリンク
11564: に対する診断結果は表示されませんが,それについては@option{--verbose}は
11565: 参照してください.
11566: 
11567: @item --reference=@var{ref_file}
11568: @opindex --reference
11569: @c Change the user and group of each @var{file} to be the same as those of
11570: @c @var{ref_file}.  If @var{ref_file} is a symbolic link, do not use the
11571: @c user and group of the symbolic link, but rather those of the file it
11572: @c refers to.
11573: @c 
11574: それぞれの@var{file}のユーザとグループを,@var{ref_file}と同じになるよ
11575: うに変更します.@var{ref_file}がシンボリックリンクの場合,シンボリック
11576: リンクのユーザとグループではなく,それが参照するファイルのものを使用し
11577: ます.
11578: 
11579: @item -v
11580: @itemx --verbose
11581: @opindex -v
11582: @opindex --verbose
11583: @c Output a diagnostic for every file processed.
11584: @c If a symbolic link is encountered during a recursive traversal
11585: @c on a system without the @code{lchown} system call, and @option{--no-dereference}
11586: @c is in effect, then issue a diagnostic saying neither the symbolic link nor
11587: @c its referent is being changed.
11588: @c 
11589: 処理された全てのファイルに対し,診断結果を出力します.@code{lchown}シ
11590: ステムコールがないシステムで,再帰的な処理の間にシンボリックリンクが見
11591: つかり,@option{--no-dereference}の影響がある場合,シンボリックリンク
11592: もその参照先も変更されないことを告げる診断結果を表示します.
11593: 
11594: @item -R
11595: @itemx --recursive
11596: @opindex -R
11597: @opindex --recursive
11598: @cindex recursively changing file ownership
11599: @c Recursively change ownership of directories and their contents.
11600: @c 
11601: ディレクトリとその内容の所有権を再帰的に変更します.
11602: 
11603: @end table
11604: 
11605: 
11606: @node chgrp invocation
11607: @c @section @command{chgrp}: Change group ownership
11608: @section @command{chgrp}: グループの所有権の変更
11609: 
11610: @pindex chgrp
11611: @cindex group ownership, changing
11612: @cindex changing group ownership
11613: 
11614: @c @command{chgrp} changes the group ownership of each given @var{file}
11615: @c to @var{group} (which can be either a group name or a numeric group id)
11616: @c or to the group of an existing reference file.  Synopsis:
11617: @c 
11618: @command{chgrp}は,それぞれの与えられた@var{file}のグループ所有権を
11619: @var{group}(グループ名またはグループIDのどちらかで与えられるはずです),
11620: または,既存の参照ファイルのグループに変更します.概要です.
11621: 
11622: @example
11623: chgrp [@var{option}]@dots{} @{@var{group} | --reference=@var{ref_file}@} @var{file}@dots{}
11624: @end example
11625: 
11626: @c The program accepts the following options.  Also see @ref{Common options}.
11627: @c 
11628: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
11629: してください.
11630: 
11631: @table @samp
11632: 
11633: @item -c
11634: @itemx --changes
11635: @opindex -c
11636: @opindex --changes
11637: @cindex changed files, verbosely describing
11638: @c Verbosely describe the action for each @var{file} whose group actually
11639: @c changes.
11640: @c 
11641: グループが実際に変更されているそれぞれの@var{file}に対し,動作を冗長に
11642: 記述します.
11643: 
11644: @item -f
11645: @itemx --silent
11646: @itemx --quiet
11647: @opindex -f
11648: @opindex --silent
11649: @opindex --quiet
11650: @cindex error messages, omitting
11651: @c Do not print error messages about files whose group cannot be
11652: @c changed.
11653: @c 
11654: グループを変更できなかったファイルに関するエラーメッセージを出力しませ
11655: ん.
11656: 
11657: @item --dereference
11658: @opindex --dereference
11659: @cindex symbolic links, changing owner
11660: @findex lchown
11661: @c Do not act on symbolic links themselves but rather on what they point to.
11662: @c 
11663: シンボリックリンク自身に作用するのではなく,それが指し示すものに作用し
11664: ます.
11665: 
11666: @item -h
11667: @itemx --no-dereference
11668: @opindex -h
11669: @opindex --no-dereference
11670: @cindex symbolic links, changing group
11671: @findex lchown
11672: @c Act on symbolic links themselves instead of what they point to.
11673: @c This is the default.
11674: @c This mode relies on the @code{lchown} system call.
11675: @c On systems that do not provide the @code{lchown} system call,
11676: @c @command{chgrp} fails when a file specified on the command line
11677: @c is a symbolic link.
11678: @c By default, no diagnostic is issued for symbolic links encountered
11679: @c during a recursive traversal, but see @option{--verbose}.
11680: @c 
11681: シンボリックリンクを,それが指し示すものの代わりにそれ自身に動作します.
11682: これはデフォルトです.このモードは@code{lchown}システムコールに依存し
11683: ます.コマンドラインで指定されているファイルがシンボリックリンクの時,
11684: @command{chgrp}は失敗します.デフォルトで,再帰的な変換の間に見つかっ
11685: たシンボリックリンクに対し診断結果は表示されませんが,それについては
11686: @option{--verbose}を参照してください.
11687: 
11688: @item --reference=@var{ref_file}
11689: @opindex --reference
11690: @c Change the group of each @var{file} to be the same as that of
11691: @c @var{ref_file}.  If @var{ref_file} is a symbolic link, do not use the
11692: @c group of the symbolic link, but rather that of the file it refers to.
11693: @c 
11694: それぞれの@var{file}のグループを,@var{ref_file}と同じになるように変更
11695: します.@var{ref_file}がシンボリックリンクの場合,シンボリックリンクの
11696: グループではなく,それが参照するファイルのものを使用します.
11697: 
11698: @item -v
11699: @itemx --verbose
11700: @opindex -v
11701: @opindex --verbose
11702: @c Output a diagnostic for every file processed.
11703: @c If a symbolic link is encountered during a recursive traversal
11704: @c on a system without the @code{lchown} system call, and @option{--no-dereference}
11705: @c is in effect, then issue a diagnostic saying neither the symbolic link nor
11706: @c its referent is being changed.
11707: @c 
11708: 処理した全てのファイルに対し,診断結果を出力します.@code{lchown}シス
11709: テムコールがないシステムで,再帰的な変換の間にシンボリックリンクが見つ
11710: かり,@option{--no-dereference}が有効でない場合,シンボリックリンクも
11711: 参照するものも変更されないことを告げる診断結果を表示します.
11712: 
11713: @item -R
11714: @itemx --recursive
11715: @opindex -R
11716: @opindex --recursive
11717: @cindex recursively changing group ownership
11718: @c Recursively change the group ownership of directories and their contents.
11719: @c 
11720: ディレクトリとその内容のグループ所有権を再帰的に変更します.
11721: 
11722: @end table
11723: 
11724: 
11725: @node chmod invocation
11726: @c @section @command{chmod}: Change access permissions
11727: @section @command{chmod}: アクセス許可の変更
11728: 
11729: @pindex chmod
11730: @cindex changing access permissions
11731: @cindex access permissions, changing
11732: @cindex permissions, changing access
11733: 
11734: @c @command{chmod} changes the access permissions of the named files.  Synopsis:
11735: @c 
11736: @command{chmod}は指名されたファイルのアクセス許可を変更します.概要で
11737: す.
11738: 
11739: @example
11740: chmod [@var{option}]@dots{} @{@var{mode} | --reference=@var{ref_file}@} @var{file}@dots{}
11741: @end example
11742: 
11743: @cindex symbolic links, permissions of
11744: @c @command{chmod} never changes the permissions of symbolic links, since
11745: @c the @command{chmod} system call cannot change their permissions.
11746: @c This is not a problem since the permissions of symbolic links are
11747: @c never used.  However, for each symbolic link listed on the command
11748: @c line, @command{chmod} changes the permissions of the pointed-to file.
11749: @c In contrast, @command{chmod} ignores symbolic links encountered during
11750: @c recursive directory traversals.
11751: @c 
11752: @command{chmod}システムコールは,シンボリックリンクの許可を変更できな
11753: いため,@command{chmod}はそれらのの許可を決して変更しません.シンボリッ
11754: クリンクの許可は決して使用されないので,これは問題ではありません.しか
11755: し,コマンドラインでリストアップされたそれぞれのシンボリックリンクに対
11756: し,@command{chmod}は指し示されたファイルの許可を変更します.その代わ
11757: り,再帰的にディレクトリを横断している間,@command{chmod}は,遭遇した
11758: シンボリックリンクを無視します.
11759: 
11760: @c If used, @var{mode} specifies the new permissions.
11761: @c For details, see the section on @ref{File permissions}.
11762: @c 
11763: @var{mode}が使用されている場合,それは新しい許可を指定します.詳細は
11764: @ref{File permissions}のセクションを参照してください.
11765: 
11766: @c The program accepts the following options.  Also see @ref{Common options}.
11767: @c 
11768: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
11769: してください.
11770: 
11771: @table @samp
11772: 
11773: @item -c
11774: @itemx --changes
11775: @opindex -c
11776: @opindex --changes
11777: @c Verbosely describe the action for each @var{file} whose permissions
11778: @c actually changes.
11779: @c 
11780: 許可が実際に変更されているそれぞれの@var{file}に対し,動作を冗長に記述
11781: します.
11782: 
11783: @item -f
11784: @itemx --silent
11785: @itemx --quiet
11786: @opindex -f
11787: @opindex --silent
11788: @opindex --quiet
11789: @cindex error messages, omitting
11790: @c Do not print error messages about files whose permissions cannot be
11791: @c changed.
11792: @c 
11793: 許可を変更できなかったファイルに関するエラーメッセージを出力しません.
11794: 
11795: @item -v
11796: @itemx --verbose
11797: @opindex -v
11798: @opindex --verbose
11799: @c Verbosely describe the action or non-action taken for every @var{file}.
11800: @c 
11801: 与えられたすべての@var{file}に対し,動作,非動作の冗長な記述を行います.
11802: 
11803: @item --reference=@var{ref_file}
11804: @opindex --reference
11805: @c Change the mode of each @var{file} to be the same as that of @var{ref_file}.
11806: @c @xref{File permissions}.
11807: @c If @var{ref_file} is a symbolic link, do not use the mode
11808: @c of the symbolic link, but rather that of the file it refers to.
11809: @c 
11810: それぞれの@var{file}のモードを,@var{ref_file}と同じになるように変更し
11811: ます.@xref{File permissions}.  @var{ref_file}がシンボリックリンクの場
11812: 合,シンボリックリンクのモードではなく,それが参照するファイルのものを
11813: 使用します.
11814: 
11815: @item -R
11816: @itemx --recursive
11817: @opindex -R
11818: @opindex --recursive
11819: @cindex recursively changing access permissions
11820: @c Recursively change permissions of directories and their contents.
11821: @c 
11822: ディレクトリとその内容の許可を再帰的に変更します.
11823: 
11824: @end table
11825: 
11826: 
11827: @node touch invocation
11828: @c @section @command{touch}: Change file timestamps
11829: @section @command{touch}: ファイルのタイプスタンプの変更
11830: 
11831: @pindex touch
11832: @cindex changing file timestamps
11833: @cindex file timestamps, changing
11834: @cindex timestamps, changing file
11835: 
11836: @c @command{touch} changes the access and/or modification times of the
11837: @c specified files.  Synopsis:
11838: @c 
11839: @command{touch}は,指定されたファイルのアクセスと/や編集された時間を変
11840: 更します.概要です.
11841: 
11842: @example
11843: touch [@var{option}]@dots{} @var{file}@dots{}
11844: @end example
11845: 
11846: @c On older systems, @command{touch} supports an obsolete syntax, as follows.
11847: @c If the first @var{file} would be a valid argument to the @option{-t}
11848: @c option and no timestamp is given with any of the @option{-d}, @option{-r},
11849: @c or @option{-t} options and the @samp{--} argument is not given, that
11850: @c argument is interpreted as the time for the other files instead of
11851: @c as a file name.  @acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance})
11852: @c does not allow this; use @option{-t} instead.
11853: @c 
11854: 古いシステムでは,@command{touch}は以下のような時代遅れの構文ををサポー
11855: トしています.最初の@var{file}が@option{-t}オプションの有効な引数で,
11856: タイムスタンプが@option{-d},@option{-r},または@option{-t}オプション
11857: で全く与えられておらず,@samp{--}引数が与えられていない場合,その引数
11858: はファイル名としてではなく,その他のファイルに対する時間として解釈され
11859: ます.@acronym{POSIX} 1003.1-2001 (@pxref{Standards conformance})では,
11860: これを許可していません.代わりに@option{-t}を使用してください.
11861: 
11862: @cindex empty files, creating
11863: @c Any @var{file} that does not exist is created empty.
11864: @c 
11865: 存在しない@var{file}はすべて空として作成されます.
11866: 
11867: @cindex permissions, for changing file timestamps
11868: @c If changing both the access and modification times to the current
11869: @c time, @command{touch} can change the timestamps for files that the user
11870: @c running it does not own but has write permission for.  Otherwise, the
11871: @c user must own the files.
11872: @c 
11873: アクセスと編集の時間の両方を現在の時間に変更するとき,@command{touch}
11874: は実行しているユーザがファイルの所有者で無いが,書き込み許可があるもの
11875: のタイムスタンプを変更することができます.それ以外では,ユーザはそのファ
11876: イルの所有者である必要があります.
11877: 
11878: @c Although @command{touch} provides options for changing two of the times --
11879: @c the times of last access and modification -- of a file, there is actually
11880: @c a third one as well: the inode change time.  This is often referred to
11881: @c as a file's @code{ctime}.
11882: @c The inode change time represents the time when the file's meta-information
11883: @c last changed.  One common example of this is when the permissions of a
11884: @c file change.  Changing the permissions doesn't access the file, so
11885: @c the atime doesn't change, nor does it modify the file, so the mtime
11886: @c doesn't change.  Yet, something about the file itself has changed,
11887: @c and this must be noted somewhere.  This is the job of the ctime field.
11888: @c This is necessary, so that, for example, a backup program can make a
11889: @c fresh copy of the file, including the new permissions value.
11890: @c Another operation that modifies a file's ctime without affecting
11891: @c the others is renaming.  In any case, it is not possible, in normal
11892: @c operations, for a user to change the ctime field to a user-specified value.
11893: @c 
11894: @command{touch}は,ファイルの二つの時間 -- 最後のアクセスと編集 -- を
11895: 変更するオプションを提供しますが,実際には三番目のinodeの変更時間も同
11896: じです.これはファイルの@code{ctime}としてよく参照されます.inodeの変
11897: 更時間は,ファイルのメタ情報が最後に変更された時間を表現します.一般的
11898: な例の一つは,ファイルの許可を変更したときです.許可の変更は,ファイル
11899: にアクセスしないのでatimeを変更しませんし,ファイルの編集もしないので
11900: mtimeも変更しません.しかし,ファイル自身の何かは変っていまて,これは
11901: どこかに記録する必要があります.これはctimeフィールドの仕事です.例え
11902: ば,バックアッププログラムが新しい許可値まで含めてファイルの新しいコピー
11903: を作成することを可能にするために,これが必要になります.他に影響しない
11904: ようにファイルのctimeを編集するもう一つの処理は名前の変更です.通常の
11905: 処理では,ユーザがctimeフィールドをユーザが指定した値に変更することは,
11906: いかなる場合でも不可能です.
11907: 
11908: @c The program accepts the following options.  Also see @ref{Common options}.
11909: @c 
11910: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
11911: して下さい.
11912: 
11913: @table @samp
11914: 
11915: @item -a
11916: @itemx --time=atime
11917: @itemx --time=access
11918: @itemx --time=use
11919: @opindex -a
11920: @opindex --time
11921: @opindex atime@r{, changing}
11922: @opindex access @r{time, changing}
11923: @opindex use @r{time, changing}
11924: @c Change the access time only.
11925: @c 
11926: アクセス時間だけ変更します.
11927: 
11928: @item -c
11929: @itemx --no-create
11930: @opindex -c
11931: @opindex --no-create
11932: @c Do not create files that do not exist.
11933: @c 
11934: 存在していないファイルを作成しません.
11935: 
11936: @item -d
11937: @itemx --date=time
11938: @opindex -d
11939: @opindex --date
11940: @opindex time
11941: @c Use @var{time} instead of the current time.  It can contain month names,
11942: @c time zones, @samp{am} and @samp{pm}, etc.  @xref{Date input formats}.
11943: @c 
11944: 現在の時間の代わりに@var{time}を指定します.それは,月名,タイムゾーン,
11945: @samp{am}と@samp{pm}等を含めることが可能です.@xref{Date input
11946: formats}.
11947: 
11948: @item -f
11949: @opindex -f
11950: @cindex BSD @command{touch} compatibility
11951: @c Ignored; for compatibility with BSD versions of @command{touch}.
11952: @c 
11953: 無視されます.BSD版の@command{touch}の互換性のためです.
11954: 
11955: @item -m
11956: @itemx --time=mtime
11957: @itemx --time=modify
11958: @opindex -m
11959: @opindex --time
11960: @opindex mtime@r{, changing}
11961: @opindex modify @r{time, changing}
11962: @c Change the modification time only.
11963: @c 
11964: 編集時間だけ変更します.
11965: 
11966: @item -r @var{file}
11967: @itemx --reference=@var{file}
11968: @opindex -r
11969: @opindex --reference
11970: @c Use the times of the reference @var{file} instead of the current time.
11971: @c 
11972: 現在の時間の代わりに参照@var{file}の時間を使用します.
11973: 
11974: @item -t [[CC]YY]MMDDhhmm[.ss]
11975: @c Use the argument (optional four-digit or two-digit years, months,
11976: @c days, hours, minutes, optional seconds) instead of the current time.
11977: @c If the year is specified with only two digits, then @var{CC}
11978: @c is 20 for years in the range 0 @dots{} 68, and 19 for years in
11979: @c 69 @dots{} 99.  If no digits of the year are specified,
11980: @c the argument is interpreted as a date in the current year.
11981: @c 
11982: 現在の時間の代わりに引数(オプションの四桁または二桁の年,月,日,時間,
11983: 分,オプションの秒)を使用します.年が二桁のみで指定された場合,
11984: @var{CC}は,0 @dots{} 68に対し20,69 @dots{} 99に対し19になります.年
11985: の数字が指定されない場合,今年の日付として解釈されます.
11986: 
11987: @end table
11988: 
11989: 
11990: @node Disk usage
11991: @c @chapter Disk usage
11992: @chapter ディクスの使用
11993: 
11994: @cindex disk usage
11995: 
11996: @c No disk can hold an infinite amount of data.  These commands report on
11997: @c how much disk storage is in use or available.  (This has nothing much to
11998: @c do with how much @emph{main memory}, i.e., RAM, a program is using when
11999: @c it runs; for that, you want @command{ps} or @command{pstat} or @command{swap}
12000: @c or some such command.)
12001: @c 
12002: 無限の量のデータを保てるディスクはありません.これらのコマンドは,ディ
12003: スクストレージの使用や利用可能な量を報告します.(これは@emph{メインメ
12004: モリ},すなわち,プログラムが実行時に使用するRAMの量に対しては重要なこ
12005: とはしません.そのため,@code{ps}や@code{pstat}や@code{swap}やそのよう
12006: なコマンドが必要です.)
12007: 
12008: @menu
12009: * df invocation::               Report filesystem disk space usage.
12010: * du invocation::               Estimate file space usage.
12011: * stat invocation::		Report file or filesystem status.
12012: * sync invocation::             Synchronize memory and disk.
12013: @end menu
12014: 
12015: 
12016: @node df invocation
12017: @c @section @command{df}: Report filesystem disk space usage
12018: @section @command{df}: ファイルシステムのディスクスペースの使用の報告
12019: 
12020: @pindex df
12021: @cindex filesystem disk usage
12022: @cindex disk usage by filesystem
12023: 
12024: @c @command{df} reports the amount of disk space used and available on
12025: @c filesystems.  Synopsis:
12026: @c 
12027: @command{df}は,ファイルシステムの使用されているディスクスペースと利用
12028: 可能なディスクスペースの量を報告します.概要です.
12029: 
12030: @example
12031: df [@var{option}]@dots{} [@var{file}]@dots{}
12032: @end example
12033: 
12034: @c With no arguments, @command{df} reports the space used and available on all
12035: @c currently mounted filesystems (of all types).  Otherwise, @command{df}
12036: @c reports on the filesystem containing each argument @var{file}.
12037: @c 
12038: 引数を用いない場合,@command{df}は現在マウントされている(すべての形式
12039: の)すべてのファイルシステムの使用されている,そして利用可能な空間を報
12040: 告します.それ以外では,@command{df}はそれぞれの引数の@var{file}を含む
12041: ファイルシステム上の内容を報告します.
12042: 
12043: @c Normally the disk space is printed in units of
12044: @c 1024 bytes, but this can be overridden (@pxref{Block size}).
12045: @c Non-integer quantities are rounded up to the next higher unit.
12046: @c 
12047: 通常ディスクスペースは1024バイト単位で出力されますが,これに優先するこ
12048: とも可能です(@pxref{Block size}).整数ではない量は,次の単位まで切り上
12049: げられます.
12050: 
12051: @cindex disk device file
12052: @cindex device file, disk
12053: @c If an argument @var{file} is a disk device file containing a mounted
12054: @c filesystem, @command{df} shows the space available on that filesystem
12055: @c rather than on the filesystem containing the device node (i.e., the root
12056: @c filesystem).  @sc{gnu} @command{df} does not attempt to determine the disk usage
12057: @c on unmounted filesystems, because on most kinds of systems doing so
12058: @c requires extremely nonportable intimate knowledge of filesystem
12059: @c structures.
12060: @c 
12061: 引数の@var{file}がマウントされているファイルシステムを含むディスクデバ
12062: イスファイルの場合,@command{df}はデバイスノードを含むファイルシステム
12063: (すなわちルートファイルシステム)ではなく,そのファイルシステムの利用可
12064: 能な空間を表示します.@sc{gnu} @command{df}では,マウントしていないファ
12065: イルシステムのディスクの使用を決定することは,ファイルシステム構造のほ
12066: とんどのシステム間での極めて移植性のない緻密な知識が必要になるので,そ
12067: うしようとしません.
12068: 
12069: @c The program accepts the following options.  Also see @ref{Common options}.
12070: @c 
12071: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
12072: してください.
12073: 
12074: @table @samp
12075: 
12076: @item -a
12077: @itemx --all
12078: @opindex -a
12079: @opindex --all
12080: @cindex automounter filesystems
12081: @cindex ignore filesystems
12082: @c Include in the listing filesystems that have a size of 0 blocks, which
12083: @c are omitted by default.  Such filesystems are typically special-purpose
12084: @c pseudo-filesystems, such as automounter entries.  Also, filesystems of
12085: @c type ``ignore'' or ``auto'', supported by some operating systems, are
12086: @c only included if this option is specified.
12087: @c 
12088: 0ブロックの大きさのファイルシステムをリストに含め,それはデフォルトで
12089: は省略されます.そのようなファイルシステムは,通常はオートマウントエン
12090: トリーのような,特定の目的の疑似ファイルシステムです.また,サポートさ
12091: れているシステムもある``ignore''や``auto''形式のファイルシステムは,こ
12092: のオプションが指定されたときだけ含まれます.
12093: 
12094: @item -B @var{size}
12095: @itemx --block-size=@var{size}
12096: @opindex -B
12097: @opindex --block-size
12098: @cindex filesystem sizes
12099: @c Scale sizes by @var{size} before printing them (@pxref{Block size}).
12100: @c For example, @option{-BG} prints sizes in units of 1,073,741,824 bytes.
12101: @c 
12102: 表示する前に,@var{size}で大きさを計ります(@pxref{Block size}).例えば,
12103: @option{-BG}では,1,073,741,824バイト単位で大きさを表示します.
12104: 
12105: @item -h
12106: @itemx --human-readable
12107: @opindex -h
12108: @opindex --human-readable
12109: @cindex human-readable output
12110: @c Append a size letter to each size, such as @samp{M} for mebibytes.
12111: @c Powers of 1024 are used, not 1000; @samp{M} stands for 1,048,576 bytes.
12112: @c Use the @option{-H} or @option{--si} option if you prefer powers of 1000.
12113: @c 
12114: それぞれのサイズに,メガバイトに対する@samp{M}のようなサイズ文字を追加
12115: します.1024倍が使用され,1000ではありません.@samp{M}は1,048,576バイ
12116: トを意味します.1000倍を好む場合は@option{-H}や@option{--si}オプション
12117: を使用してください.
12118: 
12119: @item -H
12120: @itemx --si
12121: @opindex -H
12122: @opindex --si
12123: @cindex SI output
12124: @c Append an SI-style abbreviation to each size, such as @samp{MB} for
12125: @c megabytes.  Powers of 1000 are used, not 1024; @samp{MB} stands for
12126: @c 1,000,000 bytes.  Use the @option{-h} or @option{--human-readable} option if
12127: @c you prefer powers of 1024.
12128: @c 
12129: それぞれのサイズに,メガバイトに対する@samp{MB}のようなSI形式の略語を
12130: 追加します.1000倍が使用され,1024ではありません.@samp{MB}は1,000,000 
12131: バイトを意味します.1024倍を好む場合は@option{-h}や
12132: @option{--human-readable}オプションを使用してください.
12133: 
12134: @item -i
12135: @itemx --inodes
12136: @opindex -i
12137: @opindex --inodes
12138: @cindex inode usage
12139: @c List inode usage information instead of block usage.  An inode (short
12140: @c for index node) contains information about a file such as its owner,
12141: @c permissions, timestamps, and location on the disk.
12142: @c 
12143: ブロックの使用の代わりに,inode使用の情報をリストアップします.
12144: inode(index nodeの省略)は,ファイルに関する,所有者,許可,タイムスタ
12145: ンプ,そしてディスクの位置のような情報を含みます.
12146: 
12147: @item -k
12148: @opindex -k
12149: @cindex kibibytes for filesystem sizes
12150: @c Print sizes in 1024-byte blocks, overriding the default block size
12151: @c (@pxref{Block size}).
12152: @c This option is equivalent to @option{--block-size=1K}.
12153: @c 
12154: 1024バイトブロックで出力し,デフォルトのブロックサイズに優先します
12155: (@pxref{Block size}).このオプションは,@option{--block-size=1K}と等価
12156: です.
12157: 
12158: @item -l
12159: @itemx --local
12160: @opindex -l
12161: @opindex --local
12162: @cindex filesystem types, limiting output to certain
12163: @c Limit the listing to local filesystems.  By default, remote filesystems
12164: @c are also listed.
12165: @c 
12166: ローカルファイルシステムのリストだけに制限します.デフォルトではリモー
12167: トファイルシステムもリストアップされます.
12168: 
12169: @item --no-sync
12170: @opindex --no-sync
12171: @cindex filesystem space, retrieving old data more quickly
12172: @c Do not invoke the @code{sync} system call before getting any usage data.
12173: @c This may make @command{df} run significantly faster on systems with many
12174: @c disks, but on some systems (notably SunOS) the results may be slightly
12175: @c out of date.  This is the default.
12176: @c 
12177: 使用データを取得する前に@code{sync}システムコールを呼び出しません.こ
12178: れは多くのディスクを持つシステム上で@command{df}の実行をかなり速くする
12179: かもしれませんが,システム(特にSunOS)によっては,結果が若干古いものに
12180: なるかもしれません.これはデフォルトです.
12181: 
12182: @item -P
12183: @itemx --portability
12184: @opindex -P
12185: @opindex --portability
12186: @cindex one-line output format
12187: @cindex @acronym{POSIX} output format
12188: @cindex portable output format
12189: @cindex output format, portable
12190: @c Use the @acronym{POSIX} output format.  This is like the default format except
12191: @c for the following:
12192: @c 
12193: @acronym{POSIX}出力形式を使用します.これは,以下を除いてデフォルトの
12194: 書式に似ています.
12195: 
12196: @enumerate
12197: @item
12198: @c The information about each filesystem is always printed on exactly
12199: @c one line; a mount device is never put on a line by itself.  This means
12200: @c that if the mount device name is more than 20 characters long (e.g., for
12201: @c some network mounts), the columns are misaligned.
12202: @c 
12203: それぞれのファイルシステムの情報は常に正確に一行で出力されます.マウン
12204: トデバイスはその行に書かれません.これはマウントデバイスの名前が20文字
12205: 以上(例えば,いくつかのネットワークマウント)の場合,列がきちんと並ばな
12206: いことを意味します.
12207: 
12208: @item
12209: @c The labels in the header output line are changed to conform to @acronym{POSIX}.
12210: @c 
12211: ヘッダ出力行のラベルは,@acronym{POSIX}に従い変更されます.
12212: @end enumerate
12213: 
12214: @item --sync
12215: @opindex --sync
12216: @cindex filesystem space, retrieving current data more slowly
12217: @c Invoke the @code{sync} system call before getting any usage data.  On
12218: @c some systems (notably SunOS), doing this yields more up to date results,
12219: @c but in general this option makes @command{df} much slower, especially when
12220: @c there are many or very busy filesystems.
12221: @c 
12222: あらゆる使用データの取得前に@code{sync}システムコールを呼び出します.
12223: システム(特にSunOS)によってはこうすることで結果がより新しいものになり
12224: ますが,一般的に言って,特に多くの,または非常に忙しいファイルシステム
12225: があるとき,このオプションで@command{df}はかなり遅くなります.
12226: 
12227: @item -t @var{fstype}
12228: @itemx --type=@var{fstype}
12229: @opindex -t
12230: @opindex --type
12231: @cindex filesystem types, limiting output to certain
12232: @c Limit the listing to filesystems of type @var{fstype}.  Multiple
12233: @c filesystem types can be specified by giving multiple @option{-t} options.
12234: @c By default, nothing is omitted.
12235: @c 
12236: @var{fstype}形式のファイルシステムのリストにだけ制限します.複数のファ
12237: イルシステム形式は,複数の@option{-t}オプションを与えることで指定する
12238: ことが可能です.デフォルトでは何も省略されません.
12239: 
12240: @item -T
12241: @itemx --print-type
12242: @opindex -T
12243: @opindex --print-type
12244: @cindex filesystem types, printing
12245: @c Print each filesystem's type.  The types printed here are the same ones
12246: @c you can include or exclude with @option{-t} and @option{-x}.  The particular
12247: @c types printed are whatever is supported by the system.  Here are some of
12248: @c the common names (this list is certainly not exhaustive):
12249: @c 
12250: それぞれのファイルシステムの形式を出力します.ここで出力される形式は,
12251: @option{-t}と@option{-x}オプションで含めたり除外したりすることが可能な
12252: ものと同じです.出力される特定の形式は,システムでサポートしているもの
12253: すべてです.ここに共通の名前がいくつかあります(このリストはもちろん網
12254: 羅的なものではありません).
12255: 
12256: @table @samp
12257: 
12258: @item nfs
12259: @cindex NFS filesystem type
12260: @c An NFS filesystem, i.e., one mounted over a network from another
12261: @c machine.  This is the one type name which seems to be used uniformly by
12262: @c all systems.
12263: @c 
12264: NFSファイルシステム,すなわち,他のマシンからネットワークでマウントさ
12265: れたものです.これは,すべてのシステムで同じように使用されると思われる,
12266: 一つの形式の名前です.
12267: 
12268: @item 4.2@r{, }ufs@r{, }efs@dots{}
12269: @cindex Linux filesystem types
12270: @cindex local filesystem types
12271: @opindex 4.2 @r{filesystem type}
12272: @opindex ufs @r{filesystem type}
12273: @opindex efs @r{filesystem type}
12274: @c A filesystem on a locally-mounted hard disk.  (The system might even
12275: @c support more than one type here; Linux does.)
12276: @c 
12277: ローカルにマウントされたハードディスクのファイルシステムです.(システ
12278: ムはこれらの一つ以上のものをサポートするかもしれません.Linuxはそうで
12279: す.)
12280: 
12281: @item hsfs@r{, }cdfs
12282: @cindex CD-ROM filesystem type
12283: @cindex High Sierra filesystem
12284: @opindex hsfs @r{filesystem type}
12285: @opindex cdfs @r{filesystem type}
12286: @c A filesystem on a CD-ROM drive.  HP-UX uses @samp{cdfs}, most other
12287: @c systems use @samp{hsfs} (@samp{hs} for ``High Sierra'').
12288: @c 
12289: CD-ROMドライブのファイルシステムです.HP-UXは@samp{cdfs}を使用し,その
12290: 他のほとんどのシステムは@samp{hsfs} (@samp{hs}は``High Sierra''です)を
12291: 使用します.
12292: 
12293: @item pcfs
12294: @cindex PC filesystem
12295: @cindex DOS filesystem
12296: @cindex MS-DOS filesystem
12297: @cindex diskette filesystem
12298: @opindex pcfs
12299: @c An MS-DOS filesystem, usually on a diskette.
12300: @c 
12301: MS-DOSのファイルシステムで,通常ディスケット上です.
12302: 
12303: @end table
12304: 
12305: @item -x @var{fstype}
12306: @itemx --exclude-type=@var{fstype}
12307: @opindex -x
12308: @opindex --exclude-type
12309: @c Limit the listing to filesystems not of type @var{fstype}.
12310: @c Multiple filesystem types can be eliminated by giving multiple
12311: @c @option{-x} options.  By default, no filesystem types are omitted.
12312: @c 
12313: @var{fstype}形式でないファイルシステムにリストを制限します.複数のファ
12314: イルシステムの形式は,複数の@option{-x}オプションを使用することで排除
12315: することが可能です.デフォルトでは省略されるファイルシステム形式はあり
12316: ません.
12317: 
12318: @item -v
12319: @c Ignored; for compatibility with System V versions of @command{df}.
12320: @c 
12321: 無視されます.System V版の@command{df}への互換性のためです.
12322: 
12323: @end table
12324: 
12325: 
12326: @node du invocation
12327: @c @section @command{du}: Estimate file space usage
12328: @section @command{du}: ファイルスペースの使用を推定
12329: 
12330: @pindex du
12331: @cindex file space usage
12332: @cindex disk usage for files
12333: 
12334: @c @command{du} reports the amount of disk space used by the specified files
12335: @c and for each subdirectory (of directory arguments).  Synopsis:
12336: @c 
12337: @command{du}は,指定されているファイルとそれぞれの(ディレクトリ引数の)
12338: サブディレクトリが使用しているディスクスペースの量を報告します.概要で
12339: す.
12340: 
12341: @example
12342: du [@var{option}]@dots{} [@var{file}]@dots{}
12343: @end example
12344: 
12345: @c With no arguments, @command{du} reports the disk space for the current
12346: @c directory.  Normally the disk space is printed in units of
12347: @c 1024 bytes, but this can be overridden (@pxref{Block size}).
12348: @c Non-integer quantities are rounded up to the next higher unit.
12349: @c 
12350: 引数を用いない場合,@command{du}は現在のディレクトリのディスクスペース
12351: を報告します.通常,ディスクスペースは1024バイト単位で出力されますが,
12352: これに優先することも可能です(@pxref{Block size}).整数ではない量は,次
12353: に大きな単位に切り上げられます.
12354: 
12355: @c The program accepts the following options.  Also see @ref{Common options}.
12356: @c 
12357: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
12358: してください.
12359: 
12360: @table @samp
12361: 
12362: @item -a
12363: @itemx --all
12364: @opindex -a
12365: @opindex --all
12366: @c Show counts for all files, not just directories.
12367: @c 
12368: ディレクトリだけでなく,すべてのファイルを数えたものを表示します.
12369: 
12370: @itemx --apparent-size
12371: @opindex --apparent-size
12372: @c Print apparent sizes, rather than disk usage.  The apparent size of a
12373: @c file is the number of bytes reported by @code{wc -c} on regular files,
12374: @c or more generally, @code{ls -l --block-size=1} or @code{stat --format=%s}.
12375: @c For example, a file containing the word @samp{zoo} with no newline would,
12376: @c of course, have an apparent size of 3.  Such a small file may require
12377: @c anywhere from zero to 16 or more kilobytes of disk space, depending on
12378: @c the type and configuration of the file system on which the file resides.
12379: @c However, a sparse file created with this command
12380: @c 
12381: ディスクを使用している大きさではなく見かけ上の大きさを出力します.ファ
12382: イルの見かけ上の大きさは,通常のファイルに対し@code{wc -c},またはより
12383: 一般的に,@code{ls -l --block-size=1}や@code{stat --format=%s}で報告さ
12384: れるバイト数です.例えば,改行が無い単語@samp{zoo}を含んでいるファイル
12385: はもちろん,見かけ上の大きさは3になります.そのような小さなファイルで
12386: も,ファイルが存在するファイルシステムの形式や設定によっては,ゼロから
12387: 16バイト,またはより大きなキロバイトのディスク領域が必要かもしれません.
12388: しかし,以下のコマンドで作成される疎らなファイルを考えてみます.
12389: @example
12390: : | dd bs=1 seek=`echo '2^31'|bc` of=big
12391: @end example
12392: @c has an apparent size of 2 gigabytes, yet on most modern
12393: @c systems, it actually uses almost no disk space.
12394: @c 
12395: これは,見かけ上2ギガバイトですが,最近のほとんどのシステムでは,実際
12396: にはほとんどディスク領域を使用しません.
12397: 
12398: @item -b
12399: @itemx --bytes
12400: @opindex -b
12401: @opindex --bytes
12402: @c Equivalent to @code{--apparent-size --block-size=1}.
12403: @c 
12404: @code{--apparent-size --block-size=1}と同じです.
12405: 
12406: @item -B @var{size}
12407: @itemx --block-size=@var{size}
12408: @opindex -B
12409: @opindex --block-size
12410: @cindex file sizes
12411: @c Scale sizes by @var{size} before printing them (@pxref{Block size}).
12412: @c For example, @option{-BG} prints sizes in units of 1,073,741,824 bytes.
12413: @c 
12414: 大きさを出力する前に@var{size}で計測します(@pxref{Block size}).例えば,
12415: @option{-BG}では1,073,741,824バイト単位で出力します.
12416: 
12417: @item -c
12418: @itemx --total
12419: @opindex -c
12420: @opindex --total
12421: @cindex grand total of disk space
12422: @c Print a grand total of all arguments after all arguments have
12423: @c been processed.  This can be used to find out the total disk usage of
12424: @c a given set of files or directories.
12425: @c 
12426: すべての引数を処理した後,すべての引数の合計を出力します.これは,与え
12427: られたファイルやディレクトリの集合の,ディスク使用の合計を知るために使
12428: 用することが可能です.
12429: 
12430: @item -D
12431: @itemx --dereference-args
12432: @opindex -D
12433: @opindex --dereference-args
12434: @c Dereference symbolic links that are command line arguments.
12435: @c Does not affect other symbolic links.  This is helpful for finding
12436: @c out the disk usage of directories, such as @file{/usr/tmp}, which
12437: @c are often symbolic links.
12438: @c 
12439: コマンドライン引数のシンボリックリンクを間接参照します.その他のシンボ
12440: リックリンクには影響しません.これは,@file{/usr/tmp}のように,シンボ
12441: リックリンクにされることが多いディレクトリのディスクの使用状況を知りた
12442: いとき役に立ちます.
12443: 
12444: @item -h
12445: @itemx --human-readable
12446: @opindex -h
12447: @opindex --human-readable
12448: @cindex human-readable output
12449: @c Append a size letter to each size, such as @samp{M} for mebibytes.
12450: @c Powers of 1024 are used, not 1000; @samp{M} stands for 1,048,576 bytes.
12451: @c Use the @option{-H} or @option{--si} option if you prefer powers of 1000.
12452: @c 
12453: それぞれのサイズに,メガバイトに対する@samp{M}のようなサイズ文字を追加
12454: します.1000倍ではなく1024倍が使用されます.@samp{M}は1,048,576バイト
12455: を意味します.1000倍を好む場合,@option{-H}や@option{--si}オプションを
12456: 使用してください.
12457: 
12458: @item -H
12459: @itemx --si
12460: @opindex -H
12461: @opindex --si
12462: @cindex SI output
12463: @c Append an SI-style abbreviation to each size, such as @samp{MB} for
12464: @c megabytes.  Powers of 1000 are used, not 1024; @samp{MB} stands for
12465: @c 1,000,000 bytes.  Use the @option{-h} or @option{--human-readable} option if
12466: @c you prefer powers of 1024.
12467: @c 
12468: それぞれのサイズに,メガバイトに対する@samp{MB}のようなサイズ文字を追
12469: 加します.(SIは国際単位系で,それはこれらの文字をの接頭辞として定義し
12470: ています.)1024倍ではなく1000倍が使用されます.@samp{MB}は1,000,000バ
12471: イトを意味します.1024倍を好む場合,@option{-h}や
12472: @option{--human-readable} オプションを使用してください.
12473: 
12474: @item -k
12475: @opindex -k
12476: @cindex kibibytes for file sizes
12477: @c Print sizes in 1024-byte blocks, overriding the default block size
12478: @c (@pxref{Block size}).
12479: @c This option is equivalent to @option{--block-size=1K}.
12480: @c 
12481: 1024バイトブロックで出力し,デフォルトのブロックサイズに優先します
12482: (@pxref{Block size}).このオプションは,@option{--block-size=1K}と等価
12483: です.
12484: 
12485: @item -l
12486: @itemx --count-links
12487: @opindex -l
12488: @opindex --count-links
12489: @cindex hard links, counting in @command{du}
12490: @c Count the size of all files, even if they have appeared already (as a
12491: @c hard link).
12492: @c 
12493: すでに(ハードリンクとして)現れている場合でも,すべてのファイルのサイズ
12494: を計算します.
12495: 
12496: @item -L
12497: @itemx --dereference
12498: @opindex -L
12499: @opindex --dereference
12500: @cindex symbolic links, dereferencing in @command{du}
12501: @c Dereference symbolic links (show the disk space used by the file
12502: @c or directory that the link points to instead of the space used by
12503: @c the link).
12504: @c 
12505: シンボリックリンクを間接参照します(リンクで使用しているスペースの代わ
12506: りに,リンクが示すファイルやディレクトリが使用しているディスクスペース
12507: を表示します).
12508: 
12509: @item --max-depth=@var{DEPTH}
12510: @opindex --max-depth=@var{DEPTH}
12511: @cindex limiting output of @command{du}
12512: @c Show the total for each directory (and file if --all) that is at
12513: @c most MAX_DEPTH levels down from the root of the hierarchy.  The root
12514: @c is at level 0, so @code{du --max-depth=0} is equivalent to @code{du -s}.
12515: @c 
12516: 階層のルートから最大MAX_DEPTHレベルまで降りて,それぞれのディレクトリ
12517: (そして@samp{--all}の場合はファイル)の合計を表示します.ルートはレベル
12518: 0なので,@code{du --max-depth=0}は@code{du -s}と同じです.
12519: 
12520: @item -s
12521: @itemx --summarize
12522: @opindex -s
12523: @opindex --summarize
12524: @c Display only a total for each argument.
12525: @c 
12526: それぞれの引数の合計のみ表示します.
12527: 
12528: @item -S
12529: @itemx --separate-dirs
12530: @opindex -S
12531: @opindex --separate-dirs
12532: @c Report the size of each directory separately, not including the sizes
12533: @c of subdirectories.
12534: @c 
12535: サブディレクトリのサイズを含めず,それぞれのディレクトリのサイズを別々
12536: に報告します.
12537: 
12538: @item -x
12539: @itemx --one-file-system
12540: @opindex -x
12541: @opindex --one-file-system
12542: @cindex one filesystem, restricting @command{du} to
12543: @c Skip directories that are on different filesystems from the one that
12544: @c the argument being processed is on.
12545: @c 
12546: 処理を開始した引数のディレクトリと異なるファイルシステムを省略します.
12547: 
12548: @item --exclude=@var{PATTERN}
12549: @opindex --exclude=@var{PATTERN}
12550: @cindex excluding files from @command{du}
12551: @c When recursing, skip subdirectories or files matching @var{PATTERN}.
12552: @c For example, @code{du --exclude='*.o'} excludes files whose names
12553: @c end in @samp{.o}.
12554: @c 
12555: 再帰的なとき,@var{PATTERN}にマッチするサブディレクトリやファイルを省
12556: 略します.例えば,@code{du --exclude='*.o'}は@samp{.o}で終わる名前のファ
12557: イルを除外します.
12558: 
12559: @item -X @var{FILE}
12560: @itemx --exclude-from=@var{FILE}
12561: @opindex -X @var{FILE}
12562: @opindex --exclude-from=@var{FILE}
12563: @cindex excluding files from @command{du}
12564: @c Like @option{--exclude}, except take the patterns to exclude from @var{FILE},
12565: @c one per line.  If @var{FILE} is @samp{-}, take the patterns from standard
12566: @c input.
12567: @c 
12568: 除外するパターンを@var{FILE}から受け取る以外,@option{--exclude}に似て
12569: います.@var{FILE}が@samp{-}の場合,標準入力からパターンを受け取ります.
12570: 
12571: @end table
12572: 
12573: @cindex NFS mounts from BSD to HP-UX
12574: @c On BSD systems, @command{du} reports sizes that are half the correct
12575: @c values for files that are NFS-mounted from HP-UX systems.  On HP-UX
12576: @c systems, it reports sizes that are twice the correct values for
12577: @c files that are NFS-mounted from BSD systems.  This is due to a flaw
12578: @c in HP-UX; it also affects the HP-UX @command{du} program.
12579: @c 
12580: BSDシステムでは,HP-UXシステムからのNFSマウントされているファイルの正
12581: しい値の半分のサイズを,@command{du}は報告します.HP-UXシステムでは,
12582: BSDシステムからのNFSマウントされているファイルの正しい値の二倍のサイズ
12583: を報告します.これはHP-UXの欠陥です.それはHP-UX @command{du}プログラ
12584: ムにも影響します.
12585: 
12586: 
12587: @node stat invocation
12588: @c @section @command{stat}: Report file or filesystem status
12589: @section @command{stat}: ファイルやファイルシステムのステータスを報告
12590: 
12591: @pindex stat
12592: @cindex file status
12593: @cindex filesystem status
12594: 
12595: @c @command{stat} displays information about the specified file(s).  Synopsis:
12596: @c 
12597: @command{stat}は,指定したファイルの情報を表示します.概要です.
12598: 
12599: @example
12600: stat [@var{option}]@dots{} [@var{file}]@dots{}
12601: @end example
12602: 
12603: @c With no option, @command{stat} reports all information about the given files.
12604: @c But it also can be used to report the information of the filesystems the
12605: @c given files are located on. If the files are links, @command{stat} can
12606: @c also give information about the files the links point to.
12607: @c 
12608: オプションを用いていない場合,@command{stat}は与えられたファイルのすべ
12609: ての情報を報告します.しかし,与えられたファイルが存在するファイルシス
12610: テムの情報だけを報告するために使用することも可能です.ファイルがリンク
12611: の場合,@command{stat}はリンク先のファイルの情報も与えてくれます.
12612: 
12613: @table @samp
12614: 
12615: @item -f
12616: @itemx --filesystem
12617: @opindex -f
12618: @opindex --filesystem
12619: @cindex filesystems
12620: @c Report information about the filesystems where the given files are located
12621: @c instead of information about the files themselves.
12622: @c 
12623: 与えられたファイル自身の情報ではなく,ファイルが存在しているファイルシ
12624: ステムの情報を報告します.
12625: 
12626: @item -L
12627: @itemx --dereference
12628: @opindex -L
12629: @opindex --dereference
12630: @cindex symbolic links, dereferencing in @command{stat}
12631: @c Change how @command{stat} treats symbolic links.
12632: @c With this option, @command{stat} acts on the file referenced
12633: @c by each symbolic link argument.
12634: @c Without it, @command{stat} acts on any symbolic link argument directly.
12635: @c 
12636: @command{stat}のシンボリックリンクの処理方法を変更します.このオプショ
12637: ンを用いると,@command{stat}はそれぞれのシンボリックリンク引数の参照先
12638: のファイルで動作します.そうでなければ,@command{stat}はシンボリックリ
12639: ンクで直接動作します.
12640: 
12641: @item -t
12642: @itemx --terse
12643: @opindex -t
12644: @opindex --terse
12645: @cindex terse output
12646: @c Print the information in terse form, suitable for parsing by other programs.
12647: @c 
12648: 他のプログラムでパースするのに適した,簡潔な方式で情報を出力します.
12649: 
12650: @item -c
12651: @itemx --format
12652: @opindex -c
12653: @opindex --format
12654: @cindex output format
12655: @c Allow user to specify the output format.
12656: @c 
12657: ユーザ指定の出力書式を可能にします.
12658: 
12659: @c Interpreted sequences for file stat are:
12660: @c 
12661: ファイルのステータスとして解釈されるものです.
12662: @itemize @bullet
12663: @c @item %a - Access rights in octal
12664: @c @item %A - Access rights in human readable form
12665: @c @item %b - Number of blocks allocated (see @samp{%B})
12666: @c @item %B - The size in bytes of each block reported by @samp{%b}
12667: @c @item %d - Device number in decimal
12668: @c @item %D - Device number in hex
12669: @c @item %f - raw mode in hex
12670: @c @item %F - File type
12671: @c @item %g - Group Id of owner
12672: @c @item %G - Group name of owner
12673: @c @item %h - Number of hard links
12674: @c @item %i - Inode number
12675: @c @item %n - File name
12676: @c @item %N - Quoted File name with dereference if symbolic link
12677: @c @item %o - IO block size
12678: @c @item %s - Total size, in bytes
12679: @c @item %t - Major device type in hex
12680: @c @item %T - Minor device type in hex
12681: @c @item %u - User Id of owner
12682: @c @item %U - User name of owner
12683: @c @item %x - Time of last access
12684: @c @item %X - Time of last access as seconds since Epoch
12685: @c @item %y - Time of last modification
12686: @c @item %Y - Time of last modification as seconds since Epoch
12687: @c @item %z - Time of last change
12688: @c @item %Z - Time of last change as seconds since Epoch
12689: @c 
12690: @item %a - アクセス許可の八進数
12691: @item %A - アクセス許可の人間が読める形式
12692: @item %b - 領域のブロック数 (see @samp{%B})
12693: @item %B - @samp{%b}で報告されるそれぞれのブロックのバイト数
12694: @item %d - 十進数のデバイス番号
12695: @item %D - 16進数のデバイス番号
12696: @item %f - 16進数のraw mode
12697: @item %F - ファイル形式
12698: @item %g - 所有者のグループId
12699: @item %G - 所有者のグループ名
12700: @item %h - ハードリンク数
12701: @item %i - inode番号
12702: @item %n - ファイル名
12703: @item %N - シンボリックリンクの場合,間接参照した引用符で囲まれたファイル名
12704: @item %o - IOブロックサイズ
12705: @item %s - バイト単位の全体の大きさ
12706: @item %t - 16進数のメジャーデバイス形式
12707: @item %T - 16進数のマイナーデバイス形式
12708: @item %u - 所有者のユーザId
12709: @item %U - 所有者のユーザ名
12710: @item %x - 最後にアクセスした時間
12711: @item %X - 最後にアクセスしたEpoch以来の秒数
12712: @item %y - 最後に編集した時間
12713: @item %Y - 最後に編集したEpoch以来の秒数
12714: @item %z - 最後に変更した時間
12715: @item %Z - 最後に変更したEpoch以来の秒数
12716: @end itemize
12717: 
12718: @c Interpreted sequences for filesystem stat are:
12719: @c 
12720: ファイルシステムのステータスとして解釈されるものです.
12721: @itemize @bullet
12722: @c @item %n - File name
12723: @c @item %i - File System id in hex
12724: @c @item %l - Maximum length of filenames
12725: @c @item %t - Type in hex
12726: @c @item %T - Type in human readable form
12727: @c @item %b - Total data blocks in file system
12728: @c @item %f - Free blocks in file system
12729: @c @item %a - Free blocks available to non-superuser
12730: @c @item %s - Optimal transfer block size
12731: @c @item %c - Total file nodes in file system
12732: @c 
12733: @item %n - ファイル名
12734: @item %i - 16進数のファイルシステムid
12735: @item %l - ファイル名の最大長さ
12736: @item %t - 16進数の形式
12737: @item %T - 人間が読める形式
12738: @item %b - ファイルシステム全体のデータブロック
12739: @item %f - ファイルシステムの空きブロック
12740: @item %a - スーパーユーザ以外が利用可能な空きブロック
12741: @item %s - 最適に移動されるブロックサイズ
12742: @item %c - ファイルシステム全体のファイルノード
12743: @end itemize
12744: @end table
12745: 
12746: 
12747: @node sync invocation
12748: @c @section @command{sync}: Synchronize data on disk with memory
12749: @section @command{sync}: ディスクのデータとメモリの同期
12750: 
12751: @pindex sync
12752: @cindex synchronize disk and memory
12753: 
12754: @cindex superblock, writing
12755: @cindex inodes, written buffered
12756: @c @command{sync} writes any data buffered in memory out to disk.  This can
12757: @c include (but is not limited to) modified superblocks, modified inodes,
12758: @c and delayed reads and writes.  This must be implemented by the kernel;
12759: @c The @command{sync} program does nothing but exercise the @code{sync} system
12760: @c call.
12761: @c 
12762: @command{sync}は,メモリに蓄えられているデータをすべてディスクに書き出
12763: します.これは,(制限はあるものの)編集されたスーパーブロック,編集され
12764: たinode,そして遅延された読み書きが含まれます.これはカーネルで実装さ
12765: れている必要があります.@command{sync}プログラムは,@code{sync}システ
12766: ムコールの呼び出し以外,何もしません.
12767: 
12768: @cindex crashes and corruption
12769: @c The kernel keeps data in memory to avoid doing (relatively slow) disk
12770: @c reads and writes.  This improves performance, but if the computer
12771: @c crashes, data may be lost or the filesystem corrupted as a
12772: @c result. @command{sync} ensures everything in memory is written to disk.
12773: @c 
12774: カーネルは,(相対的に遅い)ディクスの読み書きを避けるため,メモリのデー
12775: タをそのままにします.これはパフォーマンスを改善しますが,コンピュータ
12776: が壊れた場合,結果としてデータが失われたり,ファイルシステムが壊れるか
12777: もしれません.@command{sync}は,メモリにあるものすべてを確実にディスク
12778: に書き込みます.
12779: 
12780: @c Any arguments are ignored, except for a lone @option{--help} or
12781: @c @option{--version} (@pxref{Common options}).
12782: @c 
12783: 単独の@option{--help}や@option{--version} (@pxref{Common options})以外
12784: のあらゆるオプションは無視されます.
12785: 
12786: @node Printing text
12787: @c @chapter Printing text
12788: @chapter テキストの表示
12789: 
12790: @cindex printing text, commands for
12791: @cindex commands for printing text
12792: 
12793: @c This section describes commands that display text strings.
12794: @c 
12795: このセクションは,テキスト文字列を画面に表示するコマンドを説明します.
12796: 
12797: @menu
12798: * echo invocation::             Print a line of text.
12799: * printf invocation::           Format and print data.
12800: * yes invocation::              Print a string until interrupted.
12801: @end menu
12802: 
12803: 
12804: @node echo invocation
12805: @c @section @command{echo}: Print a line of text
12806: @section @command{echo}: テキストの行を表示
12807: 
12808: @pindex echo
12809: @cindex displaying text
12810: @cindex printing text
12811: @cindex text, displaying
12812: @cindex arbitrary text, displaying
12813: 
12814: @c @command{echo} writes each given @var{string} to standard output, with a
12815: @c space between each and a newline after the last one.  Synopsis:
12816: @c 
12817: @command{echo}は,与えられたそれぞれの@var{string}を,それぞれの間にス
12818: ペースを用い,最後のものの後に改行を用いて,標準出力に書き出します.概
12819: 要です.
12820: 
12821: @example
12822: echo [@var{option}]@dots{} [@var{string}]@dots{}
12823: @end example
12824: 
12825: @c The program accepts the following options.  Also see @ref{Common options}.
12826: @c 
12827: プログラムは以下のオプションも受け入れます.@ref{Common options}も参照
12828: してください.
12829: 
12830: @table @samp
12831: @item -n
12832: @opindex -n
12833: @c Do not output the trailing newline.
12834: @c 
12835: 終りの改行を出力しません.
12836: 
12837: @item -e
12838: @opindex -e
12839: @cindex backslash escapes
12840: @c Enable interpretation of the following backslash-escaped characters in
12841: @c each @var{string}:
12842: @c 
12843: それぞれの@var{string}で,以下のバックスペースエスケープされた文字の解
12844: 釈を可能にします.
12845: 
12846: @table @samp
12847: @item \a
12848: @c alert (bell)
12849: @c 
12850: 警報(ベル)
12851: @item \b
12852: @c backspace
12853: @c 
12854: バックスペース
12855: @item \c
12856: @c suppress trailing newline
12857: @c 
12858: 終りの改行を抑制
12859: @item \f
12860: @c form feed
12861: @c 
12862: フォームフィード
12863: @item \n
12864: @c new line
12865: @c 
12866: 改行
12867: @item \r
12868: @c carriage return
12869: @c 
12870: キャリッジリターン
12871: @item \t
12872: @c horizontal tab
12873: @c 
12874: 水平タブ
12875: @item \v
12876: @c vertical tab
12877: @c 
12878: 垂直タブ
12879: @item \\
12880: @c backslash
12881: @c 
12882: バックスラッシュ
12883: @item \@var{nnn}
12884: @c the character whose @acronym{ASCII} code is @var{nnn} (octal); if @var{nnn} is not
12885: @c a valid octal number, it is printed literally.
12886: @c 
12887: ASCIIコードが@var{nnn}(八進数)の文字.@var{nnn}が有効な数字でない場合,
12888: それは文字通りに出力されます.
12889: @end table
12890: 
12891: @end table
12892: 
12893: 
12894: @node printf invocation
12895: @c @section @command{printf}: Format and print data
12896: @section @command{printf}: データの書式化と出力
12897: 
12898: @pindex printf
12899: @c @command{printf} does formatted printing of text. Synopsis:
12900: @c 
12901: @command{printf}はテキストの書式化された表示を行います.概要です.
12902: 
12903: @example
12904: printf @var{format} [@var{argument}]@dots{}
12905: @end example
12906: 
12907: @c @command{printf} prints the @var{format} string, interpreting @samp{%}
12908: @c directives and @samp{\} escapes in the same way as the C @command{printf}
12909: @c function.  The @var{format} argument is re-used as necessary to convert
12910: @c all of the given @var{argument}s.
12911: @c 
12912: @command{printf}は,C @code{printf}関数と同じ方法で,@samp{%}指示語と
12913: @samp{\}エスケープを解釈しながら@var{format}文字列を表示します.与えら
12914: れた@var{argument}のすべてを変換する必要があるので,@var{format}引数は
12915: 再利用されます.
12916: 
12917: @c @command{printf} has one additional directive, @samp{%b}, which prints its
12918: @c argument string with @samp{\} escapes interpreted in the same way as in
12919: @c the @var{format} string.
12920: @c 
12921: @command{printf}は追加の指示語@samp{%b}があり,それは,@var{format}文
12922: 字列と同じ方法で@samp{\}エスケープを解釈しながら,その引数文字列を表示
12923: します.
12924: 
12925: @kindex \@var{ooo}
12926: @kindex \x@var{hh}
12927: 
12928: @c @command{printf} interprets @samp{\@var{ooo}} in @var{format} as an octal number
12929: @c (if @var{ooo} is 0 to 3 octal digits) specifying a character to print,
12930: @c and @samp{\x@var{hh}} as a hexadecimal number (if @var{hh} is 1 to 2 hex
12931: @c digits) specifying a character to print.
12932: @c 
12933: @command{printf}は,表示文字を指定するとき,@var{format}内の
12934: @samp{\0ooo}を(@var{ooo}が0から三桁の八進の場合)八進数として,そして,
12935: 表示文字を指定するとき,@samp{\xhhh}を(@var{hhh}が0から三桁の16進の場
12936: 合)16進数として解釈します.
12937: 
12938: @kindex \uhhhh
12939: @kindex \Uhhhhhhhh
12940: @c @command{printf} interprets two character syntaxes introduced in ISO C 99:
12941: @c @samp{\u} for 16-bit Unicode characters, specified as 4 hex digits
12942: @c @var{hhhh}, and @samp{\U} for 32-bit Unicode characters, specified as 8 hex
12943: @c digits @var{hhhhhhhh}. @command{printf} outputs the Unicode characters
12944: @c according to the LC_CTYPE part of the current locale, i.e. depending
12945: @c on the values of the environment variables @code{LC_ALL}, @code{LC_CTYPE},
12946: @c @code{LANG}.
12947: @c 
12948: @command{printf}は,@acronym{ISO} C 99で導入された二文字の構文を解釈し
12949: ます.四桁の16進数@var{hhhh}で指定される16ビットのUnicode文字に対する
12950: @samp{\u},そして,四桁の16進数@var{hhhhhhhh}で指定される32ビットの
12951: Unicode文字に対する@samp{\U}です.現在のロケールのLC_CTYPEの部分に依存
12952: して@command{printf}はUnicode文字を出力し,すなわち,環境変数
12953: @code{LC_ALL},@code{LC_CTYPE},@code{LANG}の値には依存しません.
12954: 
12955: @c The processing of @samp{\u} and @samp{\U} requires a full-featured
12956: @c @code{iconv} facility. It is activated on systems with glibc 2.2 (or newer),
12957: @c or when @code{libiconv} is installed prior to this package. Otherwise the
12958: @c use of @samp{\u} and @samp{\U} will give an error message.
12959: @c 
12960: @samp{\u}と@samp{\U}の処理では,@code{iconv}の機能が完全になっている必
12961: 要があります.glibc 2.2(またはそれより新しいもの)を用いたシステムや,
12962: このパッケージに優先する@code{libiconv}がインストールされているときは
12963: 動作します.それ以外で@samp{\u}と@samp{\U}を使用すると,エラーメッセー
12964: ジが表示されます.
12965: 
12966: @kindex \c
12967: @c An additional escape, @samp{\c}, causes @command{printf} to produce no
12968: @c further output.
12969: @c 
12970: 追加のエスケープ@samp{\c}は,@command{printf}にそれ以上の出力を生成さ
12971: せません.
12972: 
12973: @c The only options are a lone @option{--help} or
12974: @c @option{--version}.  @xref{Common options}.
12975: @c 
12976: オプションは,単独の@option{--help}や@option{--version}だけです.
12977: @xref{Common options}.
12978: 
12979: @c The Unicode character syntaxes are useful for writing strings in a locale
12980: @c independent way. For example, a string containing the Euro currency symbol
12981: @c 
12982: Unicode文字の構文は,ロケールに依存している文字列を書くとき役に立ちま
12983: す.例えば,Euro通貨の記号を含む文字列です.
12984: 
12985: @example
12986: $ /usr/local/bin/printf '\u20AC 14.95'
12987: @end example
12988: 
12989: @noindent
12990: @c will be output correctly in all locales supporting the Euro symbol
12991: @c (ISO-8859-15, UTF-8, and others). Similarly, a Chinese string
12992: @c 
12993: これで,Euroの記号をサポートしているすべてのロケールで(ISO-8859-15,
12994: UTF-8,他)正しく出力されます.同様に中国文字を利用します.
12995: 
12996: @example
12997: $ /usr/local/bin/printf '\u4e2d\u6587'
12998: @end example
12999: 
13000: @noindent
13001: @c will be output correctly in all Chinese locales (GB2312, BIG5, UTF-8, etc).
13002: @c 
13003: これで,すべての中国のロケール(GB2312,BIG5,UTF-8,等)で正しく出力さ
13004: れます.
13005: 
13006: @c Note that in these examples, the full pathname of @command{printf} has been
13007: @c given, to distinguish it from the GNU @code{bash} builtin function
13008: @c @command{printf}.
13009: @c 
13010: これらの例は,GNU @code{bash}の組み込み関数@command{printf}と区別する
13011: ため,@command{printf}のフルパス名が与えられていることに注意して下さい.
13012: 
13013: @c For larger strings, you don't need to look up the hexadecimal code
13014: @c values of each character one by one. @acronym{ASCII} characters mixed with \u
13015: @c escape sequences is also known as the JAVA source file encoding. You can
13016: @c use GNU recode 3.5c (or newer) to convert strings to this encoding. Here
13017: @c is how to convert a piece of text into a shell script which will output
13018: @c this text in a locale-independent way:
13019: @c 
13020: より長い文字列では,それぞれの文字一つ一つの16進数のコード値を探す必要
13021: がありません.@samp{\u}エスケープシーケンスが混ざっている
13022: @acronym{ASCII}文字は,JAVAのソースファイルのエンコードとして知られて
13023: います.このエンコードされた文字列を変換するために,GNU recode 3.5c(ま
13024: たはより新しいもの)を使用することが可能です.テキストの一部を,ロケー
13025: ルに依存しない方法でこのテキストを出力するシェルスクリプトに変換する方
13026: 法は以下のようになります.
13027: 
13028: @smallexample
13029: $ LC_CTYPE=zh_CN.big5 /usr/local/bin/printf \
13030:     '\u4e2d\u6587\n' > sample.txt
13031: $ recode BIG5..JAVA < sample.txt \
13032:     | sed -e "s|^|/usr/local/bin/printf '|" -e "s|$|\\\\n'|" \
13033:     > sample.sh
13034: @end smallexample
13035: 
13036: 
13037: @node yes invocation
13038: @c @section @command{yes}: Print a string until interrupted
13039: @section @command{yes}: 中断するまで文字列を出力
13040: 
13041: @pindex yes
13042: @cindex repeated output of a string
13043: 
13044: @c @command{yes} prints the command line arguments, separated by spaces and
13045: @c followed by a newline, forever until it is killed.  If no arguments are
13046: @c given, it prints @samp{y} followed by a newline forever until killed.
13047: @c 
13048: @command{yes}は,スペースで分離され改行後置されたコマンドライン引数を,
13049: キルされるまで永遠に出力します.引数が与えられない場合は,改行後置され
13050: た@samp{y}を,キルされるまで永遠に出力します.
13051: 
13052: @c The only options are a lone @option{--help} or @option{--version}.
13053: @c @xref{Common options}.
13054: @c 
13055: オプションは,単独の@option{--help}や@option{--version}だけです.
13056: @xref{Common options}.
13057: 
13058: 
13059: @node Conditions
13060: @c @chapter Conditions
13061: @chapter 条件文
13062: 
13063: @cindex conditions
13064: @cindex commands for exit status
13065: @cindex exit status commands
13066: 
13067: @c This section describes commands that are primarily useful for their exit
13068: @c status, rather than their output.  Thus, they are often used as the
13069: @c condition of shell @code{if} statements, or as the last command in a
13070: @c pipeline.
13071: @c 
13072: このセクションでは,その出力ではなく,終了ステータスが主に役に立つコマ
13073: ンドを記述します.このためそれらは,シェルの@code{if}文の条件やパイプ
13074: ラインの最後のコマンドとしてよく使用されます.
13075: 
13076: @menu
13077: * false invocation::            Do nothing, unsuccessfully.
13078: * true invocation::             Do nothing, successfully.
13079: * test invocation::             Check file types and compare values.
13080: * expr invocation::             Evaluate expressions.
13081: @end menu
13082: 
13083: 
13084: @node false invocation
13085: @c @section @command{false}: Do nothing, unsuccessfully
13086: @section @command{false}: 何もせず失敗します
13087: 
13088: @pindex false
13089: @cindex do nothing, unsuccessfully
13090: @cindex failure exit status
13091: @cindex exit status of @command{false}
13092: 
13093: @c @command{false} does nothing except return an exit status of 1, meaning
13094: @c @dfn{failure}.  It can be used as a place holder in shell scripts
13095: @c where an unsuccessful command is needed.
13096: @c 
13097: @command{false}は,@dfn{失敗(failure)}を意味する1の終了ステータスを返
13098: す以外何もしません.それは,シェルスクリプトの失敗のコマンドが必要な位
13099: 置で使用することが可能です.
13100: 
13101: @c By default, @command{false} honors the @option{--help} and @option{--version}
13102: @c options.  However, that is contrary to @acronym{POSIX}, so when the environment
13103: @c variable @env{POSIXLY_CORRECT} is set, @command{false} ignores @emph{all}
13104: @c command line arguments, including @option{--help} and @option{--version}.
13105: @c 
13106: デフォルトで,@command{false}は@option{--help}と@option{--version}を尊
13107: 重します.しかし,それは@acronym{POSIX}に準拠していないので,環境変数
13108: @env{POSIXLY_CORRECT}が設定されているとき,@command{false}は,
13109: @option{--help}と@option{--version}を含む,すべてのコマンドライン引数
13110: を無視します.
13111: 
13112: @c This version of @command{false} is implemented as a C program, and is thus
13113: @c more secure and faster than a shell script implementation, and may safely
13114: @c be used as a dummy shell for the purpose of disabling accounts.
13115: @c 
13116: このバージョンの@command{false}は,Cプログラムとして実装されていて,そ
13117: のため,シェルスクリプトの実装より安全かつ高速になり,アカウントの使用
13118: を禁止する目的のダミーシェルとして使用しても安全でしょう.
13119: 
13120: @c Note that @command{false} (unlike all other programs documented herein)
13121: @c exits unsuccessfully, even when invoked with
13122: @c @option{--help} or @option{--version}.
13123: @c 
13124: @command{false}は,(ここで説明されている他のすべてのプログラムとは異な
13125: り) @option{--help}や@option{--version}を用いて呼び出されても,失敗の
13126: 終了ステータスを返しすことに注意して下さい.
13127: 
13128: @node true invocation
13129: @c @section @command{true}: Do nothing, successfully
13130: @section @command{true}: 何もせず成功します
13131: 
13132: @pindex true
13133: @cindex do nothing, successfully
13134: @cindex no-op
13135: @cindex successful exit
13136: @cindex exit status of @command{true}
13137: 
13138: @c @command{true} does nothing except return an exit status of 0, meaning
13139: @c @dfn{success}.  It can be used as a place holder in shell scripts
13140: @c where a successful command is needed, although the shell built-in
13141: @c command @code{:} (colon) may do the same thing faster.
13142: @c In most modern shells, @command{true} is a built-in command, so when
13143: @c you use @samp{true} in a script, you're probably using the built-in
13144: @c command, not the one documented here.
13145: @c 
13146: @command{true}は,@dfn{成功(success)}を意味する0の終了ステータスを返す
13147: 以外何もしません.それは,シェルスクリプトの成功のコマンドが必要な位置
13148: で使用することが可能ですが,シェル組み込みコマンド @code{:} (コロン)は
13149: 同じことをより高速に行います.最近のほとんどのシェルでは,
13150: @command{true}が組み込みコマンドなので,スクリプトで@samp{true}を使用
13151: するとき,おそらくここで説明しているものではなく組み込みコマンドを使用
13152: することになります.
13153: 
13154: @c By default, @command{true} honors the @option{--help} and @option{--version}
13155: @c options.  However, that is contrary to @acronym{POSIX}, so when the environment
13156: @c variable @env{POSIXLY_CORRECT} is set, @command{true} ignores @emph{all}
13157: @c command line arguments, including @option{--help} and @option{--version}.
13158: @c 
13159: デフォルトで,は@option{--help}と@option{--version}を尊重します.しか
13160: し,それは@acronym{POSIX}に準拠していないので,環境変数
13161: @env{POSIXLY_CORRECT}が設定されているとき,@command{true}は
13162: @option{--help}と@option{--version}を含む,すべてのコマンドライン引数
13163: を無視します.
13164: 
13165: @c This version of @command{true} is implemented as a C program, and is thus
13166: @c more secure and faster than a shell script implementation, and may safely
13167: @c be used as a dummy shell for the purpose of disabling accounts.
13168: @c 
13169: このバージョンの@command{true}は,Cプログラムとして実装されていて,そ
13170: のため,シェルスクリプトの実装より安全かつ高速になり,アカウントの使用
13171: を禁止する目的のダミーシェルとして使用しても安全でしょう.
13172: 
13173: @node test invocation
13174: @c @section @command{test}: Check file types and compare values
13175: @section @command{test}: ファイル形式の調査と値の比較
13176: 
13177: @pindex test
13178: @cindex check file types
13179: @cindex compare values
13180: @cindex expression evaluation
13181: 
13182: @c @command{test} returns a status of 0 (true) or 1 (false) depending on the
13183: @c evaluation of the conditional expression @var{expr}.  Each part of the
13184: @c expression must be a separate argument.
13185: @c 
13186: 条件式@var{expr}の評価に依存して,0(真)または1(偽)のステータスを返しま
13187: す.式のそれぞれの部分は,分離された引数にする必要があります.
13188: 
13189: @c @command{test} has file status checks, string operators, and numeric
13190: @c comparison operators.
13191: @c 
13192: @command{test}には,ファイルのステータスの調査,文字演算子,そして数字
13193: 比較の演算子があります.
13194: 
13195: @cindex conflicts with shell built-ins
13196: @cindex built-in shell commands, conflicts with
13197: @c Because most shells have a built-in command by the same name, using the
13198: @c unadorned command name in a script or interactively may get you
13199: @c different functionality than that described here.
13200: @c 
13201: ほとんどのシェルには同じ名前の組み込みコマンドがあるため,スクリプト内
13202: や対話的に簡素なコマンド名を使用すると,ここで記述するものと異なる機能
13203: となる可能性があります.
13204: 
13205: @c Besides the options below, @command{test} accepts a lone @option{--help} or
13206: @c @option{--version}.  @xref{Common options}.  A single non-option argument
13207: @c is also allowed: @command{test} returns true if the argument is not null.
13208: @c 
13209: 以下のオプションの他に,@command{test}は,単独の@option{--help}や
13210: @option{--version}を受け入れます.@xref{Common options}. 単一のオプショ
13211: ン無しの引数も可能です.@command{test}は,引数がnullでない場合,真を返
13212: します.
13213: 
13214: @menu
13215: * File type tests::             -[bcdfhLpSt]
13216: * Access permission tests::     -[gkruwxOG]
13217: * File characteristic tests::   -e -s -nt -ot -ef
13218: * String tests::                -z -n = !=
13219: * Numeric tests::               -eq -ne -lt -le -gt -ge
13220: * Connectives for test::        ! -a -o
13221: @end menu
13222: 
13223: 
13224: @node File type tests
13225: @c @subsection File type tests
13226: @subsection ファイル形式のテスト
13227: 
13228: @cindex file type tests
13229: 
13230: @c These options test for particular types of files.  (Everything's a file,
13231: @c but not all files are the same!)
13232: @c 
13233: これらのオプションは,ファイルの特定の形式をテストします.(ファイルの
13234: すべてですが,すべてのファイルが同じではありません!)
13235: 
13236: @table @samp
13237: 
13238: @item -b @var{file}
13239: @opindex -b
13240: @cindex block special check
13241: @c True if @var{file} exists and is a block special device.
13242: @c 
13243: @var{file}が存在し,ブロックスペシャルデバイスの場合は真です.
13244: 
13245: @item -c @var{file}
13246: @opindex -c
13247: @cindex character special check
13248: @c True if @var{file} exists and is a character special device.
13249: @c 
13250: @var{file}が存在し,キャラクタスペシャルデバイスの場合は真です.
13251: 
13252: @item -d @var{file}
13253: @opindex -d
13254: @cindex directory check
13255: @c True if @var{file} exists and is a directory.
13256: @c 
13257: @var{file}が存在し,ディレクトリの場合は真です.
13258: 
13259: @item -f @var{file}
13260: @opindex -f
13261: @cindex regular file check
13262: @c True if @var{file} exists and is a regular file.
13263: @c 
13264: @var{file}が存在し,通常のファイルの場合は真です.
13265: 
13266: @item -h @var{file}
13267: @itemx -L @var{file}
13268: @opindex -L
13269: @opindex -h
13270: @cindex symbolic link check
13271: @c True if @var{file} exists and is a symbolic link.
13272: @c 
13273: @var{file}が存在し,シンボリックリンクの場合は真です.
13274: 
13275: @item -p @var{file}
13276: @opindex -p
13277: @cindex named pipe check
13278: @c True if @var{file} exists and is a named pipe.
13279: @c 
13280: @var{file}が存在し,名前付きパイプの場合は真です.
13281: 
13282: @item -S @var{file}
13283: @opindex -S
13284: @cindex socket check
13285: @c True if @var{file} exists and is a socket.
13286: @c 
13287: @var{file}が存在し,ソケットの場合は真です.
13288: 
13289: @item -t [@var{fd}]
13290: @opindex -t
13291: @cindex terminal check
13292: @c True if @var{fd} is opened on a terminal.  If @var{fd} is omitted, it
13293: @c defaults to 1 (standard output).
13294: @c 
13295: @var{fd}が端末上で開かれている場合は真です.@var{fd}が省略された場合,
13296: それはデフォルトで1(標準出力)になります.
13297: 
13298: @end table
13299: 
13300: 
13301: @node Access permission tests
13302: @c @subsection Access permission tests
13303: @subsection アクセス許可のテスト
13304: 
13305: @cindex access permission tests
13306: @cindex permission tests
13307: 
13308: @c These options test for particular access permissions.
13309: @c 
13310: これらのオプションは,特定のアクセス許可をテストします.
13311: 
13312: @table @samp
13313: 
13314: @item -g @var{file}
13315: @opindex -g
13316: @cindex set-group-id check
13317: @c True if @var{file} exists and has its set-group-id bit set.
13318: @c 
13319: @var{file}が存在し,そのセットグループidビットが設定されている場合は真
13320: です.
13321: 
13322: @item -k @var{file}
13323: @opindex -k
13324: @cindex sticky bit check
13325: @c True if @var{file} has its @dfn{sticky} bit set.
13326: @c 
13327: @var{file}が存在し,@dfn{スティッキー(sticky)}ビットが設定されている場
13328: 合は真です.
13329: 
13330: @item -r @var{file}
13331: @opindex -r
13332: @cindex readable file check
13333: @c True if @var{file} exists and is readable.
13334: @c 
13335: @var{file}が存在し,読み込み可能な場合は真です.
13336: 
13337: @item -u @var{file}
13338: @opindex -u
13339: @cindex set-user-id check
13340: @c True if @var{file} exists and has its set-user-id bit set.
13341: @c 
13342: @var{file}が存在し,セットユーザidビットが設定されている場合は真です.
13343: 
13344: @item -w @var{file}
13345: @opindex -w
13346: @cindex writable file check
13347: @c True if @var{file} exists and is writable.
13348: @c 
13349: @var{file}が存在し,書き込み可能な場合は真です.
13350: 
13351: @item -x @var{file}
13352: @opindex -x
13353: @cindex executable file check
13354: @c True if @var{file} exists and is executable.
13355: @c 
13356: @var{file}が存在し,実行可能な場合は真です.
13357: 
13358: @item -O @var{file}
13359: @opindex -O
13360: @cindex owned by effective uid check
13361: @c True if @var{file} exists and is owned by the current effective user id.
13362: @c 
13363: @var{file}が存在し,現在実施中のユーザidに所有されている場合は真です.
13364: 
13365: @item -G @var{file}
13366: @opindex -G
13367: @cindex owned by effective gid check
13368: @c True if @var{file} exists and is owned by the current effective group id.
13369: @c 
13370: @var{file}が存在し,現在実施中のグループidに所有されている場合は真です.
13371: 
13372: @end table
13373: 
13374: @node File characteristic tests
13375: @c @subsection File characteristic tests
13376: @subsection ファイルの特徴テスト
13377: 
13378: @cindex file characteristic tests
13379: 
13380: @c These options test other file characteristics.
13381: @c 
13382: これらのオプションはその他のファイルの特徴を調査します.
13383: 
13384: @table @samp
13385: 
13386: @item -e @var{file}
13387: @opindex -e
13388: @cindex existence-of-file check
13389: @c True if @var{file} exists.
13390: @c 
13391: @var{file}が存在している場合は真です.
13392: 
13393: @item -s @var{file}
13394: @opindex -s
13395: @cindex nonempty file check
13396: @c True if @var{file} exists and has a size greater than zero.
13397: @c 
13398: @var{file}が存在し,大きさがゼロより大きい場合は真です.
13399: 
13400: @item @var{file1} -nt @var{file2}
13401: @opindex -nt
13402: @cindex newer-than file check
13403: @c True if @var{file1} is newer (according to modification date) than
13404: @c @var{file2}, or if @var{file1} exists and @var{file2} does not.
13405: @c 
13406: @var{file1}が@var{file2}より(修正日で)新しい場合,または,@var{file1}
13407: が存在し@var{file2}が存在しない場合は真です.
13408: 
13409: @item @var{file1} -ot @var{file2}
13410: @opindex -ot
13411: @cindex older-than file check
13412: @c True if @var{file1} is older (according to modification date) than
13413: @c @var{file2}, or if @var{file2} exists and @var{file1} does not.
13414: @c 
13415: @var{file1}が@var{file2}より(修正日で)古い場合,または,@var{file2}が
13416: 存在し@var{file1}が存在しない場合は真です.
13417: 
13418: @item @var{file1} -ef @var{file2}
13419: @opindex -ef
13420: @cindex same file check
13421: @cindex hard link check
13422: @c True if @var{file1} and @var{file2} have the same device and inode
13423: @c numbers, i.e., if they are hard links to each other.
13424: @c 
13425: @var{file1}と@var{file2}が同じデバイスとi-node番号を持つ場合,すなわち,
13426: それらがお互いにハードリンクの場合は真です.
13427: 
13428: @end table
13429: 
13430: 
13431: @node String tests
13432: @c @subsection String tests
13433: @subsection 文字列のテスト
13434: 
13435: @cindex string tests
13436: 
13437: @c These options test string characteristics.  Strings are not quoted for
13438: @c @command{test}, though you may need to quote them to protect characters
13439: @c with special meaning to the shell, e.g., spaces.
13440: @c 
13441: これらのオプションは文字列の特徴をテストします.文字列は@command{test} 
13442: に対して引用符で囲みませんが,例えばスペースのような,シェルで特別な意
13443: 味を持つ文字を保護するために,それらを引用符で囲む必要があるかもしれま
13444: せん.
13445: 
13446: @table @samp
13447: 
13448: @item -z @var{string}
13449: @opindex -z
13450: @cindex zero-length string check
13451: @c True if the length of @var{string} is zero.
13452: @c 
13453: @var{string}の長さがゼロの場合は真です.
13454: 
13455: @item -n @var{string}
13456: @itemx @var{string}
13457: @opindex -n
13458: @cindex nonzero-length string check
13459: @c True if the length of @var{string} is nonzero.
13460: @c 
13461: @var{string}の長さがゼロではないの場合は真です.
13462: 
13463: @item @var{string1} = @var{string2}
13464: @opindex =
13465: @cindex equal string check
13466: @c True if the strings are equal.
13467: @c 
13468: 文字列が等しい場合は真です.
13469: 
13470: @item @var{string1} != @var{string2}
13471: @opindex !=
13472: @cindex not-equal string check
13473: @c True if the strings are not equal.
13474: @c 
13475: 文字列が等しくない場合は真です.
13476: 
13477: @end table
13478: 
13479: 
13480: @node Numeric tests
13481: @c @subsection Numeric tests
13482: @subsection 数値テスト
13483: 
13484: @cindex numeric tests
13485: @cindex arithmetic tests
13486: 
13487: @c Numeric relationals.  The arguments must be entirely numeric (possibly
13488: @c negative), or the special expression @w{@code{-l @var{string}}}, which
13489: @c evaluates to the length of @var{string}.
13490: @c 
13491: 数値の関係です.引数は,完全な数値(負も可能です),または,@var{string}
13492: の長さを評価する特別な式@w{@code{-l @var{string}}}にする必要があります.
13493: 
13494: @table @samp
13495: 
13496: @item @var{arg1} -eq @var{arg2}
13497: @itemx @var{arg1} -ne @var{arg2}
13498: @itemx @var{arg1} -lt @var{arg2}
13499: @itemx @var{arg1} -le @var{arg2}
13500: @itemx @var{arg1} -gt @var{arg2}
13501: @itemx @var{arg1} -ge @var{arg2}
13502: @opindex -eq
13503: @opindex -ne
13504: @opindex -lt
13505: @opindex -le
13506: @opindex -gt
13507: @opindex -ge
13508: @c These arithmetic binary operators return true if @var{arg1} is equal,
13509: @c not-equal, less-than, less-than-or-equal, greater-than, or
13510: @c greater-than-or-equal than @var{arg2}, respectively.
13511: @c 
13512: これらの算数の二項演算子は,それぞれ,@var{arg1}が@var{arg2}に比べて,
13513: 等しい,等しくない,小さい,以下,大きい,または以上の場合に真を返しま
13514: す.
13515: 
13516: @end table
13517: 
13518: @c For example:
13519: @c 
13520: 例えば以下のようにします.
13521: 
13522: @example
13523: test -1 -gt -2 && echo yes
13524: @result{} yes
13525: test -l abc -gt 1 && echo yes
13526: @result{} yes
13527: test 0x100 -eq 1
13528: @error{} test: integer expression expected before -eq
13529: @end example
13530: 
13531: 
13532: @node Connectives for test
13533: @c @subsection Connectives for @command{test}
13534: @subsection @command{test}の連結
13535: 
13536: @cindex logical connectives
13537: @cindex connectives, logical
13538: 
13539: @c The usual logical connectives.
13540: @c 
13541: 通常の論理結合子です.
13542: 
13543: @table @samp
13544: 
13545: @item ! @var{expr}
13546: @opindex !
13547: @c True if @var{expr} is false.
13548: @c 
13549: @var{expr}が偽の場合は真です.
13550: 
13551: @item @var{expr1} -a @var{expr2}
13552: @opindex -a
13553: @cindex logical and operator
13554: @cindex and operator
13555: @c True if both @var{expr1} and @var{expr2} are true.
13556: @c 
13557: @var{expr1}と@var{expr2}の両方が真の場合は真です.
13558: 
13559: @item @var{expr1} -o @var{expr2}
13560: @opindex -o
13561: @cindex logical or operator
13562: @cindex or operator
13563: @c True if either @var{expr1} or @var{expr2} is true.
13564: @c 
13565: @var{expr1}または@var{expr2}のどちらかが真の場合は真です.
13566: 
13567: @end table
13568: 
13569: 
13570: @node expr invocation
13571: @c @section @command{expr}: Evaluate expressions
13572: @section @command{expr}: 式の評価
13573: 
13574: @pindex expr
13575: @cindex expression evaluation
13576: @cindex evaluation of expressions
13577: 
13578: @c @command{expr} evaluates an expression and writes the result on standard
13579: @c output.  Each token of the expression must be a separate argument.
13580: @c 
13581: @command{expr}は式を評価し,結果を標準出力に書き出します.それぞれの式
13582: のトークンは,分離している引数にする必要があります.
13583: 
13584: @c Operands are either numbers or strings.  @command{expr} converts
13585: @c anything appearing in an operand position to an integer or a string
13586: @c depending on the operation being applied to it.
13587: @c 
13588: オペランドは数字または文字列のどちらかになります.@command{expr}は,あ
13589: らゆるものが,適用されているオペレーションに依存して,整数または文字列
13590: がオペランドの位置に存在することを強制します.
13591: 
13592: @c Strings are not quoted for @command{expr} itself, though you may need to
13593: @c quote them to protect characters with special meaning to the shell,
13594: @c e.g., spaces.
13595: @c 
13596: 文字列は@command{expr}対し引用符で囲みませんが,例えばスペースのような,
13597: シェルで特別な意味を持つ文字を保護するために,それらを引用符で囲む必要
13598: があるかもしれません.
13599: 
13600: @cindex parentheses for grouping
13601: @c Operators may be given as infix symbols or prefix keywords.  Parentheses
13602: @c may be used for grouping in the usual manner (you must quote parentheses
13603: @c to avoid the shell evaluating them, however).
13604: @c 
13605: 演算子は,挿入辞シンボルや前置キーワードとして与えることができます.カッ
13606: コは,通常の方法のグループとして使用してもかまいません(しかし,シェル
13607: がカッコを評価することを避けるために,カッコを引用符で囲む必要がありま
13608: す).
13609: 
13610: @cindex exit status of @command{expr}
13611: @c Exit status:
13612: @c 
13613: 終了ステータスは,以下のようになります.
13614: 
13615: @display
13616: @c 0 if the expression is neither null nor 0,
13617: @c 1 if the expression is null or 0,
13618: @c 2 for invalid expressions.
13619: @c 
13620: 0 式がnullでも0でもない場合.
13621: 1 式がnullまたは0の場合.
13622: 2 有効な式の場合.
13623: @end display
13624: 
13625: @menu
13626: * String expressions::          + : match substr index length
13627: * Numeric expressions::         + - * / %
13628: * Relations for expr::          | & < <= = == != >= >
13629: * Examples of expr::            Examples.
13630: @end menu
13631: 
13632: 
13633: @node String expressions
13634: @c @subsection String expressions
13635: @subsection 文字列式
13636: 
13637: @cindex string expressions
13638: @cindex expressions, string
13639: 
13640: @c @command{expr} supports pattern matching and other string operators.  These
13641: @c have lower precedence than both the numeric and relational operators (in
13642: @c the next sections).
13643: @c 
13644: @command{expr}は,パターンマッチングと,その他の文字列演算子をサポート
13645: します.これらは,(次のセクションの)数字と関係の両演算子より低い優先順
13646: 位になります.
13647: 
13648: @table @samp
13649: 
13650: @item @var{string} : @var{regex}
13651: @cindex pattern matching
13652: @cindex regular expression matching
13653: @cindex matching patterns
13654: @c Perform pattern matching.  The arguments are converted to strings and the
13655: @c second is considered to be a (basic, a la GNU @code{grep}) regular
13656: @c expression, with a @code{^} implicitly prepended.  The first argument is
13657: @c then matched against this regular expression.
13658: @c 
13659: パターンマッチングを実行します.引数は文字列に制限され,二番目は,
13660: @code{^}が暗黙に前置された(基本的に@sc{gnu}流の@command{grep}の)正規表
13661: 現と考えられます.最初の引数は,この正規表現に対しマッチの評価がなされ
13662: ます.
13663: 
13664: @c If the match succeeds and @var{regex} uses @samp{\(} and @samp{\)}, the
13665: @c @code{:} expression returns the part of @var{string} that matched the
13666: @c subexpression; otherwise, it returns the number of characters matched.
13667: @c 
13668: マッチの評価が成功し,@var{regex}が@samp{\(}と@samp{\)}を使用している
13669: 場合,@code{:}式は,サブ式にマッチした@var{string}の一部となります.そ
13670: れ以外の場合はマッチした文字の数を返します.
13671: 
13672: @c If the match fails, the @code{:} operator returns the null string if
13673: @c @samp{\(} and @samp{\)} are used in @var{regex}, otherwise 0.
13674: @c 
13675: マッチの評価に失敗した場合,@var{regex}で@samp{\(}と@samp{\)}が使用さ
13676: れていれば@code{:}演算子はnull文字を返し,それ以外では0を返します.
13677: 
13678: @kindex \( @r{regexp operator}
13679: @c Only the first @samp{\( @dots{} \)} pair is relevant to the return
13680: @c value; additional pairs are meaningful only for grouping the regular
13681: @c expression operators.
13682: @c 
13683: 最初の@samp{\( @dots{} \)}の組のみ,戻り値に関係します.追加の組は,正
13684: 規表現演算子のグループ化の意味しかありません.
13685: 
13686: @kindex \+ @r{regexp operator}
13687: @kindex \? @r{regexp operator}
13688: @kindex \| @r{regexp operator}
13689: @c In the regular expression, @code{\+}, @code{\?}, and @code{\|} are
13690: @c operators which respectively match one or more, zero or one, or separate
13691: @c alternatives.  SunOS and other @command{expr}'s treat these as regular
13692: @c characters.  (@acronym{POSIX} allows either behavior.)
13693: @c @xref{Top, , Regular Expression Library, regex, Regex}, for details of
13694: @c regular expression syntax.  Some examples are in @ref{Examples of expr}.
13695: @c 
13696: 正規表現内では,@code{\+},@code{\?},そして@code{\|}は,それぞれ,1以
13697: 上,ゼロ以上,オア分離の選択肢の演算子です.SunOSとその他の
13698: @command{expr}はこれらを通常の文字として扱います.(@acronym{POSIX}は,
13699: どちらの動作も許可します.) 正規表現の構文の詳細は,@xref{Top, ,
13700: Regular Expression Library, regex, Regex}.  例は@ref{Examples of expr} 
13701: にあります.
13702: 
13703: @item match @var{string} @var{regex}
13704: @findex match
13705: @c An alternative way to do pattern matching.  This is the same as
13706: @c @w{@samp{@var{string} : @var{regex}}}.
13707: @c 
13708: パターンマッチングを行う別の方法です.これは,@w{@samp{@var{string} :
13709: @var{regex}}}と同じです.
13710: 
13711: @item substr @var{string} @var{position} @var{length}
13712: @findex substr
13713: @c Returns the substring of @var{string} beginning at @var{position}
13714: @c with length at most @var{length}.  If either @var{position} or
13715: @c @var{length} is negative, zero, or non-numeric, returns the null string.
13716: @c 
13717: 少なくとも@var{length}の長さの,@var{position}から始まる,@var{string}
13718: のサブ文字列を返します.@var{position}または@var{length}のどちらかが,
13719: 負,ゼロ,または数字以外の場合,null文字列を返します.
13720: 
13721: @item index @var{string} @var{charset}
13722: @findex index
13723: @c Returns the first position in @var{string} where the first character in
13724: @c @var{charset} was found.  If no character in @var{charset} is found in
13725: @c @var{string}, return 0.
13726: @c 
13727: @var{charset}の最初の文字が見つかった,@var{string}の最初の位置を返し
13728: ます.@var{charset}の文字が@var{string}で見つからない場合は,0を返しま
13729: す.
13730: 
13731: @item length @var{string}
13732: @findex length
13733: @c Returns the length of @var{string}.
13734: @c 
13735: @var{string}の長さを返します.
13736: 
13737: @item + @var{token}
13738: @kindex +
13739: @c Interpret @var{token} as a string, even if it is a keyword like @var{match}
13740: @c or an operator like @code{/}.
13741: @c This makes it possible to test @code{expr length + "$x"} or
13742: @c @code{expr + "$x" : '.*/\(.\)'} and have it do the right thing even if
13743: @c the value of @var{$x} happens to be (for example) @code{/} or @code{index}.
13744: @c This operator is a GNU extension.  Portable shell scripts should use
13745: @c @code{@w{" $token"} : @w{' \(.*\)'}} instead of @code{+ "$token"}.
13746: @c 
13747: キーワードのような@var{match}や,演算子のような@code{/}の場合でも,
13748: @var{token}を文字列として解釈します.これで,@code{expr length + "$x"} 
13749: や@code{expr + "$x" : '.*/\(.\)'}のテストが可能となり,@var{$x}の値が
13750: (例えば)@code{/}や@code{index}に偶然なった場合でも,正しく動作します.
13751: この演算子は@sc{gnu}の拡張です.移植性の高いシェルスクリプトでは,
13752: @code{+ "$token"}の代わりに@code{@w{" $token"} : @w{' \(.*\)'}}を使用
13753: すべきです.
13754: 
13755: @end table
13756: 
13757: @c To make @command{expr} interpret keywords as strings, you must use the
13758: @c @code{quote} operator.
13759: @c 
13760: @command{expr}にキーワードとして文字列を解釈させるために,@code{quote}
13761: