.\" Japanese Version Copyright (c) 1997 Tanoshima Hidetohsi
.\"         all rights reserved.
.\" Translated Jan 31, 1997
.\"         by Tanoshima Hidetoshi <tano@sainet.or.jp>
.\" Updated Tue May  8 16:54:29 JST 2001
.\"         by Asakawa Satoshi <rod@i.am>
.\"
.\" WORD:        octal escapes             8進数のシーケンス
.\" WORD:        change time               最終変更時刻
.\" WORD:        ctime                     最終変更時刻
.\" WORD:        modification time         最終変更時刻
.\" WORD:        access time               最終アクセス時刻
.\" WORD:        atime                     最終アクセス時刻
.\" WORD:        Emacs' dired mode         Emacsのディレクトリエディタモード
.\" WORD:        index number              i-node番号
.\"
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.5.1.2.
.TH LS 1 "November 1998" "GNU fileutils 4.0" "FSF"
.SH 名前
ls \- ディレクトリの内容をリスト表示する
.SH 書式
.B ls
[\fIオプション\fR]... [\fIFILE\fR]...
.SH 説明
.PP
.\" Add any additional description here
.PP
指定したFILEについての情報をリスト表示する (デフォルトはカレントディレクトリ)。
\fB\-cftuSUX\fR や \fB\-\-sort\fR のオプション指定がなければ、
アルファベット順にソートして表示する。
.TP
\fB\-a\fR, \fB\-\-all\fR
`.' で始まる名前のファイルを隠さずに、全てのファイルをリスト表示する。
.TP
\fB\-A\fR, \fB\-\-almost\-all\fR
`.' と `..' 以外の全てのファイルをリスト表示する。
.TP
\fB\-b\fR, \fB\-\-escape\fR
非表示文字を8進数のシーケンスで表示する。
.TP
\fB\-\-block\-size\fR=\fISIZE\fR
ブロックサイズをSIZEバイトで表示する。
.TP
\fB\-B\fR, \fB\-\-ignore\-backups\fR
`~' で終わるファイルをリスト表示しない。
(訳注: 但し、引数でファイルを指定した場合は表示する。)
.TP
\fB\-c\fR
最終変更時刻でソートする。
オプション \fB\-lt\fR を伴う場合には最終変更時刻を表示する。
オプション \fB\-l\fR のみの場合には名前でソートされ、最終変更時刻を表示する。
.TP
\fB\-C\fR
複数列でリスト表示する。
.TP
\fB\-\-color\fR[=\fIWHEN\fR]
ファイルタイプを区別するための色づけの有無を指定する。
WHEN は `never', `always',  `auto' のいずれか。
.TP
\fB\-d\fR, \fB\-\-directory\fR
ディレクトリの中身を表示する代わりに、
ディレクトリ名をリスト表示し、シンボリックリンクを参照しない。
.TP
\fB\-D\fR, \fB\-\-dired\fR
Emacsのディレクトリエディタモードのために必要な情報を生成する。
(訳注: オプション `-l' と一緒に使われた場合、
出力の最後に次のような追加の行を表示する：
.sp
.nf
.B "   //DIRED//"
.I "   BEG1 END1 BEG2 END2 ..."
.B "   //DIRED-OPTIONS// \-\-quoting-style=\fIWORD\fR"
.fi
.sp
.IR BEGn " と " ENDn
は符号なし整数で、リスト出力における
各ファイル名の始めと終わりのバイト位置を記録したものである。
このオプションを使うと、
ファイル名にスペースや改行といった普段使わない文字が含まれている場合でも、
Emacs でファイル名を探すのが簡単になる。
ここで \fIWORD\fR はクォートのスタイルである。)
.TP
\fB\-f\fR
ソートせず表示する。オプション \fB\-aU\fR と同等。
-f より前に \fB\-lst\fR が指定された場合、それらのオプションは無効になる。
.TP
\fB\-F\fR, \fB\-\-classify\fR
ファイルタイプを示す印 (*/=@| のいずれか) を付加して表示する。
.TP
\fB\-\-format\fR=\fIWORD\fR
表示形式を指定する。\fIWORD\fR としては次の文字列を指定できる : 
across (\fB\-x\fR と同等), commas \fB\-m\fR, horizontal \fB\-x\fR, 
long \fB\-l\fR, single-column \fB\-1\fR, verbose \fB\-l\fR, vertical \fB\-C\fR
.TP
\fB\-\-full\-time\fR
時間に関する情報を標準の省略形式ではなく完全な形式でリスト表示する。
.TP
\fB\-g\fR
所有者情報を含まないリストを表示する。
.TP
\fB\-G\fR, \fB\-\-no\-group\fR
グループ情報を表示しない。
.TP
\fB\-h\fR, \fB\-\-human\-readable\fR
人が読み易い形式 (例えば 1K 234M 2G) で表示する。
.TP
\fB\-\-si\fR
同上。但し、1024 倍単位ではなく 1000 倍単位を用いる。
(訳注: si は国際単位系のこと。)
.TP
\fB\-H\fR, \fB\-\-dereference\-command\-line\fR
コマンドラインに指定したシンボリックリンクを参照して表示する。
.TP
\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fR
コマンドラインに指定したディレクトリを指すシンボリックリンクを参照して表示する。
.TP
\fB\-\-indicator\-style\fR=\fIWORD\fR
WORD で指定されたスタイルに従って、ファイルタイプを示す印を付加して表示する。
\fIWORD\fR としては次の文字列を指定できる : 
none (デフォルト), classify (-F と同等), file-type (-p と同等)
.TP
\fB\-i\fR, \fB\-\-inode\fR
各ファイルの i-node 番号を表示する。
.TP
\fB\-I\fR, \fB\-\-ignore\fR=\fIPATTERN\fR
シェルパターン PATTERN にマッチする名前のファイルはリスト表示しない 。
.TP
\fB\-k\fR
\fB\-\-block\-size\fR=\fI1K\fR と同様。
.TP
\fB\-l\fR
長い形式でリスト表示する。
.TP
\fB\-L\fR, \fB\-\-dereference\fR
シンボリックリンクそのものではなく、参照しているファイルの情報をリスト表示する。
.TP
\fB\-m\fR
ファイル名をコンマとスペースで区切って、
それぞれの行にできるだけ多く詰め込み、横にリスト表示する。
.TP
\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR
ユーザ名・グループ名のかわりに数字の UID と GID をリスト表示する。
.TP
\fB\-N\fR, \fB\-\-literal\fR
ファイル名中の非表示文字の変換を行わない。
(例えば、コントロール文字を特別扱いしない)
.TP
\fB\-o\fR
長い形式でリスト表示するが、グループ情報を表示しない。
.TP
\fB\-p\fR, \fB\-\-file\-type\fR
ファイルタイプを示す印 (/=@| のいずれか) を付加して表示する。
.TP
\fB\-q\fR, \fB\-\-hide\-control\-chars\fR
非表示文字を ? (クエスチョンマーク) で置き換えて表示する。
.TP
\fB\-\-show\-control\-chars\fR
非表示文字をそのまま出力する (デフォルト)。
.TP
\fB\-Q\fR, \fB\-\-quote\-name\fR
ファイル名をダブルクォートで囲む。
.TP
\fB\-\-quoting\-style\fR=\fIWORD\fR
WORD で指定されたスタイルに従って、ファイル名を囲む。
\fIWORD\fR としては次の文字列を指定できる : 
literal, shell, shell-always, c, escape
.TP
\fB\-r\fR, \fB\-\-reverse\fR
ソートの順序を逆にする。
.TP
\fB\-R\fR, \fB\-\-recursive\fR
サブディレクトリがあれば、再帰的にリスト表示する。
.TP
\fB\-s\fR, \fB\-\-size\fR
各ファイルのファイルサイズ (訳注: 1024 バイトブロック単位) を表示する。
.TP
\fB\-S\fR
ファイルサイズでソートする。
.TP
\fB\-\-sort\fR=\fIWORD\fR
ソートの順序を指定する。\fIWORD\fR としては次の文字列を指定できる : 
extension (\fB\-X\fRと同等), none (\fB\-U\fR), size (\fB\-S\fR), 
version (\fB\-v\fR), status (\fB\-c\fR), time (\fB\-t\fR), atime (\fB\-u\fR), 
access (\fB\-u\fR), use (\fB\-u\fR)
.TP
\fB\-\-time\fR=\fIWORD\fR
最終変更時刻の代りにWORDで指定された時間を表示する。
また、オプション \fB\-\-sort\fR=\fItime\fR と一緒に使用された場合、
WORDで指定された時間の順序でソートされる。
\fIWORD\fR としては次の文字列を指定できる : atime, access, use, ctime, status
.TP
\fB\-t\fR
最終変更時刻でソートする。
.TP
\fB\-T\fR, \fB\-\-tabsize\fR=\fICOLS\fR
タブストップの幅を COLS で指定した文字分とする。
デフォルトは 8 文字分。
.TP
\fB\-u\fR
最終アクセス時刻でソートする。
オプション `\fB\-l\fR' を伴う場合は最終アクセス時刻を表示する。
.TP
\fB\-U\fR
ソートせず、ディスク上にある順番にリスト表示する。
.TP
\fB\-v\fR
バージョン名とバージョン番号でソートする。
(訳注: バージョンの一番低いものが最初にくる。
デフォルトのソートのように動作するが、10 進の数字のシーケンスは、
インデックス番号またはバージョン番号として数値的に扱われる。
ゼロを前にもつ数値部分は小数として扱われる。
.sp
.nf
.B "   ls \-1           ls \-1v"
   bar\-1.gz        bar\-1.gz
   bar\-100.gz      bar\-2.gz
   bar\-12.gz       bar\-12.gz
   bar\-2.gz        bar\-100.gz
   foo\-1.007.gz    foo\-1.007.gz
   foo\-1.012b.gz   foo\-1.01a.gz
   foo\-1.01a.gz    foo\-1.012b.gz
.fi
)
.TP
\fB\-w\fR, \fB\-\-width\fR=\fICOLS\fR
スクリーンの幅を COLS で指定した文字分とする。
.TP
\fB\-x\fR
列単位ではなく行単位にリスト表示する。
.TP
\fB\-X\fR
拡張子 (訳注: 最後の `.' の後に続く文字列) のアルファベット順にソートする。
.TP
\fB\-1\fR
1列でリスト表示する。
.TP
\fB\-\-help\fR
使用方法を表示して正常終了する。
.TP
\fB\-\-version\fR
バージョン情報を出力して正常終了する。
.PP
デフォルトではファイルタイプを区別するための色づけはなされない。
つまり、オプション \fB\-\-color\fR=\fInone\fR が指定された場合と同等である。
引数 WHEN が省略され、オプション \fB\-\-color\fR と指定された場合は、
オプション \fB\-\-color\fR=\fIalways\fR が指定された場合と同等である。
.SH バグレポート
バグレポートは <bug-fileutils@gnu.org> へ。
.SH 関連項目
.B ls
の完全なドキュメントは info マニュアルとしてメンテナンスされている。
.B info
と
.B ls
が正しくインストールされていれば、次のコマンド
.IP
.B info ls
.PP
で完全なマニュアルを参照することができる。