commit 641487c95a52a28b0d47bffe863e390b7e74bcb1
parent 7a978d423dc08ad09251fea5f905de11065cec3d
Author: ukai <ukai>
Date: Mon, 17 Feb 2003 16:02:04 +0000
[w3m-dev 03749] README.cygwin
* doc-jp/README.cygwin: added
* doc/README: updated
From: WATANABE Katsuyuki <knabe@sannet.ne.jp>
Diffstat:
3 files changed, 190 insertions(+), 1 deletion(-)
diff --git a/ChangeLog b/ChangeLog
@@ -1,3 +1,9 @@
+2003-02-18 WATANABE Katsuyuki <knabe@sannet.ne.jp>
+
+ * [w3m-dev 03749] README.cygwin
+ * doc-jp/README.cygwin: added
+ * doc/README: updated
+
2003-02-17 Fumitoshi UKAI <ukai@debian.or.jp>
* 0.4 release candidate 2
diff --git a/doc-jp/README b/doc-jp/README
@@ -82,7 +82,8 @@ Windows
Windows で w3m を動かすためには,Windows 上の UNIX互換環境
である Cygwin(開発環境付き)が必要です.Cygwinに関する情報は
http://sources.redhat.com/cygwin/ を参照してください.
- http://www.page.sannet.ne.jp/knabe/w3m/w3m.html も大変参考になります。
+ README.cygwin http://www.page.sannet.ne.jp/knabe/w3m/w3m.html
+ も大変参考になります。
3. 著作権
diff --git a/doc-jp/README.cygwin b/doc-jp/README.cygwin
@@ -0,0 +1,182 @@
+cygwin で w3m を使う
+ (2003/02/17) 渡邉勝之
+ knabe@sannet.ne.jp
+
+Windows で w3m を動かすためには,Windows 上の UNIX互換環境である Cygwin が
+必要です.
+Cygwin に関する情報は http://cygwin.com/ を参照してください.
+
+
+* ビルド
+
+w3m-0.2 以降から cygwin 向けの修正パッチが取り込まれたため,cygwin-1.1.4
+以降の環境であれば特に問題なくビルドできます.Net Release 前の B18, B19,
+B20あたりでもビルドできるはずですが,確認はされていません.
+
+なお,termcap ないし ncurses パッケージは最新のものを使ってください.特
+に termcap を使う場合,古いパッケージは /etc/termcap の cygwin のエント
+リにバグがあり,表示がおかしくなります.この問題は termcap-20001020-1 で
+修正されているため,これ以降のバージョンを使用してください.
+
+ビルドする際には, 必ず ./configure してから make してください.以下で説
+明するマクロが定義されなくなるため,正常に動作しなくなります.また,正常
+にビルドできない,正常に動作しない場合には,バグ報告をする前に以下の点を
+チェックしてください.
+
+ o make veryclean してから再度 ./configure && make してみる.
+ o gcc, binutils が正常にインストールされているかを確認する.
+ cygwin の setup.exe に問題があり,パッケージファイルのダウンロード
+ に失敗しても,エラーの報告をしないで正常終了してしまうことがあるよ
+ うです.その場合には再度 setup をやりなおしてください.
+
+また Win95/98/ME では,環境変数 CYGWIN に 'ntsec' もしくは 'ntea' が含ま
+れていると,シェルスクリプトに実行属性がつかなくなるため,configure に失
+敗するようです.w3m に限らず,他にも問題が発生するという報告があるため,
+Win95/98/ME で Cygwin を使用する場合には,最初に cygwin1.dll をロードす
+る際の環境変数 CYGWIN から ntsec, ntea の記述を取り除いてください.
+
+
+* マクロ
+
+config.h には,Cygwin 環境向けに以下のマクロを定義してあります.
+
+o USE_BINMODE_STREAM
+ -dump, -dump_{head,source,both,extra} 時の stdout への出力をバイナリ
+ モードで行います.cygwin-1.3.11 以降では不要になっているはずですが,
+ 安全側に振っておくために残しています.
+ Cygwin, EMX 環境で共通です.
+
+o SUPPORT_DOS_DRIVE_PREFIX
+ 'C:', 'C:/', 'file://C:/', 'file://C|/' などのドライブレターを含むパ
+ スを認識し,ファイル名として扱う機能を有効にします.
+ Cygwin, EMX 環境で共通です.
+
+o SUPPORT_NETBIOS_SHARE
+ '//NETBIOSHOST/SHARE/PATH', 'file://NETBIOSHOST/SHARE/PATH' 形式の
+ NETBIOS 共有資源へのアクセスを ftp: スキーマではなく file: スキーマ
+ として扱う機能を有効にします.
+ Cygwin 環境に特有です.
+
+o SUPPORT_WIN9X_CONSOLE_MBCS
+ Win9X 系の DOS プロンプトで,検索およびフォームへの一行エディタ入力
+ 時に日本語 IME 経由の入力をサポートします.
+ ただし,Win9X 系の DOS プロンプトの実装および Cygwin の tty レイヤー
+ の問題により,ローカルコンソールで TERM=cygwin かつ環境変数 CYGWIN
+ に 'tty' が含まれない場合のみ IME からの入力を許可しています.
+ なお,NT 系ではこのマクロを無効にしても動作は変更されず,ローカルコ
+ ンソールであれば IME による日本語入力が可能です.
+ LANG=JA 指定時の Cygwin 環境に特有です.
+
+
+* Native Application との連携
+
+Cygwin 環境でビルドした w3m から Win32 Native アプリケーションを起動する
+場合,パスの記述形式の違いによって,ファイルが見つからないなどのエラーが
+発生します.
+
+o ローカルCGI
+
+Cygwin 環境でビルドすると,$LIB (通常は /usr/local/lib/w3m/cgi-bin) 以下
+にインストールされるローカル CGI は cygwin の /usr/bin/perl を使うように
+設定されます.これに対し,Native アプリケーションの ActivePerl などを使
+用する場合,以下のようなラッパースクリプトを用意し,$LIB 以下の各スクリ
+プトを修正してください.
+
+------ /usr/local/bin/winperl ------
+#!/bin/sh
+# wrapper script for Win32 Native Perl
+PERL=/cygdrive/c/Perl/bin/perl.exe
+case $1 in
+ -*)
+ ;;
+ *)
+ SCRIPT=`cygpath -w $1`
+ shift
+ ;;
+esac
+exec "$PERL" "$SCRIPT" $@
+------------------------------------
+※PERL= には Cygwin 環境の内部から見た Native Perl のパスを記述してくだ
+ さい.cygpath ユーティリティは cygwin パッケージに入っています.
+
+なお,ディレクトリリストだけであれば,オプション設定で「ディレクトリリス
+トに外部コマンドを使う」を NO にすれば,ローカル CGI を使わずにディレク
+トリのブラウズを行います.
+
+o エディタ
+
+w3m はテキストエリアの内容編集などに外部エディタを使用しますが,外部エデ
+ィタに Win32 Native アプリケーションを使う場合,以下のスクリプトを外部エ
+ディタに指定してください.
+
+------ /usr/local/lib/w3m/winedit ------
+#!/bin/sh
+EDITOR='/cygdrive/c/Program Files/sakura/sakura.exe'
+FILE=`cygpath -a -w $1`
+exec "$EDITOR" "$FILE"
+----------------------------------------
+※EDITOR= には Cygwin 環境の内側から見た Native アプリケーションのパスを
+ 記述してください.
+
+なお,NT 系で inetd をサービスとして動かしていて,localhost に telnet で
+接続している場合には,「デスクトップとの対話をサービスに許可」を ON にし
+ておかなければ window が表示されません.
+
+
+* 既知のバグ
+
+以下は,Cygwin 環境で w3m を動かした場合の問題点です.
+
+o -dump, -dump-source 時に LF -> CR+LF の変換が行われることがある.
+
+ コンパイル時にマクロ USE_BINMODE_STREAM が define されていない可能性が
+ あります.
+ きちんと configure したうえでコンパイルしなおすか,環境変数 CYGWIN に
+ binmode を設定してください.
+
+o Win9X 系の DOS プロンプトで IME 経由の入力ができない.
+
+ 環境変数 CYGWIN に 'tty' が含まれているときには,Cygwin の tty レイヤ
+ の問題を回避するために IME 経由の入力を禁止しています.環境変数 CYGWIN
+ から 'tty' を削除してください.
+
+o Win9X 系の DOS プロンプトで IME が ON になっているとカーソルが効かない.
+
+ Win9X の DOS プロンプトと Cygwin の tty レイヤーの実装の問題です.
+ 代わりに C-f, C-b, C-p, C-n を使ってください.
+
+o NT 系のコマンドプロンプトで画面制御がおかしくなる.
+
+ 「レイアウト」タブで画面バッファのサイズとウィンドウのサイズを違う値に
+ してバックスクロールができるように設定していると,画面制御がおかしくな
+ ることがあるようです.
+
+o DOS プロンプト,コマンドプロンプトでマウスが使えない.
+
+ DOS プロンプト「編集オプション」/コマンドプロンプトの「オプション」で
+ 「簡易編集モード」が ON になっていると,マウスイベントが w3m に渡され
+ ません.OFF に設定してください.
+
+o DOS プロンプト,コマンドプロンプトでマウスボタンに対する反応がおかしい.
+
+ cygwin-1.3.15 までの環境では,マウスの右と中央ボタンのエスケープシー
+ ケンスが入れ替わっていました.これは cygwin-1.3.16-1 で修正されていま
+ すが,w3m 側のバージョン判定が完全ではないため,使用する環境でビルド
+ するようにしてください.
+
+
+* その他
+
+Cygwin 環境では,DOS プロンプト/コマンドプロンプトを使うよりも,inetd を
+あげて,ローカルに TeraTerm, PuTTY などの telnet クライアント経由でログ
+インする,ないしは rxvt, cygterm を使用するほうが快適です.
+
+o rxvt:
+ rxvt on Cygwin
+ http://hp.vector.co.jp/authors/VA021953/rxvt/
+ compiled package
+ http://matsu-www.is.titech.ac.jp/~sohda/cygwin/dist/
+o cygterm:
+ CygTerm - Yet another Cygwin console
+ http://www.dd.iij4u.or.jp/~nsym/cygwin/cygterm/
+