convert to UTF-8 encoding.

fiber.txt

@@ -1,11 +1,10 @@
-;; -*- Mode: text ; Coding: iso-2022-jp -*-
 
 ; English document follows after Japanese document.
 
 
     File Inspect and Broking End Resolver  -- fiber --
 
-             Copyright (C) 1997-2004 Shuichi Kitaguchi <kit@meadowy.org>
+             Copyright (C) 1997-2021 Shuichi Kitaguchi <kit@ysnb.net>
 
 
 COPYRIGHT
@@ -29,156 +28,156 @@ MA 02111-1307, USA.
 
 ======================== JAPANESE DOCUMENT ========================
 
-$B$3$l$O2?$r$9$k$b$N(B?
+これは何をするもの?
 -------------------
 
-  fiber $B$OBg$-$/$o$1$F(B 2 $B$D$N5!G=$r;}$C$F$$$^$9(B
+  fiber は大きくわけて 2 つの機能を持っています
 
- o $B%U%!%$%k$NCf?H$rD4$Y$F$=$N<oN`$r7hDj$9$k(B
- o Windows $B$N!V4XO"IU$1!W$rMQ$$$F%U%!%$%k$r<B9T$9$k(B
+ o ファイルの中身を調べてその種類を決定する
+ o Windows の「関連付け」を用いてファイルを実行する
 
-  $BNc$($P!"(Bfoo_file $B$H$$$&Cf?H$,(B JPEG $B$N%U%!%$%k$,$"$C$?$H$7$^$9!#(B
+  例えば、foo_file という中身が JPEG のファイルがあったとします。
 
   > fiber foo_file
 
-  $B$H$9$k$H!"(Bfiber $B$O(B foo_file $B$r(B foo_file.jpg $B$K%3%T!<$7$?8e!"(B
-  foo_file.jpg $B$K4XO"IU$1$i$l$?%"%W%j%1!<%7%g%s$r<B9T$7$^$9(B($B8e$K$O(B
-  foo_file.jpg $B$H$$$&%U%!%$%k$,;D$j$^$9(B)$B!#(B
+  とすると、fiber は foo_file を foo_file.jpg にコピーした後、
+  foo_file.jpg に関連付けられたアプリケーションを実行します(後には
+  foo_file.jpg というファイルが残ります)。
 
-  $B$D$^$j3HD%;R$,IU$$$F$$$J$$!"$b$7$/$O2?$J$N$+$o$+$i$J$$%U%!%$%k$b(B 
-  fiber $B$r;H$($PE,@Z$J%"%W%j%1!<%7%g%s$G<B9T$G$-$k$o$1$G$9!#$b$A$m$s(B
-  fiber $B$bK|G=$G$O$J$$$N$G!"BP1~$G$-$F$$$J$$%U%!%$%k7A<0$O;3$[$I$"$j$^(B
-  $B$9$,(B($B8B$i$l$?$b$N$7$+BP1~$7$F$J$$$H$b8@$&(B)$B!#(B
+  つまり拡張子が付いていない、もしくは何なのかわからないファイルも 
+  fiber を使えば適切なアプリケーションで実行できるわけです。もちろん
+  fiber も万能ではないので、対応できていないファイル形式は山ほどありま
+  すが(限られたものしか対応してないとも言う)。
 
 
-$B;H$$J}(B
+使い方
 ------
 
-   > fiber [$B%*%W%7%g%s(B] <$B%U%!%$%k(B>
+   > fiber [オプション] <ファイル>
 
-  $B%*%W%7%g%s(B:
-      -e ext                  $B3HD%;R$r(B "ext" $B$@$H$_$J$9(B
-      -s                      $BF14|%b!<%I(B
-      -a ext=ident(,offset)   $B3HD%;R%G!<%?$r%l%8%9%H%j$KDI2C(B
-      -l                      $B@_Dj$H3HD%;R$N0lMwI=<((B
-      -r num                  $B3HD%;R%G!<%?$r%l%8%9%H%j$+$i:o=|(B
-      -i                      $B%l%8%9%H%j$N%G!<%?$r=i4|CM$KLa$9(B
-      -o Option={num,yes/no}  $B@_Dj%*%W%7%g%s(B
+  オプション:
+      -e ext                  拡張子を "ext" だとみなす
+      -s                      同期モード
+      -a ext=ident(,offset)   拡張子データをレジストリに追加
+      -l                      設定と拡張子の一覧表示
+      -r num                  拡張子データをレジストリから削除
+      -i                      レジストリのデータを初期値に戻す
+      -o Option={num,yes/no}  設定オプション
 
-      $B@_Dj%*%W%7%g%s(B    |  $B@bL@(B ($B=i4|CM(B)
+      設定オプション    |  説明 (初期値)
      -------------------+----------------------------------------------------
-      ExtNum            |  fiber $B$,%5%]!<%H$9$k3HD%;R$N:GBgCM(B (64)
-      ExecuteUnknownExt |  $B%l%8%9%H%j$KEPO?$5$l$F$J$$3HD%;R$r<B9T$9$k(B (yes)
-      ExecuteURL        |  URL(ftp:,http:,...)$B$r<B9T$9$k(B (yes)
-      TrustExt          |  fiber $B$,H=CG$7$?$b$N$H%U%!%$%kL>$N3HD%;R$,0[$J$C$F(B
-                        |  $B$$$?>l9g!"%U%!%$%kL>$N3HD%;R$r?.MQ$9$k(B (yes)
-      OverrideExt       |  fiber $B$,CN$i$J$$3HD%;R$G$"$C$?>l9g!"(Bfiber $B$,H=CG(B
-                        |  $B$7$?3HD%;R$G>e=q$-$7$F<B9T$9$k(B (no)
-
-  $B%U%!%$%k(B:
-        $B!&3HD%;R$J$7%U%!%$%kL>(B
-        $B!&(BWindows $B$G4XO"IU$1$i$l$F$$$k!"3HD%;RIU$-%U%!%$%kL>(B
-        $B!&(BURL(http://..., ftp://...)
+      ExtNum            |  fiber がサポートする拡張子の最大値 (64)
+      ExecuteUnknownExt |  レジストリに登録されてない拡張子を実行する (yes)
+      ExecuteURL        |  URL(ftp:,http:,...)を実行する (yes)
+      TrustExt          |  fiber が判断したものとファイル名の拡張子が異なって
+                        |  いた場合、ファイル名の拡張子を信用する (yes)
+      OverrideExt       |  fiber が知らない拡張子であった場合、fiber が判断
+                        |  した拡張子で上書きして実行する (no)
+
+  ファイル:
+        ・拡張子なしファイル名
+        ・Windows で関連付けられている、拡張子付きファイル名
+        ・URL(http://..., ftp://...)
 
 
-$B<B9TNc(B
+実行例
 ------
 
-1. $B3HD%;R$N;XDj(B (-e)
+1. 拡張子の指定 (-e)
 
     > fiber -e jpg foo.dat
 
-  $B$H$9$k$H!"(Bfiber $B$O(B foo.dat $B$,(B JPEG $B%U%!%$%k$G$"$k$H9M$(!"(Bfoo.dat $B$r(B 
-  foo.dat.jpg $B$K%3%T!<$7$?8e!"(Bfoo.dat.jpg $B$r<B9T$7$^$9(B
+  とすると、fiber は foo.dat が JPEG ファイルであると考え、foo.dat を 
+  foo.dat.jpg にコピーした後、foo.dat.jpg を実行します
 
 
-2. $BF14|%b!<%I(B (-s)
+2. 同期モード (-s)
 
-  ($BNc(B1) $BDL>o$N>l9g(B
+  (例1) 通常の場合
 
     > fiber foo.jpg
 
-    $B$9$0$K%W%m%s%W%H$KLa$C$F$-$^$9(B
+    すぐにプロンプトに戻ってきます
 
-  ($BNc(B2) -s $B%*%W%7%g%sIU$-$N>l9g(B
+  (例2) -s オプション付きの場合
 
     > fiber -s foo
 
-     foo $B$r(B foo.ext $B$K%3%T!<$7$?8e!"<B9T$7$F$$$k%"%W%j%1!<%7%g%s$N=*N;(B
-     $B$rBT$C$F$+$i%W%m%s%W%H$KLa$C$F$-$^$9!#$^$?$3$N>l9g$O!"(Bfoo.ext $B$O(B
-     $B;D$i$:$K>C5n$5$l$^$9!#(B
+     foo を foo.ext にコピーした後、実行しているアプリケーションの終了
+     を待ってからプロンプトに戻ってきます。またこの場合は、foo.ext は
+     残らずに消去されます。
 
 
-3. $B3HD%;R%G!<%?$NDI2C(B (-a)
+3. 拡張子データの追加 (-a)
 
-   fiber $B$,<1JL$G$-$k3HD%;R$O!"%f!<%6$,<+M3$KDI2C$9$k$3$H$,$G$-$^$9!#(B
-   $BDI2C$9$k$K$O!"(B
+   fiber が識別できる拡張子は、ユーザが自由に追加することができます。
+   追加するには、
 
-     > fiber -a $B3HD%;RL>(B=$B<1JL;R(B(,$B%*%U%;%C%HCM(B)
+     > fiber -a 拡張子名=識別子(,オフセット値)
 
-   $B$N$h$&$K@_Dj$7$^$9!#%*%U%;%C%HCM$r;XDj$7$J$+$C$?>l9g$O(B 0 $B$K$J$j$^$9!#(B
+   のように設定します。オフセット値を指定しなかった場合は 0 になります。
 
 
-   ($BNc(B1) ".mid" $B$rDI2C$7$?$$>l9g(B
+   (例1) ".mid" を追加したい場合
 
-     .mid $B%U%!%$%k$N%U%)!<%^%C%H$O!"(B
+     .mid ファイルのフォーマットは、
 
-       $B%U%!%$%k$N@hF,(B
+       ファイルの先頭
            |
            V
-           0   1   2   3   4   5   6   7  ($B%P%$%H(B)
+           0   1   2   3   4   5   6   7  (バイト)
          +---+---+---+---+---+---+---+---
          | M | T | h | d | ? | ? | ? | ?  ...
          +---+---+---+---+---+---+---+---
 
-    $B$H$J$C$F$$$k$N$G!"(B
+    となっているので、
 
       > fiber -a mid=MThd
 
-    $B$b$7$/$O(B
+    もしくは
 
       > fiber -a mid=MThd,0
 
-    $B$H@_Dj$7$^$9(B
+    と設定します
 
 
-   ($BNc(B2) ".wav" $B$rDI2C$7$?$$>l9g(B
+   (例2) ".wav" を追加したい場合
 
-    .wav $B%U%!%$%k$N%U%)!<%^%C%H$O!"(B
+    .wav ファイルのフォーマットは、
 
-       $B%U%!%$%k$N@hF,(B
+       ファイルの先頭
            |
            V
-           0   1   2   3   4   5   6   7   8   9   10  11  12  ($B%P%$%H(B)
+           0   1   2   3   4   5   6   7   8   9   10  11  12  (バイト)
          +---+---+---+---+---+---+---+---+---+---+---+---+---
          | ? | ? | ? | ? | ? | ? | ? | ? | W | A | V | E | ? ...
          +---+---+---+---+---+---+---+---+---+---+---+---+---
 
-    $B$H$J$C$F$$$k$N$G!"(B
+    となっているので、
 
       > fiber -a wav=WAVE,8
 
-    $B$H;XDj$7$^$9(B
+    と指定します
 
 
-4. $B@_Dj%*%W%7%g%s$NJQ99(B (-o)
+4. 設定オプションの変更 (-o)
 
-   ($BNc(B1) $B%5%]!<%H$9$k3HD%;R?t$r(B 128 $B$K$9$k(B
+   (例1) サポートする拡張子数を 128 にする
 
      > fiber -o ExtNum=128
 
-   ($BNc(B2) fiber $B$,CN$i$J$$3HD%;R$N%U%!%$%k$r<B9T$7$J$$$h$&$K$9$k(B
+   (例2) fiber が知らない拡張子のファイルを実行しないようにする
 
      > fiber -o ExecuteUnknownExt=no
 
 
-$B$=$NB>(B
+その他
 ------
 
-   o $B%l%8%9%H%j%-!<$N(B "HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Fiber" $B$,B8:_$7$J$1$l$P!"(B
-     $B<+F0E*$K%-!<$,:n@.$5$l$F=i4|CM$,=q$-9~$^$l$^$9(B
+   o レジストリキーの "HKEY_CURRENT_USER\SOFTWARE\GNU\Fiber" が存在しなければ、
+     自動的にキーが作成されて初期値が書き込まれます
 
-   o $B$b$C$HBt;3$N>pJs$,F@$?$$$J$i!"(Bfiber.c $B$r8+$^$7$g$&(B(^^;
+   o もっと沢山の情報が得たいなら、fiber.c を見ましょう(^^;
 
 
 ======================== ENGLISH DOCUMENT ========================
@@ -315,7 +314,7 @@ EXAMPLES
 REMARKS
 -------
 
-  o If the registry key "HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Fiber"
+  o If the registry key "HKEY_CURRENT_USER\SOFTWARE\GNU\Fiber"
     does not exist, fiber creates it and writes initial values.
 
   o For more information, see fiber.c :-)