152 lines
5.9 KiB
Plaintext
152 lines
5.9 KiB
Plaintext
Using w3m on Cygwin
|
|
|
|
2003/02/20
|
|
Katsuyuki Watanabe
|
|
Dai Sato
|
|
|
|
You can use w3m on Windows with a UNIX compatible environment "Cygwin". For
|
|
detailed information of Cygwin, See http://cygwin.com/.
|
|
|
|
Build
|
|
|
|
After w3m-0.2, patches for Cygwin have been marged to w3m packages. If you use
|
|
cygwin-1.1.4 or later, w3m shuould be build without any problems.
|
|
(*) on Cygwin B20.1, you should add -luser32 to LOCAL_LIBRARIES
|
|
|
|
The newest version of termcap and ncurses package are recomended. Especially,
|
|
older versions of termcap have bugs in the entry for Cygwin which make the
|
|
screen collapsed. The problem was fixed in termcap-20001020-1.
|
|
|
|
Please make sure to execute ./configure before the make. The macros explained
|
|
in "Macros" are defined by ./configure, and they are nessary to make this
|
|
package. When you have some problem in making w3m, please check the points
|
|
below:
|
|
|
|
o Do make veryclean, then exec ./configure && make.
|
|
o Check gcc and binutils are properly installed. setup.exe might have
|
|
finished without reporting any errors, though the download of package
|
|
files was end in failure. In this case, you should try to setup again.
|
|
|
|
Using Cygwin with Win95/98/ME, configure will not run correctly when
|
|
environment variable CYGWIN includes "ntsec" and/or "ntea", because shell
|
|
scripts will not have executable attribute. It is recomended to remove "ntsec"
|
|
and "ntea" from environment variable CYGWIN to load cygwin1.dll for the first
|
|
time.
|
|
|
|
Macros
|
|
|
|
The macros below are defined in config.h for Cygwin environment.
|
|
|
|
USE_BINMODE_STREAM
|
|
With -dump, -dump_{head,source,both,extra} option, output to stdout are
|
|
done in binary mode. It might not been needed with cygwin-1.3.11 or later,
|
|
but remained for safe.
|
|
In common with Cygwin and EMX.
|
|
SUPPORT_DOS_DRIVE_PREFIX
|
|
The path names are handled as file names when they includes drive letters
|
|
like "C:", "C:/", "file://C:/", "file://C|/", and so on.
|
|
In common with Cygwin and EMX.
|
|
SUPPORT_NETBIOS_SHARE
|
|
URIs of common resources of NETBIOS in "//NETBIOSHOST/SHARE/PATH",
|
|
"file://NETBIOSHOST/SHARE/PATH" format are handled as file: schema instead
|
|
of ftp: schema.
|
|
Only for Cygwin environments.
|
|
SUPPORT_WIN9X_CONSOLE_MBCS
|
|
Search and line input to forms are supported. But input through IME is
|
|
available only with the local console when TERM=cygwin, and environment
|
|
variable CYGWIN is not include "tty". The restrictions avoid the problems
|
|
of the DOS prompt of Win9x and tty layer of Cygwin. For WinNT, the macro
|
|
doesn't change any behavior of w3m, IME is always available with local
|
|
consoles.
|
|
Only for Cygwin environments and LANG=JA.
|
|
|
|
Cooperation with Native Applications
|
|
|
|
When calling the Win32 Native Abblications, "File not found" errors might be
|
|
raised because of difference in formats of path name between Win32 and UNIX.
|
|
|
|
Local CGIs
|
|
|
|
Local CGIs in $LIB (/usr/local/lib/w3m/cgi-bin by default) use /usr/bin/perl.
|
|
If you want to use ActivePerl (a native application) and so on, please modify
|
|
the each scripts in $LIB with wrapper scripts as follows:
|
|
|
|
------ /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" $@
|
|
------------------------------------
|
|
|
|
Where the PERL= is the path of Native Perl in Cygwin context. cygpath
|
|
utilities come with Cygwin packages.
|
|
|
|
For directory listing, when "Use external program for directory listing" is
|
|
set "NO", you can browse the directory list without local CGIs.
|
|
|
|
Editors
|
|
|
|
w3m uses external editors to operate texts textareas and so on. You can use
|
|
any native application as the external editor with the script as below:
|
|
|
|
------ /usr/local/lib/w3m/winedit ------
|
|
#!/bin/sh
|
|
EDITOR='/cygdrive/c/Program Files/sakura/sakura.exe'
|
|
FILE=`cygpath -a -w $1`
|
|
exec "$EDITOR" "$FILE"
|
|
----------------------------------------
|
|
|
|
Where the EDITOR= is the path of Native editor in Cygwin context.
|
|
|
|
If you use inetd as a service in WinNT and connect to localhost by telnet,
|
|
the windows will be opened only if "Allow service to interact with the
|
|
desktop" is ON.
|
|
|
|
Known Bugs
|
|
|
|
LF is converted to CR+LF when use -dump or -dump-source options.
|
|
Make sure USE_BINMODE_STREAM was defined in compilation. Try to
|
|
re-configure and make, or set binmode to the environment variable CYGWIN.
|
|
Can't input through IME in DOS prompt of Win9x.
|
|
When "tty" is included in the environment variable CYGWIN, it is not
|
|
permitted to avoid problems in tty layer of Cygwin. Remove "tty" from
|
|
CYGWIN.
|
|
Cursor keys doesn't work when IME is ON in DOS prompt of Win9x.
|
|
This is the problem of DOS prompt of Win9x and tty layer of Cygwin. Use
|
|
C-f, C-b, C-p, and C-n instead.
|
|
Screen is not controled correctly in command prompt of WinNT.
|
|
Set the each size of screen buffer and window in a same value.
|
|
Can't use the mouse with DOS prompt or command prompt.
|
|
When "Quick Edit" is ON, mouse events are not handed to w3m. Set it OFF.
|
|
Mouse buttons behave funny with DOS prompt or command prompt.
|
|
In cygwin-1.3.15 or earlier, the escape sequence of the right and center
|
|
button of the mouse are inverted. It is fixed in cygwin-1.3.16-1. Please
|
|
make w3m in the environment you use, because w3m can't judge the versions
|
|
of Cygwin perfectly,
|
|
|
|
Others
|
|
|
|
In Cygwin environment, it should be confortable to use not DOS prompt or
|
|
command prompt but telnet clients like TeraTerm, PuTTY, and so on with inetd
|
|
in localhost, or other tools as rxvt or cygterm.
|
|
|
|
o rxvt with japanese enhancement:
|
|
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/
|
|
|
|
|