diff options
Diffstat (limited to 'upstream/archlinux/man1/lynx.1')
| -rw-r--r-- | upstream/archlinux/man1/lynx.1 | 179 |
1 files changed, 113 insertions, 66 deletions
diff --git a/upstream/archlinux/man1/lynx.1 b/upstream/archlinux/man1/lynx.1 index ff4eb1b8..ae704a3c 100644 --- a/upstream/archlinux/man1/lynx.1 +++ b/upstream/archlinux/man1/lynx.1 @@ -1,12 +1,27 @@ -.\" $LynxId: lynx.man,v 1.123 2018/07/08 10:54:20 tom Exp $ +.\" $LynxId: lynx.man,v 1.160 2024/04/15 20:53:51 tom Exp $ .\" ************************************************************************** -.\" Escape single quotes in literal strings from groff's Unicode transform. -.ie \n(.g .ds AQ \(aq -.el .ds AQ ' -.ie \n(.g .ds `` \(lq -.el .ds `` `` -.ie \n(.g .ds '' \(rq -.el .ds '' '' +.TH LYNX 1 2024-04-15 "Lynx 2.9.1" "Lynx \(en the \fItext\fP web browser" +. +.ie \n(.g \{\ +.ds `` \(lq +.ds '' \(rq +.ds ' \(aq +.\} +.el \{\ +.ie t .ds `` `` +.el .ds `` "" +.ie t .ds '' '' +.el .ds '' "" +.ie t .ds ' \(aq +.el .ds ' ' +.\} +. +.ie n .ds CW R +.el \{ +.ie \n(.g .ds CW CR +.el .ds CW CW +.\} +. .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 @@ -17,7 +32,7 @@ .ie n .in +4 .el .in +2 .nf -.ft C \" Courier +.ft \*(CW .. .de NE .fi @@ -26,9 +41,9 @@ .el .in -2 .. .\" ************************************************************************** -.TH LYNX 1 .SH NAME -lynx \- a general purpose distributed information browser for the World Wide Web +lynx \- +a general purpose distributed information browser for the World Wide Web .SH SYNOPSIS .B lynx \fI[options] [optional paths or URLs] .sp @@ -52,17 +67,20 @@ Lynx is a fully-featured World Wide Web (WWW) client for users running cursor-addressable, character-cell display devices (e.g., vt100 terminals, -vt100 emulators running on Windows 95/NT/XP/7/8 or any POSIX platform, +vt100 emulators running on Windows or any POSIX platform, or any other \*(``curses-oriented\*('' display). It will display hypertext markup language (HTML) documents containing links to files residing on the local system, as well as files residing on remote systems running Gopher, HTTP, FTP, WAIS, and NNTP servers. -Current versions of +.PP .I Lynx -run on -Unix, VMS, Windows 95/NT/XP/7/8, DOS DJGPP and OS/2. +has been ported to many systems, +including all variants of Unix, +Windows (since Windows 95), +DOS DJGPP and OS/2, +as well as VMS and OS/390. .PP .I Lynx @@ -194,7 +212,10 @@ The default is 10. enable case-sensitive string searching. .TP .B \-center -Toggle center alignment in HTML TABLE. +toggles center alignment in HTML TABLE. +Normally table cells are centered on the table grid. +Set this option \*(``on\*('' to disable centering. +The default is \*(``off\*(''. .TP .B \-cfg\fR=\fIFILENAME specifies a \fILynx\fP configuration file other than the default @@ -260,8 +281,8 @@ Sets the connection timeout, where N is given in seconds. .TP .B \-cookie_file\fR=\fIFILENAME specifies a file to use to read cookies. -If none is specified, the default value is ~/.lynx_cookies -for most systems, but ~/cookies for MS-DOS. +If none is specified, the default value is \s+3~\s-3/.lynx_cookies +for most systems, but \s+3~\s-3/cookies for MS-DOS. .TP .B \-cookie_save_file\fR=\fIFILENAME specifies a file to use to store cookies. @@ -444,6 +465,9 @@ do justification of text. .B \-link\fR=\fINUMBER starting count for lnk#.dat files produced by \fB\-crawl\fR. .TP +.B \-list_decoded +for \fB\-dump\fR, show URL-encoded links decoded. +.TP .B \-list_inline for \fB\-dump\fR, show the links inline with the text. .TP @@ -804,6 +828,18 @@ If enabled the transfer rate is shown in bytes/second. If disabled, no transfer rate is shown. Use lynx.cfg or the options menu to select KB/second and/or ETA. .TP +.B \-socks5_proxy=URL +(Via which) SOCKS5 proxy to connect: any network traffic, including all +DNS resolutions but the one for URL itself, will be redirected through +the SOCKS5 proxy. +URL may be given as \*(``proxy.example.com\*('', +\*(``proxy.example.com:1080\*('', \*(``192.168.0.1\*('', or +\*(``192.168.0.1:1080\*('' (and IPv6 notation if so supported). +A SOCKS5 proxy may also be specified via the environment variable +.BR SOCKS5_PROXY . +This option controls the builtin SOCKS5 support, which is unrelated to +the option \fB\-nosocks\fP. +.TP .B \-soft_dquotes toggles emulation of the old Netscape and Mosaic bug which treated \*(``>\*('' as a co-terminator for double-quotes and tags. @@ -813,7 +849,7 @@ works the same as dump but outputs HTML source instead of formatted text. For example .NS -lynx \-source . >foo.html +lynx \-source\ .\ >foo.html .NE .IP generates HTML source listing the files in the current directory. @@ -909,6 +945,9 @@ GridText parsing .TP .B 256 timing +.TP +.B 512 +detailed URL parsing .RE .TP .B \-traversal @@ -937,6 +976,11 @@ check for duplicate link numbers in each page and corresponding lists, and reuse the original link number. .TP +.B \-update_term_title +enables updating the title in terminal emulators. +Use only if your terminal emulator supports that escape code. +Has no effect when used with \fB\-notitle\fP. +.TP .B \-use_mouse turn on mouse support, if available. Clicking the left mouse button on a link traverses it. @@ -986,7 +1030,6 @@ tells \fILynx\fP that it can ignore certain tags which have no content in an XHTML 1.0 document. For example \*(``<p/>\*('' will be discarded. .SH COMMANDS -.PP More than one key can be mapped to a given command. Here are some of the most useful: .bP @@ -1008,7 +1051,13 @@ by upper/lowercase only the lowercase mapping is shown. Type \fBDelete\fR to view history list. .SH ENVIRONMENT In addition to various \*(``standard\*('' environment variables such as -\fBHOME\fR, \fBPATH\fR, \fBUSER\fR, \fBDISPLAY\fR, \fBTMPDIR\fR, \fBetc\fR, +\fBDISPLAY\fR, +\fBHOME\fR, +\fBPATH\fR, +\fBSHELL\fR, +\fBTMPDIR\fR, +\fBUSER\fR, +etc., \fILynx\fR utilizes several \fILynx\fP-specific environment variables, if they exist. .PP @@ -1100,8 +1149,8 @@ Each protocol used by \fILynx\fR, (http, ftp, gopher, etc), can be mapped separately by setting environment variables of the form \fIPROTOCOL\fP_proxy. Protocols are indicated in a URI by the name before \*(``:\*('', e.g., -\*(``http\*('' in -\*(``http://some.server.dom:port/\*('' for HTML. +\*(``http\*('' in +\*(``http://some.server.dom:port/\*('' for HTML. .IP Depending on your system configuration and supported protocols, the environment variables recognized by \fIlynx\fP may include @@ -1110,21 +1159,36 @@ cso_proxy finger_proxy ftp_proxy gopher_proxy -https_proxy http_proxy +https_proxy +news_proxy newspost_proxy newsreply_proxy -news_proxy nntp_proxy no_proxy +rlogin_proxy +snews_proxy snewspost_proxy snewsreply_proxy -snews_proxy +telnet_proxy +tn3270_proxy wais_proxy .NE .IP See \fBLynx Users Guide\fR for additional details and examples. .TP +.B RL_CLCOPY_CMD +Pipe the contents of the current link using this command as the target. +.TP +.B RL_PASTE_CMD +Open a pipe to read from this command, +pasting it into the current editable-field or command-prompt. +.TP +.B SOCKS5_PROXY +Is inspected if +.B \-socks5_proxy +has not been used (for the same content). +.TP .B SSL_CERT_DIR Set to the directory containing trusted certificates. .TP @@ -1216,7 +1280,7 @@ above), \fILynx\fR will set or modify its value to the user specified terminal type (for the \fILynx\fR execution environment). Note: If set/modified by \fILynx\fR, the values of the \fBLINES\fR and/or \fBCOLUMNS\fR environment variables may also be changed. -.SH SIMULATED CGI SUPPORT +.SS "Simulated CGI Support" If built with the \fBcgi-links\fR option enabled, \fILynx\fR allows access to a cgi script directly without the need for an http daemon. .PP @@ -1252,12 +1316,12 @@ the following variables may be set for simulating a CGI environment: Other environment variables are not inherited by the script, unless they are provided via a LYNXCGI_ENVIRONMENT statement in the configuration file. See the \fBlynx.cfg\fR file, and the (draft) CGI 1.1 Specification -<http://Web.Golux.Com/coar/cgi/draft-coar-cgi-v11-00.txt> for the +<http://Web.Golux.Com/coar/cgi/draft\-coar\-cgi\-v11\-00.txt> for the definition and usage of these variables. .PP The CGI Specification, and other associated documentation, should be consulted for general information on CGI script programming. -.SH NATIVE LANGUAGE SUPPORT +.SS "Native Language Support" If configured and installed with \fBNative Language Support\fR, \fILynx\fR will display status and other messages in your local language. See the @@ -1294,49 +1358,21 @@ Currently, it is hard-coded to a wish list. .B NLSPATH This variable, if set, is used as the path prefix for message catalogs. .SH NOTES -This is the \fILynx\fP v2.8.9 Release; development is in progress for 2.9.0. -.PP +.SS "Mailing Lists" If you wish to contribute to the further development of \fILynx\fR, subscribe to our mailing list. Send email to -<lynx-dev-request@nongnu.org> with \*(``subscribe lynx-dev\*('' as the only line +<lynx\-dev\-request@nongnu.org> +with \*(``subscribe lynx\-dev\*('' as the only line in the body of your message. .PP -Send bug reports, comments, suggestions to <lynx-dev@nongnu.org> +Send bug reports, comments, suggestions to <lynx\-dev@nongnu.org> after subscribing. .PP -Unsubscribe by sending email to <lynx-dev-request@nongnu.org> with -\*(``unsubscribe lynx-dev\*('' as the only line in the body of your message. -Do not send the unsubscribe message to the lynx-dev list, itself. -.SH SEE ALSO -.hy 0 -\fBcatgets\fR(3), -\fBcurses\fR(3), -\fBenviron\fR(7), -\fBexecve\fR(2), -\fBftp\fR(1), -\fBgettext\fR(GNU), -\fBlocaleconv\fR(3), -\fBncurses\fR(3), -\fBsetlocale\fR(3), -\fBslang\fR(?), -\fBtermcap\fR(5), -\fBterminfo\fR(5), -\fBwget\fR(GNU) -.hy 1 -.PP -Note that man page availability and section numbering is somewhat -platform dependent, and may vary from the above references. -.PP -A section shown as (GNU), is intended to denote that the topic -may be available via an info page, instead of a man page (i.e., try -\*(``info subject\*('', rather than \*(``man subject\*(''). -.PP -A section shown as \fB(?)\fP denotes that documentation on the topic exists, -but is not part of an established documentation retrieval system (see -the distribution files associated with the topic, or contact your -System Administrator for further information). -.SH ACKNOWLEDGMENTS +Unsubscribe by sending email to <lynx\-dev\-request@nongnu.org> with +\*(``unsubscribe lynx\-dev\*('' as the only line in the body of your message. +Do not send the unsubscribe message to the lynx\-dev list, itself. +.SS Acknowledgments \fILynx\fP has incorporated code from a variety of sources along the way. The earliest versions of \fILynx\fP included code from Earl Fogel of Computing Services at the University of Saskatchewan, who implemented HYPERREZ @@ -1371,4 +1407,15 @@ Shrewsbury, Massachusetts 01545 .PP Thomas E.\& Dickey .br -<dickey@invisible-island.net> +<dickey@invisible\-island.net> +.SH SEE ALSO +\fB\%catgets\fR(3), +\fB\%curses\fR(3), +\fB\%environ\fR(7), +\fB\%ftp\fR(1), +\fB\%gettext\fR(GNU), +\fB\%localeconv\fR(3), +\fB\%ncurses\fR(3), +\fB\%setlocale\fR(3), +\fB\%termcap\fR(5), +\fB\%terminfo\fR(5) |