diff -ru links-0.96/links.1 links-0.96+newmanpage/links.1 --- links-0.96/links.1 Sun Dec 31 23:26:52 2000 +++ links-0.96+newmanpage/links.1 Sat Oct 6 14:53:51 2001 @@ -1,13 +1,19 @@ .\" Process this file with groff -man -Tascii links.1 -.TH LINKS 1 "Dec, 2000" +.TH LINKS 1 "Oct, 2001" + + .SH NAME links \- lynx-like alternative character mode WWW browser + + .SH SYNOPSIS .B links .I "[options] URL" + + .SH DESCRIPTION .B links -is a text mode WWW browser with ncurses interface, supporting +is a text mode WWW browser, supporting colors, correct table rendering, background downloading, menu driven configuration interface and slim code. .P @@ -16,41 +22,49 @@ are supported via external clients. .P .I links -can handle local (file://) or remote (http:// or ftp://) URLs. +can handle local (file://) or remote (http://, ftp:// or https:// +if there's compiled-in SSL support) URLs. .PP + .SH OPTIONS Most options can be set in the user interface or config file, so usually you do not need to care about them. .TP -\f3-async-dns \f2<0>/<1>\f1 -Asyncronous DNS resolver on(1)/off(0). +\f3-anonymous\f1 +Restrict links so that it can run on an anonymous account. +No local file browsing. No downloads. Executing of viewers +is allowed, but user can't add or modify entries in +association table. .TP -\f3-max-connections \f2\f1 -Maximum number of concurrent connections. -(default: 10) +\f3-assume-codepage \f2\f1 +Use the given codepage when the webpage did not specify +its codepage. (default: ISO 8859-1) .TP -\f3-max-connections-to-host \f2\f1 -Maximum number of concurrent connection to a given host. -(default: 2) +\f3-async-dns \f2<0>/<1>\f1 +Asynchronous DNS resolver on(1)/off(0). Default is on. .TP -\f3-retries \f2\f1 -Number of retries. -(default: 3) +\f3-base-session \f2\f1 +Linkses are connecting together, forming sessions by default. Normally, +there's only one session with number 0. In this way, you can make him +to form more sessions at once. See also \f3-no-connect\f1 option. .TP -\f3-receive-timeout \f2\f1 -Timeout on receive. -(default: 120) +\f3-download-dir \f2\f1 +Default download directory. +(default: actual dir) .TP -\f3-unrestartable-receive-timeout \f2\f1 -Timeout on non restartable connections. -(default: 600) +\f3-download-utime \f2<0>/<1>\f1 +Set time of download files on(1)/off(0). Default is off. + +.TP +\f3-dump\f1 +Write a plain-text version of the given HTML document to stdout. .TP \f3-format-cache-size \f2\f1 @@ -58,62 +72,97 @@ (default: 5) .TP -\f3-memory-cache-size \f2\f1 -Cache memory in Kilobytes. -(default: 1024) +\f3-ftp.anonymous-password \f2\f1 +Use this as the password for anonymous ftp sites. .TP -\f3-http-proxy \f2\f1 -Host and port number of the HTTP proxy, or blank. +\f3-ftp-proxy \f2\f1 +Host and port number of the FTP proxy, or blank. (default: blank) .TP -\f3-ftp-proxy \f2\f1 -Host and port number of the FTP proxy, or blank. +\f3-help\f1 +Print a help screen. + +.TP +\f3-http-bugs.http10 \f2<0>/<1>\f1 +Turn use of HTTP/1.0 on(1)/off(0). Default is off. + +.TP +\f3-http-bugs.allow-blacklist \f2<0>/<1>\f1 +Turn blacklist of buggy servers on(1)/off(0). Default is on. + +.TP +\f3-http-bugs.bug-302-redirect \f2<0>/<1>\f1 +Turn broken redirect 302 (violates RFC, but compatible with Netscape) +on(1)/off(0). Default is off. + +.TP +\f3-http-bugs.bug_post-no-keepalive \f2<0>/<1>\f1 +Turn no keepalive connection after POST request (for some buggy +PHP databases) on(1)/off(0). Default is off. + +.TP +\f3-http-proxy \f2\f1 +Host and port number of the HTTP proxy, or blank. (default: blank) .TP -\f3-download-dir \f2\f1 -Default download directory. -(default: actual dir) +\f3-language \f2\f1 +Language to use in user interface. .TP -\f3-assume-codepage \f2\f1 -Use the given codepage when the webpage did not specify -its codepage. (default: ISO 8859-1) +\f3-max-connections \f2\f1 +Maximum number of concurrent connections. +(default: 10) .TP -\f3-anonymous\f1 -Restrict links so that it can run on an anonymous account. -No local file browsing. No downloads. Executing of viewers -is allowed, but user can't add or modify entries in -association table. +\f3-max-connections-to-host \f2\f1 +Maximum number of concurrent connection to a given host. +(default: 2) .TP -\f3-dump\f1 -Write a plain-text version of the given HTML document to stdout. +\f3-memory-cache-size \f2\f1 +Cache memory in Kilobytes. +(default: 1024) .TP \f3-no-connect\f1 Runs links as a separate instance - instead of connecting to -existing instance. +existing instance. Prevents him to connecting to an existing session. +See also \f3-base-session\f1 option. + +.TP +\f3-receive-timeout \f2\f1 +Timeout on receive. +(default: 120) + +.TP +\f3-retries \f2\f1 +Number of retries. +(default: 3) .TP \f3-source\f1 Write the given HTML document in source form to stdout. .TP +\f3-unrestartable-receive-timeout \f2\f1 +Timeout on non restartable connections. +(default: 600) + +.TP \f3-version\f1 Print the .I links version number and exit. -.TP -\f3-help\f1 -Print a help screen. .SH NAVIGATION KEYS -The keys you may use while navigating are +You may optionally prefix each of this keys with a number, telling its +repeat count (how much times to do it). You can also re-bind those keys, +altough this feature is still in the state of testing, so undocumented. +The keys you may use for navigation are: .TP .B PGDN page down @@ -227,16 +276,16 @@ quit .TP .B = -document informations +document information .TP .B | -header informations +header information .TP .B \e toggle HTML source/rendered view .TP .B * -toggle display images +toggle display of images .TP .B TAB next frame @@ -250,6 +299,7 @@ .B F10 file menu + .SH EDITING KEYS The following keys can be used while editing a line/jumping to a URL: .TP @@ -260,16 +310,16 @@ move left .TP .B HOME -jump at the beginning +jump to the beginning .TP .B ^A -jump at the beginning +jump to the beginning .TP .B END -jump at the end +jump to the end .TP .B ^E -jump at the end +jump to the end .TP .B ^INS copy to clipboard @@ -308,32 +358,93 @@ auto complete line +.SH ENVIRONMENT +.TP + +.IP CONFIG_DIR +The location of ".links/" + +.IP WWW_HOME +Homepage location (as in +.B lynx +) + +.IP LINKS_XTERM +The command to run when selecting "File/New window" and if +.B DISPLAY +is defined (default "xterm -e") + +.IP LINKS_TWTERM +The command to run when selecting "File/New window" and if +.B TWDISPLAY +is defined (default "twterm -e") +.IP SHELL +Used for "File/OS Shell" menu + +.IP COMSPEC +Used for "File/OS Shell" menu in DOS/Windows .SH FILES .TP -.IP "~/.links/.links.cfg" -Per-user configfile, automatically created by + +.IP "~/.links/links.cfg" +Per-user config file, automatically created by +.B links. +Its format is same as the one of +.I user.cfg. + +.IP "~/.links/html.cfg" +Per-user config file, automatically created by .B links. +It contains HTML rendering options. Its format is same as the one of +.I user.cfg. + +.IP "~/.links/user.cfg" +Per-user config file, not overwritten while saving +.B links +configuration. You can add your own options there (e.g. keybindings). +Each line consists from option name (same as the command-line one, +but without leading dash and with dashes converted to underscores), +space, and its value, in quotes if it's a string. Lines which start +with # are considered as comments and skipped. + +.IP "~/.links/bookmarks" +Bookmarks file + +.IP "~/.links/links.his" +Sites history file + +.IP "~/.links/socket" +Internal links socket for communication between its instances. + + .SH PLATFORMS .B links -is known to work on Linux, FreeBSD, Solaris, IRIX, HPUX, Digital Unix, AIX, +is known to work on Linux, FreeBSD, OpenBSD, Solaris, IRIX, HPUX, Digital Unix, AIX, OS/2 and BeOS. Port for Win32 is in state of beta testing. + + .SH BUGS Can't connect to some FTP servers (Novell, NT). Connection stays in "Request sent" state. .PP -Frames don't work if there's more frames with same name. Turn them off in such +Frames don't work if there're more frames with same name. Turn them off in such case. .PP You can't upload large files; it takes _lots_ of memory. .PP -You shoudn't press '^Z' when you are in a viewer +You shouldn't press '^Z' when you are in a viewer .PP -Please report any other bugs you find to Mikulas Patocka - +Please report any other bugs you find to +.B Mikulas Patocka +.BI +or to +.B links mailing list +.BI . + .SH LICENSE .B links @@ -342,14 +453,15 @@ the Free Software Foundation; either version 2 of the License, or (at your option) any later version. + .SH AUTHOR .I links was written by .B Mikulas Patocka .BI . See file -.I Authors -for a list of people contributing to this project. +.I AUTHORS +in the source tree for a list of people contributing to this project. .P The homepage of links can be found at .BI http://links.browser.org/ @@ -359,7 +471,11 @@ .I links fan for the Debian GNU/Linux system (but may be used by others). +Contributions from Francis A. Holop. Extended, clarified +and made more up-to-date by Petr Baudis . + .SH "SEE ALSO" .BR lynx (1), -.BR w3m (1) +.BR w3m (1), +.BR wget (1)