diff options
Diffstat (limited to '')
| -rw-r--r-- | doc/README | 121 | ||||
| -rw-r--r-- | doc/README.cygwin | 151 | ||||
| -rw-r--r-- | doc/README.dict | 68 | ||||
| -rw-r--r-- | doc/README.func | 145 | ||||
| -rw-r--r-- | doc/README.img | 211 | ||||
| -rw-r--r-- | doc/README.m17n | 451 | ||||
| -rw-r--r-- | doc/README.mouse | 61 | ||||
| -rw-r--r-- | doc/README.pre_form | 45 | ||||
| -rw-r--r-- | doc/README.tab | 45 |
9 files changed, 1298 insertions, 0 deletions
diff --git a/doc/README b/doc/README new file mode 100644 index 0000000..daf100c --- /dev/null +++ b/doc/README @@ -0,0 +1,121 @@ + w3m: WWW wo Miru Tool version 0.5.1 April 29, 2004 + (C) Copyright Akinori ITO + Hironori SAKAMOTO + Fumitoshi UKAI + +1. Introduction + + w3m is a pager with WWW capability. It IS a pager, but it can be +used as a text-mode WWW browser. + + The features of w3m are as follows: + +* When reading HTML document, you can follow links and view images + (using external image viewer). +* It has 'internet message mode', which determines the type of document + from header. If the Content-Type: field of the document is text/html, + that document is displayed as HTML document. +* You can change URL description like 'http://hogege.net' in plain text + into link to that URL. + +Current problems are: + +* Online manuals are poor. + +w3m is known to work on these platforms. + + SunOS 4.1.x + HP-UX 9.x, 10.x + Solaris 2.5.x, 2.6, 8, 9 + Linux 2.0.*/2.2.*/2.4.*/2.6.* + FreeBSD 2.2.8, 3.1, 3.2, 4.6 + NetBSD/macppc, m68k + EWS4800 Rel.12.2 Rev.A + Digital UNIX: v3.2D, v4.0D + IRIX 5.3, IRIX 6.5 + OS/2 with emx + Windows 9x/NT with Cygwin b20.1, 1.1.x, 1.3.x + MS-DOS with DJGPP and WATT32 packet driver + MacOS X Server + MacOS X 10.1, 10.2 + +2. Installation + +Follow these instructions to install w3m. + + - You need latest version of GC library (at least 6.1?). + You can get GC library from + http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/ + + Note: if you're using GC library 6.1, you should install gc.h + to PREFIX/include: + # cp gc-6.1/include/gc.h PREFIX/include + + - Run configure. + % ./configure + + - do make + % make + + - do make install + # make install + +MACHINE/OS specific notices: + +HP-UX + If you want to use HP C compiler, answer + + Input your favorite C-compiler. + (Default: cc) cc -Aa -D_HPUX_SOURCE + + If you use just 'cc' without options, you can't compile w3m. + If you are using gcc, no option is needed. + +OS/2 + You can compile w3m using emx. First you have to do + is to compile GC library with + + cd gc + make -f EMX_MAKEFILE + + then compile w3m. I heard that OS/2 console can't + display color, you had better compile w3m without + color capability. + +Windows + To compile w3m on MS-Windows, you have to use Cygwin with + development tools. + Read README.cygwin for more details. + +3. Copyright + + (C) Copyright 1994-2002 by Akinori Ito + (C) Copyright 2002-2004 by Akinori Ito, Hironori Sakamoto, Fumitoshi Ukai + +4. License + + Use, modification and redistribution of this software is hereby granted, + provided that this entire copyright notice is included on any copies of + this software and applications and derivations thereof. + + This software is provided on an "as is" basis, without warranty of any + kind, either expressed or implied, as to any matter including, but not + limited to warranty of fitness of purpose, or merchantability, or + results obtained from use of this software. + +5. Author + +Initial author: + Akinori Ito + Faculty of Engineering, Yamagata University + aito@fw.ipsj.or.jp + +Current Maintainer + Fumitoshi UKAI + Debian Project + ukai@debian.or.jp + +Feel free to send your opinion to the w3m mailing-lists. + w3m-dev@mi.med.tohoku.ac.jp (Japanese) + w3m-dev-en@mi.med.tohoku.ac.jp (English) + http://w3m.sourceforge.net/ diff --git a/doc/README.cygwin b/doc/README.cygwin new file mode 100644 index 0000000..b08e79b --- /dev/null +++ b/doc/README.cygwin @@ -0,0 +1,151 @@ +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/ + + diff --git a/doc/README.dict b/doc/README.dict new file mode 100644 index 0000000..bd82cdb --- /dev/null +++ b/doc/README.dict @@ -0,0 +1,68 @@ +Dictionary look-up hack for w3m + +1. INTRODUCTION + +If you have dictionary look-up command (like 'webster'), you can +look a word in a document using w3m. This dictionary-lookup code +was contributed by `Rubikitch' (rubikitch@ruby-lang.org), and +further modifed by Tushar Samant (scribble at pobox.com). + +2. INSTALLATION + +To make use of dictionary look-up, you currently must change a +compile option by hand. After running configure, edit config.h +and change + +#undef USE_DICT + +to + +#define USE_DICT + +and recompile w3me (i.e. type "make install"). +Note that w3m/0.3+cvs-1.373 or later, USE_DICT is defined by default. + +Then find or install a CGI program which takes a word as a query +string and prints a response. + +Some ways to do this would be: + + * If you have the 'webster' command, put something like this + in a script called 'w3mdict': + + #!/bin/sh + + echo Content-type: text/plain + echo + webster $QUERY_STRING + + Then install w3mdict as a local CGI (see the local CGI section + of the w3m manual), and set your dictionary options from the + options page of w3m (usually invoked with "o"). + + * If you want this function to look a word up on Google instead, + write a local CGI script like this: + + #!/bin/sh + + google_q='http://google.com/search?btnG=Google&q' + + cat <<_END_ + Content-type: text/plain + W3m-control: GOTO $google_q=$QUERY_STRING + W3m-control: DELETE_PREVBUF + + _END_ + + and set its path as your dictionary-lookup URL option. + +3. USAGE + +You can use the following two commands: + +ESC w Input a word and look it up using w3mdict command. + +ESC W look up the current word in the buffer. + +To change these keys, edit ~/.w3m/keymap and edit lines for the +functions DICT_WORD and DICT_WORD_AT respectively. diff --git a/doc/README.func b/doc/README.func new file mode 100644 index 0000000..0b2c034 --- /dev/null +++ b/doc/README.func @@ -0,0 +1,145 @@ +ABORT Quit w3m without confirmation +ACCESSSKEY Popup acceskey menu +ADD_BOOKMARK Add current page to bookmark +ALARM Set alarm +BACK Back to previous buffer +BEGIN Go to the first line +BOOKMARK Read bookmark +CENTER_H Move to the center line +CENTER_V Move to the center column +CHARSET Change the current document charset +CLOSE_TAB Close current tab +CLOSE_TAB_MOUSE Close tab on mouse cursor (for mouse action) +COMMAND Execute w3m command(s) +COOKIE View cookie list +DEFAULT_CHARSET Change the default document charset +DEFINE_KEY Define a binding between a key stroke and a user command +DELETE_PREVBUF Delete previous buffer (mainly for local-CGI) +DICT_WORD Execute dictionary command (see README.dict) +DICT_WORD_AT Execute dictionary command for word at cursor +DISPLAY_IMAGE Restart loading and drawing of images +DOWN Scroll down one line +DOWNLOAD Save document source to file +DOWNLOAD_LIST Display download list panel +EDIT Edit current document +EDIT_SCREEN Edit currently rendered document +END Go to the last line +EXEC_SHELL Execute shell command +EXIT Quit w3m without confirmation +EXTERN Execute external browser +EXTERN_LINK View current link using external browser +FRAME Render frame +GOTO Go to URL +GOTO_LINE Go to specified line +GOTO_LINK Go to current link +GOTO_RELATIVE Go to relative URL +HELP View help +HISTORY View history of URL +INFO View info of current document +INTERRUPT Stop loading document +INIT_MAILCAP Reread mailcap (mainly for local-CGI) +ISEARCH Incremental search forward +ISEARCH_BACK Incremental search backward +LEFT Shift screen one column +LINE_BEGIN Go to the beginning of line +LINE_END Go to the end of line +LINE_INFO Show current line number +LINK_BEGIN Go to the first link +LINK_END Go to the last link +LINK_MENU Popup link element menu +LIST Show all links and images +LIST_MENU Popup link list menu and go to selected link +LOAD Load local file +MAIN_MENU Popup menu +MARK Set/unset mark +MARK_MID Mark Message-ID-like strings as anchors +MARK_URL Mark URL-like strings as anchors +MARK_WORD Mark current word as anchor +MENU Popup menu +MENU_MOUSE Popup menu at mouse cursor (for mouse action) +MOUSE_TOGGLE Toggle activity of mouse +MOVE_DOWN Move cursor down (a half screen scroll at the end of screen) +MOVE_DOWN1 Move cursor down (1 line scroll at the end of screen) +MOVE_LEFT Move cursor left (a half screen shift at the left edge) +MOVE_LEFT1 Move cursor left (1 columns shift at the left edge) +MOVE_LIST_MENU Popup link list menu and move cursor to selected link +MOVE_MOUSE Move cursor to mouse cursor (for mouse action) +MOVE_RIGHT Move cursor right (a half screen shift at the right edge) +MOVE_RIGHT1 Move cursor right (1 columns shift at the right edge) +MOVE_UP Move cursor up (a half screen scroll at the top of screen) +MOVE_UP1 Move cursor up (1 line scrol at the top of screen) +MSGS Display error messages +NEW_TAB Open new tab +NEXT Move to next buffer +NEXT_DOWN Move to next downward link +NEXT_LEFT Move to next left link +NEXT_LEFT_UP Move to next left (or upward) link +NEXT_LINK Move to next link +NEXT_MARK Move to next word +NEXT_PAGE Move to next page +NEXT_RIGHT Move to next right link +NEXT_RIGHT_DOWN Move to next right (or downward) link +NEXT_TAB Move to next tab +NEXT_UP Move to next upward link +NEXT_VISITED Move to next visited link +NEXT_WORD Move to next word +NOTHING Do nothing +NULL Do nothing +OPTIONS Option setting panel +PEEK Peek current URL +PEEK_IMG Peek image URL +PEEK_LINK Peek link URL +PIPE_BUF Send rendered document to pipe +PIPE_SHELL Execute shell command and browse +PREV Move to previous buffer +PREV_LINK Move to previous link +PREV_MARK Move to previous mark +PREV_PAGE Move to previous page +PREV_TAB Move to previous tab +PREV_VISITED Move to previous visited link +PREV_WORD Move to previous word +PRINT Save buffer to file +QUIT Quit w3m +READ_SHELL Execute shell command and load +REDO Cancel the last undo +REDRAW Redraw screen +REG_MARK Set mark using regexp +REINIT Reload configuration files +RELOAD Reload buffer +RESHAPE Re-render buffer +RIGHT Shift screen one column right +SAVE Save document source to file +SAVE_IMAGE Save image to file +SAVE_LINK Save link to file +SAVE_SCREEN Save rendered document to file +SEARCH Search forward +SEARCH_BACK Search backward +SEARCH_FORE Search forward +SEARCH_NEXT Search next regexp +SEARCH_PREV Search previous regexp +SELECT Go to buffer selection panel +SELECT_MENU Popup buffer selection menu +SETENV Set environment variable +SET_OPTION Set option +SHELL Execute shell command +SHIFT_LEFT Shift screen left +SHIFT_RIGHT Shift screen right +SOURCE View HTML source +STOP_IMAGE Stop loading and drawing of images +SUBMIT Submit form +SUSPEND Stop loading document +TAB_GOTO Open URL on new tab +TAB_GOTO_RELATIVE Open relative URL on new tab +TAB_LEFT Move current tab left +TAB_LINK Open current link on new tab +TAB_MENU Popup tab selection menu +TAB_MOUSE Move to tab on mouse cursor (for mouse action) +TAB_RIGHT Move current tab right +UNDO Cancel the last cursor movement +UP Scroll up one line +VERSION Display version of w3m +VIEW View HTML source +VIEW_BOOKMARK View bookmark +VIEW_IMAGE View image +WHEREIS Search forward +WRAP_TOGGLE Toggle wrap search mode diff --git a/doc/README.img b/doc/README.img new file mode 100644 index 0000000..45eb338 --- /dev/null +++ b/doc/README.img @@ -0,0 +1,211 @@ + +Inline image support of w3m + 2002/02/04 + H. Sakamoto + 2002/10/16 + H. Ito + +Introduction + + This is the extension for w3m to support inline image. + +Support + + * Display inline image (GIF,PNG,JPEG, etc.) on terminals + (xterm,rxvt, etc.) of X11 or Linux framebuffer device. + * Support inline image of <img> tag. + Support of attributes "width", "height", and "align". + * Direct display of image file which header is "Content-type: image/*" + * Support of <map> tag. + Support of attributes "shape" and "coords" of <area> tag. + * Support of an attribute "ismap" of <img> tag. + "w3m" adds coordinate of the cursor as ?<x>,<y> to url, and sends url. + * Support of an attribute "type=image" of <input> tag. + "w3m" sends coordinate of the cursor as <name>.x=<x>&<name>.y=<y>. + * Asynchronous loading of image files. + * Using cache of image file as pixmap. + * Support of GIF animation when use GdkPixbuf. + + +Key functions + + DISPLAY_IMAGE + Restart loading and drawing of images. + STOP_IMAGE + Stop loading and drawing of images in the current buffer. + SET_OPTION display_image=toggle + Toggle loading and drawing of images. + + These functions are not keybinded as default. + Specify the following keymaps in ~/.w3m/keymap. + keymap X DISPLAY_IMAGE + keymap C-c STOP_IMAGE + keyamp t SET_OPTION display_image=toggle + +Comandline options + + -ppc <pixel> + # of pixels per character. The default value is automatically + detected. Must fit the width of font of terminal. + -ppl <pixel> + # of pixels per character. The default value is automatically + detected. Must fit the height of font of terminal. + +Option panel + + pixel_per_char + # of pixels per character. The default value is automatically + detected. Must fit the width of font of terminal. + pixel_per_line + # of pixels per character. The default value is automatically + detected. Must fit the height of font of terminal. + display_image + Display of inline image. The default is ON. + auto_image + Automatic loading of inline image. The default is ON. + If it is OFF, loading starts with a command DISPLAY_IMAGE. + max_load_image + Maximum process for downloading of inline image. The default is 4. + 1 to 8 can be set. + ext_image_viewer + Use external image viewer, when a command VIEW_IMAGE or + view of image file which header is "Content-type: image/*". + The default is ON. If it is OFF, the image is directly displaied. + image_scale + Scale of image (%). The default value is 100(%). + imgdisplay + External command to display image". The default value is "w3mimgdisplay". + See "Setting w3mimgdisplay". + +Required programs + + for X11 + * GdkPixbuf-0.16 or later + + or + + * w3m-0.2.5+cvs-1.287 or later + http://w3m.sourceforge.net/ + http://sourceforge.net/projects/w3m/ + http://prdownloads.sourceforge.net/w3m/ + * Imlib-1.9.8 (1.9.10 is recommendable.) + libungif-4.1.0b1 is recommendable. + + for Linux framebuffer device + * GdkPixbuf-0.16 or later + + or + + * Imlib2-1.0.6 or later + + * Framebuffer device(packed pixels with 8 bpp pseudocolor + and 16/24/32 bpp truecolor/directcolor) + + +Setting w3mimgdisplay + + "w3mimgdisplay" has the following options. Set options to fit terminal. + + -x <offset_x> + The X origin of display of image on terminal. The default value + for X11 is 2. + If the terminal is "xterm", the width of scroll bar is added. + If the terminal is "Eterm", it may be better to specify 5. + The default value for Linux framebuffer device is 0. + -y <offset_y> + The Y origin of display of image on terminal. The default value + for X11 is 2. + If the terminal is "Eterm", it may be better to specify 5. + The default value for Linux framebuffer device is 0. + -bg <background> + Background color of terminal. The default value for X11 is + automatically detected. + The default value for Linux framebuffer device is #000000 (black). + When the color is specified as #RRGGBB, escape '#'. + + ex.) + w3m -o 'imgdisplay=w3mimgdisplay -x 5 -bg "#cccccc"' + +Notice + If you want to see GIF animation, please hit a suitable key, such + as 'h', 'l', etc., repeatedly, because a frame is rewritten + according to the re-drawing demand from w3m. + + Some code in w3mimg/fb/fb.c was originally written by Mr. Yamasaki. + http://www.sainet.or.jp/~yamasaki/download/fb-sample.tar.gz + +Change log + +2002/02/04 + * Revised this document. + +2002/02/01 w3m-0.2.5+cvs-1.287 + * Merged in the CVS repository of the original w3m. + +2002/01/31 w3m-0.2.4-img-2.2 + * Based on w3m-0.2.4+cvs-1.278. + +2002/01/29 w3m-0.2.4-img-2.1 + * Based on w3m-0.2.4+cvs-1.268. + +2002/01/28 w3m-0.2.4-img-2.0 + * Based on w3m-0.2.4+cvs-1.265. + * pixel_per_char and pixel_per_line are automatically detected. + * The bckground color of terminal is automatically detected. + * The source code to display images is moved to image.c + +2002/01/08 w3m-0.2.4-img-1.18 + * Based on w3m-0.2.4 + +2001/12/29 w3m-0.2.3.2-img-1.17 + * Based on w3m-0.2.3.2+cvs-1.196. + +2001/12/25 w3m-0.2.3.2-img-1.16.1 + * [w3m-dev 02698] Thanks > Kazuhiko-san + +2001/12/22 w3m-0.2.3.2-img-1.16 + * Based on w3m-0.2.3.2. + +2001/12/20 w3m-0.2.3.1-img-1.15 + * Based on w3m-0.2.3.1. + * Support display of image with Content-Transfer-Encoding. + +2001/11/29 + * Start merge against CVS source (ChangeLog 1.71) + +2001/11/17 w3m-0.2.2-img-1.14 + * Based on w3m-0.2.2. + +2001/11/14 w3m-0.2.1-inu-1.6-img-1.13 + * Based on w3m-0.2.1-inu-1.6. + +2001/11/05 w3m-0.2.1-inu-1.5-img-1.12 + * Based on w3m-0.2.1-inu-1.5. + * Fixed the bug for <area>, <map>. + * Fixed the problem with xwnmo on kterm. + +2001/10/03 w3m-0.2.1-inu-1.4-img-1.11 + * Based on w3m-0.2.1-inu-1.4. + * Fixed bug when reading from stdin. + * Fixed "configure". Thanks > Fukagawa-san. + +2001/08/01 w3m-0.2.1-img-1.10 + * Adjust image position. + * Fixed scaling image. + +2001/07/31 w3m-0.2.1-img-1.9 + * Fixed initImgdisplay(). Thanks > David. + +2001/07/29 w3m-0.2.1-img-1.8 + * Fixed "configure". + +2001/07/28 w3m-0.2.1-img-1.7 + * Sorry, w3m-0.2.1-img-1.6 is not complete. + * Added "configure" and "Makefile" to the patch. + +2001/07/27 w3m-0.2.1-img-1.6 + * Created doc/README.img. + +------------------------------------------- +Hironori Sakamoto <hsaka@mth.biglobe.ne.jp> + http://www2u.biglobe.ne.jp/~hsaka/ diff --git a/doc/README.m17n b/doc/README.m17n new file mode 100644 index 0000000..0dd1b78 --- /dev/null +++ b/doc/README.m17n @@ -0,0 +1,451 @@ + +Muntilingualizaion of w3m + 2003/03/08 + H. Sakamoto + +Introduction + + I have tried the muntilingualization of w3m (w3m-m17n). + The patch for w3m-0.4.1 is available on the following site. + + http://www2u.biglobe.ne.jp/~hsaka/w3m/index.html#m17n + patch/w3m-0.4.1-m17n-20030308.tar.gz + patch/README.m17n + + It is a development version. And enough test is not preformed because + I can understand Japanese only. Please use, test, and report bugs. + + Now, w3m-m17n has following functions. + +Supported encoding schemes (character set) + + * Japanese + EUC-JP - US_ASCII, JIS X 0208, JIS X 0201, JIS X 0212 + (EUC-JISX0213) (JIS X 0213) + ISO-2022-JP - US_ASCII, JIS X 0208, JIS X 0201, JIS X 0212, etc. + ISO-2022-JP-2 - US_ASCII, JIS X 0208, JIS X 0201, JIS X 0212, + GB 2312, KS X 1001, ISO 8859-1, ISO 8859-7, etc. + ISO-2022-JP-3 - US_ASCII, JIS X 0208, JIS X 0201, JIS X 0213, etc. + Shift_JIS(CP932) - US_ASCII, JIS X 0208, JIS X 0201, CP932 extension + Shift_JISX0213 - US_ASCII, JIS X 0208, JIS X 0201, JIS X 0213 + * Chinese (simplified) + EUC-CN(GB2312) - US_ASCII, GB 2312 + ISO-2022-CN - US_ASCII, GB 2312, CNS-11643-1,..7, etc. + GBK(CP936) - US_ASCII, GB 2312, GBK + GB18030 - US_ASCII, GB 2312, GBK, GB18030, Unicode, + HZ-GB-2312 - US_ASCII, GB 2312 + * Chinese (Taiwan, tradisional) + EUC-TW - US_ASCII, CNS 11643-1,..16 + ISO-2022-CN - US_ASCII, CNS-11643-1,..7, GB 2312, etc. + Big5 - Big5 + HKSCS - Big5, HKSCS + * Korean + EUC-KR - US_ASCII, KS X 1001 Wansung + ISO-2022-KR - US_ASCII, KS X 1001 Wansung, etc. + Johab - US_ASCII, KS X 1001 Johab + UHC(CP949) - US_ASCII, KS X 1001 Wansung, UHC + * Vietnamese + TCVN-5712 VN-1, VISCII 1.1, VPS, CP1258 + * Thai + TIS-620 (ISO-8859-11), CP874 + * Other + US_ASCII, ISO-8859-1 กม 10, 13 กม 15, + KOI8-R, KOI8-U, NeXT, CP437, CP737, CP775, CP850, CP852, CP855, CP856, + CP857, CP860, CP861, CP862, CP863, CP864, CP865, CP866, CP869, CP1006, + CP1250, CP1251, CP1252, CP1253, CP1254, CP1255, CP1256, CP1257 + * Unicode (UCS-4) + UTF-8, UTF-7 + + NOTE: + * The left part of JIS X 0201 and GB 1988 (Chinese ASCII) are + treated as US_ASCII because they are used in tags of HTML document. + Another variant of US_ASCII is treated without change. + * JIS C 6226(old JIS) is treated as JIS X 0208. + * The sequence '~\n' of HZ is not supported. + +Display + + There are two method for multilingual diplay. + + (1) kterm + ISO-2022-JP/CN/KR + + * kterm can handle JIS X 0213, CNS 11643, if the following patch + is applied. + http://www.st.rim.or.jp/~hanataka/kterm-6.2.0.ext02.patch.gz + + * Specify the fontList for kterm with -fl option or in ~/.Xdefaults. + + -fl "*--16-*-jisx0213.2000-*,\ + *--16-*-jisx0212.1990-0,\ + *--16-*-ksc5601.1987-0,\ + *--16-*-gb2312.1980-0,\ + *--16-*-cns11643.1992-*,\ + *--16-*-iso8859-*" + + Fonts of JIS X 0213 exist in + http://www.mars.sphere.ne.jp/imamura/jisx0213.html + + * Set the "display_charset" to ISO-2022-JP(or ISO-2022-JP-2, KR, CN), + and "strict_iso2022" to OFF on the option pannel. (see below) + + (2) xterm + UTF-8 + + * Use xterm (xterm-140 or later) of XFree86. + http://www.clark.net/pub/dickey/xterm/xterm.html + + * Fonts of Unicode exist in + http://www.cl.cam.ac.uk/~mgk25/ucs-fonts.html + http://openlab.ring.gr.jp/efont/index.html.en + + * Use xterm with -u8 option. + The fonts are specified such as + -fn "*-medium-*--13-*-iso10646-1" \ + -fb "*-bold-*--13-*-iso10646-1" \ + -fw "*-medium-*-ja-13-*-iso10646-1" + + * Set the "display_charset" to UTF-8. + And, it is better that "pre_conv" is ON. + + (3) mlterm + ISO-2022-JP/KR/CN + + * Homepage + http://mlterm.sourceforge.net/ + + * Set encoding of mlterm to ISO-2022-JP/KR/CN or UTF-8. + + * Set the "display_charset" to ISO-2022-JP/KR/CN or UTF-8. + +Command line options + + -I <document charset> + -O <display/output charset> + + j(p): ISO-2022-JP + j(p)2: ISO-2022-JP-2 + j(p)3: ISO-2022-JP-3 + cn: ISO-2022-CN + kr: ISO-2022-KR + e(j): EUC-JP + ec,g(b): EUC-CN(GB2312) + et: EUC-TW + ek: EUC-KR + s(jis): Shift_JIS + sjisx0213: Shift_JISX0213 + gbk: GBK + gb18030: GB18030 + h(z): HZ-GB-2312 + b(ig5): Big5 + hk(scs): HKSCS + jo(hab): Johab + uhc: UHC + l?: ISO-8859-? + t(is): TIS-620(ISO-8859-11) + tc(vn): TCVN-5712 VN-1 + v(iscii): VISCII 1.1 + vp(s): VPS + ko(i8r): KOI8-R + koi8u: KOI8-U + n(ext): NeXT + cp???: CP??? + w12??: CP12?? + u(tf8): UTF-8 + u(tf)7: UTF-7 + +Option pannel + + display_charset + Display charset. + document_charset + Defalut Document charset. + auto_detect + Automatic charset detect when loading. (Default: ON) + system_charset + System charset. It is used for configuration files and file name. + follow_locale + System charset follows locale($LANG). (Default: ON) + ext_halfdump + Output with display charset when -halfdump. + search_conv + Adjust search string for document charset. (Default: ON) + use_wide + Use multi column characters. (Default: ON) + use_combining + Use combining characters. (Default: ON) + use_language_tag + Use Unicode language tags. (Default: ON) + ucs_conv + Charset conversion using Unicode map. (Default: ON) + pre_conv + Charset conversion when loading. (Default: OFF) + fix_width + Fix character width when conversion. (Default: ON) + If it is OFF, the rendering may collapse. + use_gb12345_map + Use GB 12345 Unicode map instead of GB 2312's. (Default: OFF) + If it is ON, GB2312 can be converted to Big5, EUC-TW, or EUC-JP. + use_jisx0201 + Use JIS X 0201 Roman for ISO-2022-JP. (Default: OFF) + use_jisc6226 + Use JIS C 6226:1978 for ISO-2022-JP. (Default: OFF) + use_jisx0201k + Use JIS X 0201 Katakana. (Default: OFF) + use_jisx0212 + Use JIS X 0212:1990 (Supplemental Kanji). (Default: OFF) + use_jisx0213 + Use JIS X 0213:2000 (2000JIS). (Default: OFF) + strict_iso2022 + Strict ISO-2022-JP/KR/CN. (Default: ON) + If it is OFF, all ISO 2022 base character set can be displayed + with ISO-2022-JP/KR/CN. + + alt_entity + Use alternate expression with ASCII for entities. (Default: ON) + If it is OFF, entities are treated as ISO 8859-1 + graphic_char + Use graphic char for border of table and menu. + If it is OFF, ruled line is used with CJK charset or UTF-8. + +Code conversion + + The following special code conversions are supported. + * EUC-JP <-> ISO-2022-JP <-> Shift-JIS + * EUC-CN <-> ISO-2022-CN <-> HZ-GB-2312 + * EUC-TW <-> ISO-2022-CN + * EUC-KR <-> ISO-2022-KR <-> Johab (only Symbol and Hanja) + + Other conversions are based on Unicode. + +Change document charset + + Press '=' (show document infomation), and select document charaset. + + If you specify the following keymaps, + keymap C CHARSET + keymap M-c DEFAULT_CHARSET + you can press `C' to change the current document charset, + and `M-c' to change the default document charset. + +Line Editing + + Input coding system is followed by display coding system. + + NOTE: + * HZ can not be used as input coding system. + * Input with ISO-2022-CN or ISO-2022-KR is perhaps failure, because + SI(\017) and SO(\016) are already assigned as other command key. + (SO is assigned as `next-history'). If you want to use SI and SO, + press C-@(^@). After that, SI, SO, SS2, SS3, LS2, and LS3 of + 7bit ISO-2022 are recognited. When you press C-@ again, the default + binding is set. + +Regular expression + + Multilingual regular expression is supported. + +----------------------------------- +Change log + +2003/03/08 w3m-0.4.1-m17n-20030308 + * Base on w3m-0.4.1 + +2003/02/24 w3m-0.4-m17n-20030224 + * Base on w3m-0.4 + +2003/02/11 w3m-0.4rc1-m17n-20030211 + * Base on w3m-0.4rc1 + +2003/02/07 w3m-0.3.2.2-m17n-20030207 + * Base on w3m-0.3.2.2+cvs-1.742 + +2003/02/01 w3m-0.3.2.2-m17n-20030201 + * Base on w3m-0.3.2.2+cvs-1.734 + +2003/01/31 w3m-0.3.2.2-m17n-20030131 + * Base on w3m-0.3.2.2+cvs-1.732 + +2003/01/23 w3m-0.3.2.2-m17n-20030123 + * Base on w3m-0.3.2.2+cvs-1.705 + +2003/01/22 w3m-0.3.2.2-m17n-20030122 + * Base on w3m-0.3.2.2+cvs-1.699 + +2003/01/01 w3m-0.3.2.2-m17n-20030101 + * Base on w3m-0.3.2.2+cvs-1.655 + +2002/12/22 w3m-0.3.2.2-m17n-20021222 + * Base on w3m-0.3.2.2+cvs-1.640 + +2002/12/19 w3m-0.3.2.2-m17n-20021219 + * Base on w3m-0.3.2.2+cvs-1.635 + +2002/12/07 w3m-0.3.2.2-m17n-20021207 + * Base on w3m-0.3.2.2+cvs-1.599 + * Fixed a problem on int != long system + +2002/11/27 w3m-0.3.2.1-m17n-20021127 + * Base on w3m-0.3.2.1+cvs-1.562 + +2002/11/20 w3m-0.3.2-m17n-20021120 + * Base on w3m-0.3.2+cvs-1.538 + +2002/11/18 + * Added UTF-7 to auto detection of charset. + +2002/11/16 w3m-0.3.2-m17n-20021116 + * Base on w3m-0.3.2+cvs-1.526 + +2002/11/13 w3m-0.3.2-m17n-20021113 + * Base on w3m-0.3.2+cvs-1.506 + +2002/11/12 w3m-0.3.2-m17n-20021112 + * Base on w3m-0.3.2+cvs-1.498 + +2002/11/09 w3m-0.3.2-m17n-20021109 + * Base on w3m-0.3.2+cvs-1.490 + +2002/11/07 w3m-0.3.2-m17n-20021107 + * Base on w3m-0.3.2 + * Applied [w3m-dev 03371] + +2002/10/22 w3m-0.3.1-m17n-20021022 + * Base on w3m-0.3.1+cvs-1.444 + +2002/07/17 w3m-0.3.1-m17n-20020717 + * Base on w3m-0.3.1 + +2002/05/29 w3m-0.3-m17n-20020529 + * Base on w3m-0.3+cvs-1.379. + +2002/03/16 w3m-0.3-m17n-20020316 + * Base on w3m-0.3+cvs-1.353. + +2002/03/11 w3m-0.3-m17n-20020311 + * Base on w3m-0.3+cvs-1.342. + * Some bug fixes. + +2002/02/16 w3m-0.2.5-m17n-20020216 + * Base on w3m-0.2.5+cvs-1.319. + * Added an option "use_wide" + +2002/02/05 w3m-0.2.5-m17n-20020205 + * Base on w3m-0.2.5+cvs-1.302. + +2002/02/02 w3m-0.2.5-m17n-20020202 + * Base on w3m-0.2.5+cvs-1.291. + +2002/01/31 w3m-0.2.4-m17n-20020131 + * Base on w3m-0.2.4+cvs-1.278. + +2002/01/29 w3m-0.2.4-m17n-20020129 + * Base on w3m-0.2.4+cvs-1.268. + * Some bug fixes. + +2002/01/28 w3m-0.2.4-m17n-20020128 + * Base on w3m-0.2.4+cvs-1.265. + +2002/01/08 w3m-0.2.4-m17n-20020108 + * Base on w3m-0.2.4. + +2002/01/07 + * Replaced some wc_conv,wc_Str_conv with wc_conv_strict,wc_Str_conv_strict. + +2001/12/31 + * Added the conversion between HKSCS and Unicode. + * Changed the conversion table between Big5 and Unicode. + * Deleted the special conversion between Big5 and CNS11643. + * Fixed HKSCS. + +2001/12/30 w3m-0.2.3.2-m17n-20011230 + * Base on w3m-0.2.3.2+cvs-1.196. + +2001/12/22 w3m-0.2.3.2-m17n-20011222 + * Base on w3m-0.2.3.2. + * [w3m-dev-en 00660] can't compile if INET6 is defined + * [w3m-dev-en 00663] double meanings for WC_N_??? + +2001/12/21 w3m-0.2.3.1-m17n-20011221 + * Base on w3m-0.2.3.1. + * Support of HKSCS, KOI8-U, UTF-7. + The conversion table between HKSCS and Unicode is not yet available. + * Add the conversion between ISO 8859-16 and Unicode. + * Add option 'ext_halfdump'. + +2001/04/14 w3m-(0.2.1)-m17n-0.20 + * Support of UTF-7. + * [w3m-dev 01913] ([w3m-dev-en 00452]) + +2001/04/12 w3m-(0.2.1)-m17n-0.19 + * TILDE of JISX0212, JISX0213 -> FULLWIDTH TILDE of Unicode. + * MICRO SIGN of Unicode -> GREEK SMALL MU of JISX0208. + * [w3m-dev 01892], [w3m-dev 01894], [w3m-dev 01898], [w3m-dev 01902] + +2001/03/31 + * Changed implement of <_SYMBOL> again. + * When -dump option, "pre_conv" is false as default. + +2001/03/29 + * Support combining characters of TCVN 5712. + * [w3m-dev 01873], [w3m-dev-en 00411]. + +2001/03/28 + * Setting -suffix="" can be okay in confiugre. (thanks to naddy!) + * Bugfix: when #define USE_SSL and #undef USE_SSL_VERIFY, rc.c + doesn't compile. (thanks to naddy!) + * [w3m-dev 01859]. + * Bugfix: 0xA0 is error in Shift-JIS. + * Changed implement of <_SYMBOL> ([w3m-dev 01852]). + +2001/03/24 w3m-(0.2.1)-m17n-0.18 + * Base on w3m-0.2.1. + * [w3m-dev 01703], [w3m-dev 01814], [w3m-dev 01823] + * Separated ISO-2022-JP-3 from ISO-2022-JP. + * Improved auto detection. + +2001/03/23 + * Base on w3m-0.2.0. + +2001/03/21 + * Added functions (CHARSET and DEFAULT_CHARSET). + * Improved document charset detection of frame HTML. + +2001/03/20 + * Conversion from FULL WIDTH variant except ASCII to normal character. + +2001/03/18 w3m-(0.1.11-pre-hsaka24)-m17n-0.17 + * Based on "[w3m-dev 01779] w3m-0.1.11-pre-hsaka24". + * Prefer JIS X 0213 than JIS X 0212. + +2001/03/14 w3m-(0.1.11-pre-kokb23)-m17n-0.16 + * Add the conversion between JIS X 0213 and Unicode Extention B. + * Bugfix: conversion between JIS X 0213 and Unicode. + * Bugfix: treat UHC as Hangul. + * Ignore "search_conv" if "pre_conv" is ON. + +2001/03/09 w3m-(0.1.11-pre-kokb23)-m17n-0.15 + * Improvement of wc_wchar_t (mainly for Unicode). + * Some bugfixes for Unicode. + * Ignore "use_gb12345_map" option when output with GBK or GB18030. + * When -dump option, "prev_conv" is always true. + * when -dump or -halfdump option, some proccessing is skiped. + * Get system charset from the environment variable LC_CTYPE -> LANG -> LC_ALL. + * Bugfixes: [w3m-dev 01724], [w3m-dev 01726], [w3m-dev 01752], + [w3m-dev 01753], [w3m-dev 01754] + +2001/03/06 w3m-(0.1.11-pre-kokb23)-m17n-0.14 + * Support of Language tag (UTR#7). + * Bugfix: conversion between GB18030, Johab and Unicode. + +2001/03/04 w3m-(0.1.11-pre-kokb23)-m17n-0.13 + * Support of GBK(CP936), GB18030, UHC(CP949) ! + * Unicode mapping table of GB2312 and GB12345 became compatible with + CP936, GB18030. (Code point: 0xA1A4, 0xA1AA) + * Allow 0xFFFE and 0xFFFF in Uncide (due to compatibility with GB18030). + * Bugfix: code point of NBSP in Unicode. + +2001/03/03 w3m-(0.1.11-pre-kokb23)-m17n-0.12 + * I wrote English README.m17n. + +------------------------------------------- +Hironori Sakamoto <hsaka@mth.biglobe.ne.jp> + http://www2u.biglobe.ne.jp/~hsaka/ + diff --git a/doc/README.mouse b/doc/README.mouse new file mode 100644 index 0000000..a604b85 --- /dev/null +++ b/doc/README.mouse @@ -0,0 +1,61 @@ +~/.w3m/mouse syntax: + +menu <menu string - default empty> +lastline <lastline string - default "<=UpDn"> +button <num> <pos> <func> [<arg>] + +<num>: 1 : left button + 2 : middle button + 3 : right button + +<pos>: menu <x1> <x2> : click on menu + lastline <x1> <x2> : click on last line + default : default action + anchor : click on anchor + active : click on active anchor + tab : click on tab + +<x1>: left column pos +<x2>: right column pos + +menu in <pos> can be omited for backward compatibility. + +default configuration (in func.c) + + +button 1 default MOVE_MOUSE +button 2 default BACK +button 3 default MENU_MOUSE + +button 1 active GOTO_LINK + +button 1 tab TAB_MOUSE +button 2 tab CLOSE_TAB_MOUSE + +lastline "<=UpDn" +button 1 lastline 0 1 BACK +button 1 lastline 2 3 PREV_PAGE +button 1 lastline 4 5 NEXT_PAGE + +For example + +- In ~/.w3m/mouse + + button 1 anchor COMMAND "MOVE_MOUSE; GOTO_LINK" + + you can jump to link by left click on non-active anchor. + +- In ~/.w3m/menu + + menu Active + func "Display LInk (a)" GOTO_LINK "a" + func "Open in new tag (t)" TAB_LINK "t" + func "Save link (d)" SAVE_LINK "d" + func "External browser (m)" EXTERN_LINK "m" + end + + and ~/.w3m/mouse + + button 3 anchor MENU_MOUSE Active + + then you can open menu by right click on anchor. diff --git a/doc/README.pre_form b/doc/README.pre_form new file mode 100644 index 0000000..972ef90 --- /dev/null +++ b/doc/README.pre_form @@ -0,0 +1,45 @@ +pre_form: Feature to configure form parameters when opening specific site. + +It would be convinient for sites where you often visit, but it may introduce +some security issues. Be careful to use this feature, especially `submit' +params described below. + +Default configuration file for pre_form is ~/.w3m/pre_form. + +Syntax as follows: + +url <url>|/<re-url>/ +form [<name>] <action> +text <name> <value> +file <name> <value> +password <name> <value> +checkbox <name> <value> [<checked>] +radio <name> <value> +section <name> <value> +submit [<name> [<value>]] +image [<name> [<value>]] +textarea <name> +<value> + : +/textarea + +If <action> is set, form which has matched <action> attributes +will be configured by this pre_form. + +The line begining with text, file, passwd, select, textarea means that +it will set value to <value> in input, select or textarea element which +name attribute matches with <name>. + +The line beginning with checkbox, radio means that it will check +input element which name and value attribute matches with <name> and <value> +respectively. If <checked> is 0, no, or off, disable check of the checkbox. + +The line beginning with submit or image means that it will submit input +element which name attribute matches with <name> (and value attribute +matches with <value>), or submit last <input type=submit> element if no +<name> specified. + +You quote \, ' (single-quote) or " (double quote) as you do in shell. + + + diff --git a/doc/README.tab b/doc/README.tab new file mode 100644 index 0000000..8e98e1c --- /dev/null +++ b/doc/README.tab @@ -0,0 +1,45 @@ +w3m tab browsing + +No default keybinding for tab browsing. Pleaes configure following +function to appropriate keys: + + NEW_TAB open new tab, clone current page + TAB_LINK open document refered by link in a new tab + Num(N) + TAB_LINK will open in Nth tab + TAB_GOTO open URL in a new tab + Num(N) + TAB_GOTO will open in Nth tab + TAB_GOTO_RELATIVE + open relative URL in a new tab + Num(N) + TAB_GOTO_RELATIVE will open in Nth tab + CLOSE_TAB close current tab + Num(N) + CLOSE_TAB will close Nth tab + NEXT_TAB change to next tab + Num(N) + NEXT_TAB will change to Nth next tab + PREV_TAB change to prev tab + Num(N) + PREV_TAB will change to Nth prev tab + TAB_RIGHT move current tab to right + Num(N) + TAB_RIGHT will move current tab to N right + TAB_LEFT move current tab to left + Num(N) + TAB_LEFT will move current tab to N left + TAB_MENU open tab selection menu + operation in tab selection menu is same as operation + in buffer selection menu + +You can operate with mouse + + left button .. move the tab if you click on the tab + dragging a tab to another tab will move tab + dragging a link to tab will open the link in the tab + clicking on right upper `x' will current tab + middle button .. close the tab if you clink on the tab + right button .. open menu as usual + +Options: + + open_tab_blank ... open new tab if target is _blank or _new + default: OFF + close_tab_back ... close the tab when you back from last buffer in the tab + default: OFF (= Can't back...) + + + |