aniani/vim
0
0
Fork 1
mirror of https://github.com/vim/vim.git synced 2025-07-04 23:07:33 -04:00
Code

updated for version 7.4a.015

Browse Source 
Problem:    No Japanese man pages.
Solution:   Add Japanese translations of man pages. (Ken Takata, Yukihiro
            Nakadaira, et al.)
This commit is contained in:
Bram Moolenaar 2013-07-13 15:33:20 +02:00
parent 8e46f7264c
commit a3fe8fe632
8 changed files with 1019 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
Filelist
View File

@ -694,6 +694,7 @@ LANG_GEN = \
runtime/doc/*-fr.UTF-8.1 \
runtime/doc/*-it.1 \
runtime/doc/*-it.UTF-8.1 \
runtime/doc/*-ja.UTF-8.1 \
runtime/doc/*-pl.1 \
runtime/doc/*-pl.UTF-8.1 \
runtime/doc/*-ru.1 \

51
runtime/doc/evim-ja.UTF-8.1 Normal file
View File

@ -0,0 +1,51 @@
.TH EVIM 1 "2002 February 16"
.SH 名前
evim \- easy Vim, モードレスエディタ Vim
.SH 書式
.br
.B evim
[options] [file ..]
.br
.B eview
.SH 説明
.B eVim
は
.B Vim
を起動して、モードレスエディタとして動作するためのオプションを設定します。
Vim の動作が point-and-click エディタのような動作になります。
MS-Windows のメモ帳のような動作です。
.B eVim
は常に GUI で起動し、メニューとツールバーを表示します。
.PP
どうしても Vim の操作に馴染めない場合に使ってください。
編集効率は下がります。
.PP
.B eview
は同様に、読み込み専用モードで起動します。evim \-R と同じです。
.PP
引数や Vim についての詳細は vim(1) を参照してください。
.PP
オプション 'insertmode' が設定され、テキストを直接、入力できるようになりま
す。
.br
コピーとペーストのキー操作が MS-Windows と同じになるように、マップが設定され
ます。
CTRL-X が切り取り、CTRL-C がコピー、CTRL-V がペーストです。
標準の CTRL-V の操作は CTRL-Q に割り当てられます。
.SH オプション
vim(1) を参照してください。
.SH ファイル
.TP 15
/usr/local/lib/vim/evim.vim
eVim の初期化スクリプト。
.SH 別名
evim は "gumbies のための Vim" とも呼ばれています。
evim を使っているあなたはきっと、頭にハンカチをかぶっているのです。
(訳注: gumbies は Monty Python に登場するおもしろ集団。ハンカチをかぶっ
ている。)
.SH 関連項目
vim(1)
.SH 著者
.B Vim
のほとんどの機能は Bram Moolenaar が開発し、多くの人が協力しました。
メニューの Help/Credits を参照してください。

501
runtime/doc/vim-ja.UTF-8.1 Normal file
View File

@ -0,0 +1,501 @@
.TH VIM 1 "2006 Apr 11"
.SH 名前
vim \- Vi IMproved, プログラマのテキストエディタ
.SH 書式
.br
.B vim
[options] [file ..]
.br
.B vim
[options] \-
.br
.B vim
[options] \-t tag
.br
.B vim
[options] \-q [errorfile]
.PP
.br
.B ex
.br
.B view
.br
.B gvim
.B gview
.B evim
.B eview
.br
.B rvim
.B rview
.B rgvim
.B rgview
.SH 説明
.B Vim
は Vi 互換のテキストエディタです。
どのような種類のプレインテキストでも編集できます。
特に、プログラムの編集に力を発揮します。
.PP
Vi に多くの改良が加えられています:
多段アンドゥ、マルチウィンドウ、マルチバッファ、構文強調表示、
コマンドライン編集、ファイル名補完、ヘルプ、ビジュアル選択、などなど。
.B Vim
と Vi の違いについての要約は ":help vi_diff.txt" を参照してください。
.PP
.B Vim
の実行中は ":help" コマンドでヘルプを引くことができます。
下記、オンラインヘルプの項を参照してください。
.PP
.B Vim
は次のようなコマンドで起動できます。
.PP
vim file
.PP
正確な書式は次の通りです:
.PP
vim [options] [filelist]
.PP
filelist を省略した場合は、空のバッファが開かれます。
指定した場合は、以下の四つのうちどれか一つの方法でファイルが開かれます。
.TP 12
file ..
ファイルのリスト。
一番目のファイルがカレントファイルになり、バッファに読み込まれます。
カーソルは、バッファの一行目に置かれます。
他のファイルを表示するには ":next" コマンドを使ってください。
ファイル名がダッシュで始まるファイルを開く場合は、
filelist の前に "\-\-" を指定してください。
.TP
\-
ファイルは標準入力から読み込まれます。コマンドは標準エラー (ttyからの入
力になっているはず) から読み込まれます。
.TP
\-t {tag}
開くファイルとカーソルの初期位置は "tag" に依存します。goto label の一種です。
tags ファイルから {tag} が検索され、関連したファイルがカレントファイルになり
ます。そして、関連したコマンドが実行されます。
これは主に C 言語のファイルを開くときに使われます。その場合 {tag} に関数など
を指定して使います。
関数を含んでいるファイルが開かれ、その関数の先頭にカーソルが移動する、
という動作になります。
詳しくは ":help tag\-commands" を参照してください。
.TP
\-q [errorfile]
クイックフィックスモードで起動します。
[errorfile] に指定したファイルが読み込まれ、最初のエラーが表示されます。
[errorfile] を省略した場合は、オプション 'errorfile' が使われます (初期設定
は、Amiga では "AztecC.Err"、その他のシステムでは "errors.err" です)。
":cn" コマンドで次のエラーにジャンプできます。
詳しくは ":help quickfix" を参照してください。
.PP
.B Vim
は、起動されたときの実行ファイルの名前によって動作を変えます
(実行ファイルの実体が同じであっても)。
.TP 10
vim
"普通" に起動します。標準の状態です。
.TP
ex
Ex モードで起動します。
ノーマルモードに切り替えるには ":vi" コマンドを使ってください。
引数に "\-e" を指定した場合と同じです。
.TP
view
読み込み専用モードで起動します。ファイルの保存が制限されます。
引数に "\-R" を指定した場合と同じです。
.TP
gvim gview
GUI バージョン。
新しいウィンドウを開いて起動します。
引数に "\-g" を指定した場合と同じです。
.TP
evim eview
簡易モードの GUI バージョン。
新しいウィンドウを開いて起動します。
引数に "\-y" を指定した場合と同じです。
.TP
rvim rview rgvim rgview
上記と同じですが、制限モードで起動します。シェルコマンドを実行したり、
.B Vim
をサスペンドしたりできなくなります。
引数に "\-Z" を指定した場合と同じです。
.SH オプション
ファイル名の前でも後ろでも、好きな順番でオプションを指定できます。
パラメータを必要としない引数は、一つのダッシュにまとめて指定できます。
.TP 12
+[num]
一番目のファイルの "num" 行目にカーソルを移動します。
"num" を省略した場合は、一行目にカーソルが移動します。
.TP
+/{pat}
一番目のファイルの、最初に {pat} が見つかった行にカーソルが移動します。
検索パターンについては ":help search\-pattern" を参照してください。
.TP
+{command}
.TP
\-c {command}
一番目のファイルが読み込まれた後に {command} が実行されます。
{command} は Ex コマンドとして解釈されます。
{command} に空白を含める場合は、ダブルクォートで囲んでください (シェルに依存)。
例: vim "+set si" main.c
.br
Note: "+" と "\-c" は合わせて 10 個まで指定できます。
.TP
\-S {file}
一番目のファイルが読み込まれた後に {file} が実行されます。
これは \-c "source {file}" と同じ動作です。
{file} の先頭が '\-' の場合は使えません。
{file} が省略された場合は、"Session.vim" が使われます (ただし \-S が最後の引
数だった場合のみ)。
.TP
\-\-cmd {command}
"\-c" と同じですが、vimrc を処理する前にコマンドが実行されます。
これらのコマンドは "\-c" コマンドとは別に、10 個まで指定できます。
.TP
\-A
アラビア語がサポートされていて、アラビア語キーマップがある場合は、
アラビア語モードで起動します ('arabic' がオンになります)。
右横書きのファイルを編集できます。
サポートされていない場合はエラーメッセージを表示して終了します。
.TP
\-b
バイナリモード。
バイナリファイルを編集ためのオプションがいくつか設定されます。
.TP
\-C
互換モード。'compatible' オプションがオンになります。
.vimrc ファイルの有無に関わらず、
.B Vim
の動作が Vi 互換になります。
.TP
\-d
差分モードで起動します。
二つか三つの四つのファイルを引数に指定してください。
指定されたファイルが開かれ、それらのファイルの差分が表示されます。
vimdiff(1) と同様の動作です。
.TP
\-d {device}
{device} を端末として開きます。
Amiga でのみ使います。
例:
"\-d con:20/30/600/150".
.TP
\-D
デバッグ。スクリプトの最初のコマンドが実行されるところからデバッグモードを開
始します。
.TP
\-e
Ex モードで起動します。
実行ファイルの名前が "ex" の場合と同じです。
.TP
\-E
改良版 Ex モードで起動します。
実行ファイルの名前が "exim" の場合と同じです。
.TP
\-f
フォアグラウンド。GUI バージョンで、プロセスをフォークしなくなります。
Amiga の場合は、新しいウィンドウで再起動しなくなります。
メールソフトなどから
.B Vim
を起動して、編集が終わるまで待機したいような場合に使ってください。
Amiga では、":sh" と "!" コマンドは機能しなくなります。
.TP
\-\-nofork
フォアグラウンド。GUI バージョンで、プロセスをフォークしなくなります。
.TP
\-F
ペルシア語がサポートされていて、ペルシア語キーマップがある場合は、
ペルシア語モードで起動します ('fkmap' と 'rightleft' がオンになります)。
右横書きのファイルを編集できます。
サポートされていない場合はエラーメッセージを表示して終了します。
.TP
\-g
GUI がサポートされている場合は、GUI で起動します。
サポートされていない場合はエラーメッセージを表示して終了します。
.TP
\-h
コマンドライン引数やオプションのヘルプを表示して終了します。
.TP
\-H
ヘブライ語がサポートされていて、ヘブライ語キーマップがある場合は、
ヘブライ語モードで起動します ('hkmap' と 'rightleft' がオンになります)。
右横書きのファイルを編集できます。
サポートされていない場合はエラーメッセージを表示して終了します。
.TP
\-i {viminfo}
viminfo ファイルを使う設定になっている場合は、初期設定の "~/.viminfo" の代わ
りに、指定されたファイルを設定します。
"NONE" を指定すると、.viminfo ファイルを使わないように設定できます。
.TP
\-L
\-r と同じです。
.TP
\-l
lisp モード。
オプションの 'lisp' と 'showmatch' がオンになります。
.TP
\-m
ファイルの変更を不可能にします。
オプション 'write' がオフになります。
バッファを変更することはできますが、ファイルを保存することはできません。
.TP
\-M
変更を不可能にします。オプションの 'modifiable' と 'write' がオフになり、
ファイルの変更と保存ができなくなります。
Note: それらのオプションを設定すれば変更できるようになります。
.TP
\-N
非互換モード。'compatible' オプションがオフになります。
.vimrc ファイルの有無に関わらず、
.B Vim
の改良された機能が有効になります。Vi との互換性が少し失われます。
.TP
\-n
スワップファイルを使用しません。
クラッシュしてもリカバリできなくなります。
フロッピーディスクのような非常に低速なメディアのファイルを読み書きするときに
便利です。
":set uc=0" と設定しても同じです。
戻すには ":set uc=200" と設定してください。
.TP
\-nb
NetBeans と接続し、エディタサーバーになります。
詳しくはヘルプを参照してください。
.TP
\-o[N]
N 個のウィンドウを水平分割で開きます。
N を省略した場合は、引数のファイルを個別のウィンドウで開きます。
.TP
\-O[N]
N 個のウィンドウを垂直分割で開きます。
N を省略した場合は、引数のファイルを個別のウィンドウで開きます。
.TP
\-p[N]
N 個のタブページを開きます。
N を省略した場合は、引数のファイルを個別のタブページで開きます。
.TP
\-R
読み込み専用モード。
オプション 'readonly' がオンになります。
バッファを変更することはできますが、間違ってファイルを上書きしてしまうのを防
ぐことができます。
ファイルを保存したい場合は、":w!" のように、Ex コマンドに感嘆符を付けてくだ
さい。
\-R オプションは \-n オプションの効果も含んでいます (下記参照)。
オプション 'readonly' は ":set noro" でオフにできます。
詳しくは ":help 'readonly'" を参照してください。
.TP
\-r
スワップファイルの一覧を表示します。リカバリに関する情報も表示されます。
.TP
\-r {file}
リカバリモード。
スワップファイルを使って、クラッシュした編集セッションを復活させます。
スワップファイルは、ファイル名に ".swp" を加えた名前のファイルです。
詳しくは ":help recovery" を参照してください。
.TP
\-s
サイレントモード。"ex" という名前で起動するか、"\-e" オプションの後で
"\-s" オプションが指定された場合のみ。
.TP
\-s {scriptin}
{scriptin} をスクリプトファイルとして読み込まれます。
ファイル中の文字列は、手で入力したときと同じように処理されます。
これは ":source! {scriptin}" と同じ動作です。
エディタが終了する前にファイルの終わりまで読み込んだ場合、
それ以降はキーボードから入力を読み込みます。
.TP
\-T {terminal}
端末の名前を指定します。
端末が自動的に認識されない場合に使ってください。
Vim が組み込みでサポートしている名前か、
termcap または terminfo ファイルで定義されている名前を指定してください。
.TP
\-u {vimrc}
{vimrc} ファイルを使って初期化します。
他の初期化処理はスキップされます。
特殊なファイルを編集する場合などに使ってください。
すべての初期化をスキップするには "NONE" を指定してください。
詳しくは ":help initialization" を参照してください。
.TP
\-U {gvimrc}
{gvimrc} ファイルを使って GUI を初期化します。
他の GUI の初期化はスキップされます。
すべての GUI の初期化をスキップするには "NONE" を指定してください。
詳しくは ":help gui\-init" を参照してください。
.TP
\-V[N]
冗長モード。スクリプトファイルを実行したり viminfo ファイルを読み書きするた
びにメッセージを表示します。N に指定した数値が 'verbose' に設定されます。
省略した場合は 10 になります。
.TP
\-v
Vi モードで起動します。
実行ファイルの名前が "vi" の場合と同じです。
実行ファイルの名前が "ex" の場合だけ効果があります。
.TP
\-w {scriptout}
入力した文字を {scriptout} に記録します。
"vim \-s" や "source!" で実行するためのスクリプトファイルを作成するのに便利
です。
{scriptout} ファイルがすでに存在した場合は追加保存されます。
.TP
\-W {scriptout}
\-w と同じですが、ファイルがすでに存在した場合は上書きされます。
.TP
\-x
ファイルを暗号化して書き込みます。暗号化キーの入力プロンプトが表示されます。
.TP
\-X
X サーバーと通信しません。端末での起動時間を短くできます。
しかし、ウィンドウタイトルの変更やクリップボードは使えなくなります。
.TP
\-y
簡易モードで起動します。
実行ファイルの名前が "evim" や "eview" の場合と同じです。
.B Vim
の動作がモードレスエディタ (click-and-type editor) のようになります。
.TP
\-Z
制限モード。
実行ファイルの名前が "r" で始まっている場合と同じです。
.TP
\-\-
オプション指定の末尾を示す記号です。
これ以降の引数はすべてファイル名として扱われます。
ファイル名が '\-' で始まっているファイルを開くときに使ってください。
.TP
\-\-echo\-wid
GTK GUI のみ: Window ID を標準出力に出力します。
.TP
\-\-help
ヘルプを表示して終了します。"\-h" と同じです。
.TP
\-\-literal
引数のファイル名をリテラル文字列として扱います。ワイルドカードを展開しませ
ん。Unix のように、シェルがワイルドカードを展開する場合は機能しません。
.TP
\-\-noplugin
プラグインをロードしません。\-u NONE はこの動作を含んでいます。
.TP
\-\-remote
Vim サーバーと通信し、引数に指定されたファイルを Vim サーバーで開きます。
サーバーが存在しない場合は、エラーメッセージを表示され、起動中の Vim でファ
イルが開かれます。
.TP
\-\-remote\-expr {expr}
Vim サーバーと通信し、{expr} に与えられた式を Vim サーバーで実行し、結果を標
準出力に出力します。
.TP
\-\-remote\-send {keys}
Vim サーバーと通信し、{keys} に与えられたキーを Vim サーバーに送信します。
.TP
\-\-remote\-silent
\-\-remote と同じですが、サーバーが存在しなくてもエラーメッセージを表示しま
せん。
.TP
\-\-remote\-wait
\-\-remote と同じですが、ファイルが開かれるのを確認できるまで待機します。
.TP
\-\-remote\-wait\-silent
\-\-remote\-wait と同じですが、サーバーが存在しなくてもエラーメッセージを表
示しません。
.TP
\-\-serverlist
Vim サーバーの一覧を表示します。
.TP
\-\-servername {name}
サーバーの名前を {name} に設定します。\-\-remote 引数を指定しなかった場合
は、起動中の Vim の名前として使われるので、後からその名前を使ってサーバー通
信できます。
.TP
\-\-socketid {id}
GTK GUI のみ: GtkPlug メカニズムを使って gvim を別のウィンドウの中で実行しま
す。
.TP
\-\-version
バージョン情報を表示して終了します。
.SH オンラインヘルプ
ヘルプを開くには、
.B Vim
の中で ":help" と入力してください。
":help 調べたい項目" と入力すれば、指定した項目のヘルプが表示されます。
例: "ZZ" コマンドのヘルプを表示するには ":help ZZ" と入力します。
<Tab> や CTRL\-D を使って補完することもできます
(":help cmdline\-completion" 参照)。
ヘルプには、項目から項目へジャンプできるようにタグが埋め込まれています
(ハイパーリンクのようなものです。":help" 参照)。
すべてのヘルプファイルはこの方法で開くことができます。
例: ":help syntax.txt"。
.SH ファイル
.TP 15
/usr/local/lib/vim/doc/*.txt
.B Vim
のヘルプファイル。
ファイルの一覧は ":help doc\-file\-list" に記載されています。
.TP
/usr/local/lib/vim/doc/tags
ヘルプを検索するための tags ファイル。
.TP
/usr/local/lib/vim/syntax/syntax.vim
システムの構文定義初期化ファイル。
.TP
/usr/local/lib/vim/syntax/*.vim
いろいろな言語用の構文定義ファイル。
.TP
/usr/local/lib/vim/vimrc
システムの
.B Vim
初期化ファイル。
.TP
~/.vimrc
ユーザーの
.B Vim
初期化ファイル。
.TP
/usr/local/lib/vim/gvimrc
システムの gvim 初期化ファイル。
.TP
~/.gvimrc
ユーザーの gvim 初期化ファイル。
.TP
/usr/local/lib/vim/optwin.vim
":options" コマンドで使われるファイル。オプションを表示したり設定したりでき
ます。
.TP
/usr/local/lib/vim/menu.vim
システムのメニュー初期化ファイル。gvim で使います。
.TP
/usr/local/lib/vim/bugreport.vim
バグレポートを生成するスクリプト。":help bugs" 参照。
.TP
/usr/local/lib/vim/filetype.vim
ファイル名からファイルタイプを判定するスクリプト。":help 'filetype'" 参照。
.TP
/usr/local/lib/vim/scripts.vim
ファイルの内容からファイルタイプを判定するスクリプト。":help 'filetype'" 参照。
.TP
/usr/local/lib/vim/print/*.ps
PostScript 印刷に使われるファイル。
.PP
最新の情報は VIM のホームページを参照してください:
.br
<URL:http://www.vim.org/>
.SH 関連項目
vimtutor(1)
.SH 著者
.B Vim
のほとんどの機能は Bram Moolenaar が開発し、多くの人が協力しました。
":help credits" を参照してください。
.br
.B Vim
は Stevie を基にしています。Stevie は Tim Thompson、Tony Andrews、
G.R. (Fred) Walter によって開発されました。
ただし、オリジナルのコードはもうほとんど残っていません。
.SH バグ
既知のバグは ":help todo" に記載されています。
.PP
Vi の動作を忠実に再現した結果、多くの人がバグだと思うような機能もいくつかあ
ります。
"この動作は Vi と違う" からバグだと思った場合は、vi_diff.txtを確認してみてく
ださい (ファイルを開くか、Vim から ":help vi_diff.txt" と入力)。
オプションの 'compatible' と 'cpoptions' も確認してください。

44
runtime/doc/vimdiff-ja.UTF-8.1 Normal file
View File

@ -0,0 +1,44 @@
.TH VIMDIFF 1 "2001 March 30"
.SH 名前
vimdiff \- 二つか三つか四つのファイルを Vim で開いて、その差分を表示する
.SH 書式
.br
.B vimdiff
[options] file1 file2 [file3 [file4]]
.PP
.B gvimdiff
.SH 説明
.B Vimdiff
は、二つ (か三つか四つ) のファイルを
.B Vim
で開きます。
ファイルは個別のウィンドウで開かれ、差分が強調表示されます。
同じファイルの別のバージョン間で、変更を確認したり、変更を移動したりするのが
簡単になります。
.PP
Vim についての詳細は vim(1) を参照してください。
.PP
.B gvimdiff
という名前で起動された場合は GUI で起動します。
.PP
差分を強調表示するために、
それぞれのウィンドウの 'diff' オプションがオンに設定されます。
.br
テキストを見やすくするために、オプションの 'wrap' と 'scrollbind' もオンに設
定されます。
.br
'foldmethod' オプションは "diff" に設定され、変更されていない行は折り畳まれ
ます。
折り畳みの確認と開閉が簡単にできるように、'foldcolumn' は 2 に設定されます。
.SH オプション
行を並べて表示するために、"\-O" 引数を使ったときのように、ウィンドウは垂直分
割されます。
ウィンドウを水平分割したい場合は "\-o" 引数を使ってください。
.PP
その他の引数については vim(1) を参照してください。
.SH 関連項目
vim(1)
.SH 著者
.B Vim
のほとんどの機能は Bram Moolenaar が開発し、多くの人が協力しました。
":help credits" を参照してください。

45
runtime/doc/vimtutor-ja.UTF-8.1 Normal file
View File

@ -0,0 +1,45 @@
.TH VIMTUTOR 1 "2001 April 2"
.SH 名前
vimtutor \- Vim チュートリアル
.SH 書式
.br
.B vimtutor [\-g] [language]
.SH 説明
.B Vim
のチュートリアルを起動します。
演習ファイルのコピーを使って実施するので、オリジナルの演習ファイルを壊してし
まう心配はありません。
.PP
.B Vim
を初めて学ぶ人向けのチュートリアルです。
.PP
引数に \-g を指定すると GUI 版の vim が利用可能であれば vim ではなく gvim を
使って vimtutor が開始します。gvim が見つからないときは Vim が使用されます。
.PP
[language] 引数は "ja" や "es" などの二文字の言語名です。
[language] 引数を省略した場合はロケールの言語が使われます。
翻訳された演習ファイルがある場合は、そのファイルが使われます。
ない場合は英語のファイルが使われます。
.PP
.B Vim
は Vi 互換モードで起動されます。
.SH ファイル
.TP 15
/usr/local/lib/vim/tutor/tutor[.language]
.B Vimtutor
の演習ファイル。
.TP 15
/usr/local/lib/vim/tutor/tutor.vim
演習ファイルをコピーするための Vim スクリプト。
.SH 著者
.B Vimtutor
は、Colorado State University の Charles Smith のアイデアを基に、
Colorado School of Mines の Michael C. Pierce と Robert K. Ware の両名
によって Vi 向けに作成されたものを基にしています。
E-mail: bware@mines.colorado.edu.
.br
.B Vim
に合わせて Bram Moolenaar が変更を加えました。
翻訳者の名前は演習ファイルを参照してください。
.SH 関連項目
vim(1)

366
runtime/doc/xxd-ja.UTF-8.1 Normal file
View File

@ -0,0 +1,366 @@
.TH XXD 1 "August 1996" "Manual page for xxd"
.\"
.\" 21st May 1996
.\" Man page author:
.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
.\" Changes by Bram Moolenaar <Bram@vim.org>
.SH 名前
.I xxd
\- 16 進ダンプを作成したり、元に戻したり。
.SH 書式
.B xxd
\-h[elp]
.br
.B xxd
[options] [infile [outfile]]
.br
.B xxd
\-r[evert] [options] [infile [outfile]]
.SH 説明
ファイルや標準入力から 16 進ダンプを作成します。
16 進ダンプから元のバイナリに戻すこともできます。
.BR uuencode (1)
や
.BR uudecode (1)
のように、バイナリデータを、メールに貼り付け可能な ASCII 形式に変換できた
り、標準出力に出力することもできます。
さらに、バイナリファイルにパッチを当てるという使い方もできます。
.SH オプション
.I infile
を指定しなかった場合は、標準入力が読み込まれます。
.I infile
に
.RB \` \- '
を指定した場合も、標準入力から読み込まれます。
.I outfile
を指定しなかった (または
.RB \` \- '
を指定した) 場合は、標準出力に出力されます。
.PP
引数の解釈処理は適当なので注意してください。パラメータを取らない引数は
最初の一文字だけチェックされます。
引数の文字とパラメータの間のスペースは省略可能です。
パラメータは 10 進数、16 進数、8 進数で指定できます。
.BR \-c8
、
.BR "\-c 8"
、
.B \-c 010
、
.B \-cols 8
はすべて同じ意味です。
.PP
.TP
.IR \-a " | " \-autoskip
オートスキップ: 連続した nul 行を一つの '*' で置き換える。
.TP
.IR \-b " | " \-bits
ビット (2進数) ダンプ。
1 オクテットが "1" と "0" の 8 文字で出力されます。
各行の行頭には 16 進数の行番号が表示されます。
行末には ascii (または ebcdic) で表した場合の文字が表示されます。
このモードでは \-r、\-p、\-i は機能しません。
.TP
.IR "\-c cols " | " \-cols cols"
一行
.RI < cols >
オクテットで出力する。標準設定は 16 (\-i: 12, \-ps: 30, \-b: 6)。最大 256。
.TP
.IR \-E " | " \-EBCDIC
右端に出力される文字のエンコーディングを ASCII から EBCDIC に変更する。
16 進ダンプの出力形式は変更されません。
\-r、\-p、\-i が同時に指定された場合は何の効果もありません。
.TP
.IR "\-g bytes " | " \-groupsize bytes"
出力を
.RI < bytes >
バイト (2 文字の 16 進数、または 8 文字の 2 進数) ごとにスペースで区切りま
す。
区切らずに出力するには
.I \-g 0
を指定してください。
.RI < Bytes >
の標準設定は \fI2\fP です。2 進ダンプの場合は \fI1\fP です。
ポストスクリプト形式やインクルード形式で出力するときは、このオプションは使わ
れません。
.TP
.IR \-h " | " \-help
コマンドの説明を出力して終了する。変換は実行されません。
.TP
.IR \-i " | " \-include
C インクルードファイル形式で出力します。入力ファイルの名前が付けられた静的配
列の定義が出力されます。標準入力の場合は定義の中身だけ出力されます。
.TP
.IR "\-l len " | " \-len len"
.RI < len >
オクテットだけ出力する。
.TP
.IR \-p " | " \-ps " | " \-postscript " | " \-plain
ポストスクリプト形式の 16 進ダンプを出力する。別名 プレーン 16 進ダンプ。
.TP
.IR \-r " | " \-revert
元に戻す: 16 進ダンプからバイナリ形式に変換 (またはパッチ) します。
ファイルへ出力する場合、出力先のファイルは切り詰めされません。
行番号や特定の書式がないプレーン 16 進ダンプを読み込む場合は、
.I \-r \-p
を指定してください。空白と改行は無視されます。
.TP
.I \-seek offset
.IR \-r
の後で使われた場合: 16 進ダンプを出力するファイルの位置に
.RI < offset >
を加える。
.TP
.I \-s [+][\-]seek
infile の
.RI < seek >
バイト目 (絶対位置、または相対位置) から開始する。
\fI+ \fRは、現在の標準入力の位置から相対的な位置を示します
(標準入力から読み込むときのみ意味があります)。\fI\- \fRは、入力の終わりから
の文字数を示します (\fI+\fR と同時に指定した場合は、現在の標準入力の位置から
手前の位置を示します)。
\-s 引数を指定しなかった場合は、現在のファイル位置から開始されます。
.TP
.I \-u
16 進数の表記に大文字を使います。指定がない場合は小文字で出力されます。
.TP
.IR \-v " | " \-version
バージョンを表示します。
.SH 警告
.PP
.I xxd \-r
では行番号の評価に関しての暗黙のルールがいくつかあります。
出力ファイルがシーク可能なら、各行の行番号が順番通りに並んでなくても構いませ
ん。位置が飛んでいても重なっていても大丈夫です。その場合、次の位置に移動する
ために lseek(2) が使われます。
出力ファイルがシーク不可なら、「隙間」だけが処理可能です。隙間は null バイト
で埋められます。
.PP
.I xxd \-r
は不正な入力をエラーにしません。ゴミは静かに読み飛ばされます。
.PP
16 進ダンプを編集するときは注意が必要です。
.I xxd \-r
は必要な桁 (\-c 引数参照) だけ 16 進データを読み込んで、行の残りを無視しま
す。つまり、ascii (または ebcdic) を示している列への変更は無視されます。
xxd \-r \-p でプレーン形式 (ポストスクリプト形式) の 16 進ダンプを元に戻す場
合は、列の数は影響しません。
2 桁の 16 進数と認識できるものはすべて変換されます。
.PP
\fI% xxd \-i file\fR
.br
と
.br
\fI% xxd \-i < file\fR
.br
の結果は違います。注意してください。
.PP
.I xxd \-s +seek
と
.IR "xxd \-s seek" ,
の違いは、lseek(2) を使って入力を "巻き戻す" かどうかです。'+' が意味を持つ
のは、入力が標準入力で、xxd が起動されたときに標準入力のファイル位置がファイ
ルの先頭ではなかった場合です。
以下の例が分かりやすいかもしれません (もっと混乱するかも!)...
.PP
`cat' が既に標準入力を終わりまで読んでいるので、読む前に標準入力を巻き戻す必
要がある。
.br
\fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR
.PP
ファイル位置 0x480 (=1024+128) 前方から 16 進ダンプする。
`+' は 「現在地からの相対位置」を意味するので、dd が 1k 処理した後から、さら
に `128' 進めます。
.br
\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet" < file\fR
.PP
ファイル位置 0x100 ( = 1024\-768) から 16 進ダンプする。
.br
\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 > hex_snippet" < file\fR
.PP
このような使い方はあまりしませんし、`+' を使うこともほとんどないでしょう。
\-s を使うときはいつでも、strace(1) や truss(1) を使って、xxd の働きをチェッ
クすることをお勧めします。
.SH 例
.PP
.br
.BR ファイル
の最初の三行 (16 進数で 0x30 バイト) 以降を出力する。
.br
\fI% xxd \-s 0x30 file\fR
.PP
.br
.BR ファイル
の最後から三行 (16 進数で 0x30 バイト) を出力する。
.br
\fI% xxd \-s \-0x30 file\fR
.PP
.br
120 バイトを、平文 16 進ダンプ形式で一行に 20 オクテットずつ出力する。
.br
\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR
.br
2e54482058584420312022417567757374203139
.br
39362220224d616e75616c207061676520666f72
.br
20787864220a2e5c220a2e5c222032317374204d
.br
617920313939360a2e5c22204d616e2070616765
.br
20617574686f723a0a2e5c2220202020546f6e79
.br
204e7567656e74203c746f6e79407363746e7567
.br
.br
この man ページの先頭から 120 バイトを一行に 12 オクテットずつ 16 進ダンプす
る。
.br
\fI% xxd \-l 120 \-c 12 xxd.1\fR
.br
0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A
.br
000000c: 7567 7573 7420 3139 3936 2220 ugust 1996"
.br
0000018: 224d 616e 7561 6c20 7061 6765 "Manual page
.br
0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\\
.br
0000030: 220a 2e5c 2220 3231 7374 204d "..\\" 21st M
.br
000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\\"
.br
0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut
.br
0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\\"
.br
0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent
.br
000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug
.PP
.br
xxd.1 の日付部分だけを出力する。
.br
\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
.br
0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996
.PP
.br
.B input_file
を
.B output_file
にコピーし、先頭に 0x00 を 100 バイト分付け加える。
.br
\fI% xxd input_file | xxd \-r \-s 100 > output_file\fR
.br
.br
xxd.1 の日付を修正する。
.br
\fI% echo "0000037: 3574 68" | xxd \-r \- xxd.1\fR
.br
\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
.br
0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996
.PP
.br
中身がすべて 0x00 の 65537 バイトのファイルを作成する。
ただし、最後のバイトだけは 'A' (hex 0x41)。
.br
\fI% echo "010000: 41" | xxd \-r > file\fR
.PP
.br
作成したファイルをオートスキップを使って 16 進ダンプする。
.br
\fI% xxd \-a \-c 12 file\fR
.br
0000000: 0000 0000 0000 0000 0000 0000 ............
.br
*
.br
000fffc: 0000 0000 40 ....A
.PP
一文字の 'A' からなる 1 バイトのファイルを作成する。
'\-r \-s' の後に指定した数値がファイル中の行番号に加算され、結果、余計なバ
イトが飛ばされる。
.br
\fI% echo "010000: 41" | xxd \-r \-s \-0x10000 > file\fR
.PP
.B vim(1)
の中から xxd をフィルタとして実行し、
マークされた `a' から `z' までの領域を 16 進ダンプする。
.br
\fI:'a,'z!xxd\fR
.PP
.B vim(1)
の中から xxd をフィルタとして実行し、
マークされた `a' から `z' までの領域をバイナリに戻す。
.br
\fI:'a,'z!xxd \-r\fR
.PP
.B vim(1)
の中から xxd をフィルタとして実行し、
16 進ダンプされた行を元に戻す。戻したい行にカーソルを移動して:
.br
\fI!!xxd \-r\fR
.PP
シリアル行から一文字読み込む
.br
\fI% xxd \-c1 < /dev/term/b &\fR
.br
\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR
.br
\fI% echo \-n foo > /dev/term/b\fR
.PP
.SH 返り値
以下のエラー値が返ります:
.TP
0
エラーなし。
.TP
\-1
操作がサポートされていない (
.I xxd \-r \-i
はまだ不可です)。
.TP
1
引数の解釈に関するエラー。
.TP
2
入力ファイルに関する問題。
.TP
3
出力ファイルに関する問題。
.TP
4,5
指定された位置へシークできなかった。
.SH 関連項目
uuencode(1), uudecode(1), patch(1)
.br
.SH 警告
この奇妙なツールは作者が使いやすいように作られています。
自己責任で使ってください。ファイルをコピーし、それを調べ、ウィザードたれ。
.br
.SH バージョン
このマニュアルは xxd バージョン 1.7 について説明しています。
.SH 著者
.br
(c) 1990-1997 by Juergen Weigert
.br
<jnweiger@informatik.uni\-erlangen.de>
.LP
私の功績として自由に配布してください。
.br
儲かったら教えてください。
.br
損しても知りません。
.PP
マニュアルは Tony Nugent
.br
<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
.br
によって書かれ、
Bram Moolenaar が少し変更を加え、
Juergen Weigert が編集しました。
.PP

9
src/Makefile
View File

@ -1401,6 +1401,7 @@ DEST_MAN_FR_U = $(DEST_MAN_TOP)/fr.UTF-8$(MAN1DIR)
DEST_MAN_IT = $(DEST_MAN_TOP)/it$(MAN1DIR)
DEST_MAN_IT_I = $(DEST_MAN_TOP)/it.ISO8859-1$(MAN1DIR)
DEST_MAN_IT_U = $(DEST_MAN_TOP)/it.UTF-8$(MAN1DIR)
DEST_MAN_JA_U = $(DEST_MAN_TOP)/ja.UTF-8$(MAN1DIR)
DEST_MAN_PL = $(DEST_MAN_TOP)/pl$(MAN1DIR)
DEST_MAN_PL_I = $(DEST_MAN_TOP)/pl.ISO8859-2$(MAN1DIR)
DEST_MAN_PL_U = $(DEST_MAN_TOP)/pl.UTF-8$(MAN1DIR)
@ -2085,6 +2086,7 @@ install-tool-languages:
-$(SHELL) ./installman.sh xxd $(DEST_MAN_IT) "-it" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh xxd $(DEST_MAN_IT_I) "-it" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh xxd $(DEST_MAN_IT_U) "-it.UTF-8" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh xxd $(DEST_MAN_JA_U) "-ja.UTF-8" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh xxd $(DEST_MAN_PL) "-pl" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh xxd $(DEST_MAN_PL_I) "-pl" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh xxd $(DEST_MAN_PL_U) "-pl.UTF-8" $(INSTALLMANARGS)
@ -2099,6 +2101,7 @@ install-languages: languages $(DEST_LANG) $(DEST_KMAP)
-$(SHELL) ./installman.sh install $(DEST_MAN_IT) "-it" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh install $(DEST_MAN_IT_I) "-it" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh install $(DEST_MAN_IT_U) "-it.UTF-8" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh install $(DEST_MAN_JA_U) "-ja.UTF-8" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh install $(DEST_MAN_PL) "-pl" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh install $(DEST_MAN_PL_I) "-pl" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh install $(DEST_MAN_PL_U) "-pl.UTF-8" $(INSTALLMANARGS)
@ -2116,6 +2119,8 @@ install-languages: languages $(DEST_LANG) $(DEST_KMAP)
$(DEST_MAN_IT_I) $(INSTALLMLARGS)
-$(SHELL) ./installml.sh install "$(GUI_MAN_TARGETS)" \
$(DEST_MAN_IT_U) $(INSTALLMLARGS)
-$(SHELL) ./installml.sh install "$(GUI_MAN_TARGETS)" \
$(DEST_MAN_JA_U) $(INSTALLMLARGS)
-$(SHELL) ./installml.sh install "$(GUI_MAN_TARGETS)" \
$(DEST_MAN_PL) $(INSTALLMLARGS)
-$(SHELL) ./installml.sh install "$(GUI_MAN_TARGETS)" \
@ -2262,6 +2267,7 @@ uninstall_runtime:
-$(SHELL) ./installman.sh uninstall $(DEST_MAN_IT) "" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh uninstall $(DEST_MAN_IT_I) "" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh uninstall $(DEST_MAN_IT_U) "" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh uninstall $(DEST_MAN_JA_U) "" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh uninstall $(DEST_MAN_PL) "" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh uninstall $(DEST_MAN_PL_I) "" $(INSTALLMANARGS)
-$(SHELL) ./installman.sh uninstall $(DEST_MAN_PL_U) "" $(INSTALLMANARGS)
@ -2281,6 +2287,8 @@ uninstall_runtime:
$(DEST_MAN_IT_I) $(INSTALLMLARGS)
-$(SHELL) ./installml.sh uninstall "$(GUI_MAN_TARGETS)" \
$(DEST_MAN_IT_U) $(INSTALLMLARGS)
-$(SHELL) ./installml.sh uninstall "$(GUI_MAN_TARGETS)" \
$(DEST_MAN_JA_U) $(INSTALLMLARGS)
-$(SHELL) ./installml.sh uninstall "$(GUI_MAN_TARGETS)" \
$(DEST_MAN_PL) $(INSTALLMLARGS)
-$(SHELL) ./installml.sh uninstall "$(GUI_MAN_TARGETS)" \
@ -2294,6 +2302,7 @@ uninstall_runtime:
-rm -f $(DEST_MAN)/xxd.1
-rm -f $(DEST_MAN_FR)/xxd.1 $(DEST_MAN_FR_I)/xxd.1 $(DEST_MAN_FR_U)/xxd.1
-rm -f $(DEST_MAN_IT)/xxd.1 $(DEST_MAN_IT_I)/xxd.1 $(DEST_MAN_IT_U)/xxd.1
-rm -f $(DEST_MAN_JA_U)/xxd.1
-rm -f $(DEST_MAN_PL)/xxd.1 $(DEST_MAN_PL_I)/xxd.1 $(DEST_MAN_PL_U)/xxd.1
-rm -f $(DEST_MAN_RU)/xxd.1 $(DEST_MAN_RU_U)/xxd.1
-rm -f $(DEST_HELP)/*.txt $(DEST_HELP)/tags $(DEST_HELP)/*.pl

2
src/version.c
View File

@ -727,6 +727,8 @@ static char *(features[]) =
static int included_patches[] =
{ /* Add new patch number below this line */
/**/
15,
/**/
14,
/**/