diff options
Diffstat (limited to '')
| -rw-r--r-- | lynx.man | 1404 |
1 files changed, 1404 insertions, 0 deletions
diff --git a/lynx.man b/lynx.man new file mode 100644 index 0000000..3b114ca --- /dev/null +++ b/lynx.man @@ -0,0 +1,1404 @@ +.\" $LynxId: lynx.man,v 1.132 2021/03/14 20:42:46 tom Exp $ +.\" ************************************************************************** +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds `` \(lq +.el .ds `` `` +.ie \n(.g .ds '' \(rq +.el .ds '' '' +.de bP +.ie n .IP \(bu 4 +.el .IP \(bu 2 +.. +.de NS +.ie n .sp +.el .sp .5 +.ie n .in +4 +.el .in +2 +.nf +.ft C \" Courier +.. +.de NE +.fi +.ft R +.ie n .in -4 +.el .in -2 +.. +.\" ************************************************************************** +.TH LYNX 1 +.SH NAME +lynx \- a general purpose distributed information browser for the World Wide Web +.SH SYNOPSIS +.B lynx \fI[options] [optional paths or URLs] +.sp +.B lynx \fI[options] [path or URL]\fP \fB\-get_data +.br +.I data +.br +.B \-\- +.sp +.B lynx \fI[options] [path or URL]\fP \fB\-post_data +.br +.I data +.br +.B \-\- +.PP +Use \*(``lynx \-help\*('' to display a complete list of current options. +.SH DESCRIPTION +.hy 0 +.I +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, +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 +.I +Lynx +run on +Unix, VMS, Windows 95/NT/XP/7/8, DOS DJGPP and OS/2. +.PP +.I +Lynx +can be used to access information on the World Wide Web, or +to build information systems intended primarily for local access. +For example, +.I +Lynx +has been used to build several Campus Wide +Information Systems (CWIS). +In addition, +.I +Lynx +can be used to +build systems isolated within a single LAN. +.SH OPTIONS +At start up, \fILynx\fR will load any local +file or remote URL specified at the command line. +For help with URLs, press \*(``\fB?\fR\*('' +or \*(``\fBH\fR\*('' while running \fILynx\fR. +Then follow the link titled, \*(``Help on URLs.\*('' +.PP +If more than one local file or remote URL is listed on the command line, +\fILynx\fP will open only the last interactively. +All of the names (local files and remote URLs) +are added to the \fBG)oto\fP history. +.PP +\fILynx\fR uses only long option names. +Option names can begin with double dash \*(``\-\-\*('' as well, +underscores and dashes can be intermixed in +option names (in the reference below, options +are shown +with one dash \*(``\-\*('' before them, and +with underscores \*(``_\*(''). +.PP +\fILynx\fR provides many command-line options. +Some options require a value (string, number or keyword). +These are noted in the reference below. +The other options set boolean values in the program. +There are three types of boolean options: set, unset and toggle. +If no option value is given, these have the obvious meaning: +set (to true), unset (to false), or toggle (between true/false). +For any of these, an explicit value can be given in different +forms to allow for operating system constraints, +e.g., +.NS +\fB\-center:off\fP +\fB\-center=off\fP +\fB\-center\-\fP +.NE +.PP +\fILynx\fR recognizes +\*(``1\*('', \*(``+\*('', \*(``on\*('' and \*(``true\*('' for true values, and +\*(``0\*('', \*(``\-\*('', \*(``off\*('' and \*(``false\*('' for false values. +Other option-values are ignored. +.PP +The default boolean, number and string option values that are compiled +into \fILynx\fP are displayed in the help-message provided by \fBlynx \-help\fP. +Some of those may differ according to how \fILynx\fP was built; +see the help message itself for these values. +The \fB\-help\fP option is processed in the third pass of options-processing, +so any option which sets a value, +as well as runtime configuration values are reflected in the help-message. +.TP 7 +.B \- +If the argument is only \*(``\-\*('', then \fILynx\fP expects to receive +the arguments from the standard input. +This is to allow for the +potentially very long command line that can be associated +with the \fB\-get_data\fR or \fB\-post_data\fR arguments (see below). +It can also be used to avoid having sensitive information +in the invoking command line (which would be visible to +other processes on most systems), especially when +the \fB\-auth\fR or \fB\-pauth\fR options are used. +.TP +.B \-accept_all_cookies +accept all cookies. +.TP +.B \-anonymous +apply restrictions for anonymous account, see also \fB\-restrictions\fR. +.TP +.B \-assume_charset\fR=\fIMIMEname +charset for documents that do not specify it. +.TP +.B \-assume_local_charset\fR=\fIMIMEname +charset assumed for local files, +i.e., files which \fILynx\fP creates such as +internal pages for the options menu. +.TP +.B \-assume_unrec_charset\fR=\fIMIMEname +use this instead of unrecognized charsets. +.TP +.B \-auth\fR=\fIID\fR:\fIPASSWD +set authorization ID and password for protected documents at startup. +Be sure to protect any script files which use +this switch. +.TP +.B \-base +prepend a request URL comment and BASE tag to text/html +outputs for \fB\-source\fR dumps. +.TP +.B \-bibhost\fR=\fIURL +specify a local bibp server (default http://bibhost/). +.TP +.B \-blink +forces high intensity background colors for color mode, if available +and supported by the terminal. +This applies to the \fBslang\fR library (for a few terminal emulators), +or to OS/2 EMX with \fBncurses\fR. +.TP +.B \-book +use the bookmark page as the startfile. +The default or command +line startfile is still set for the Main screen command, and will +be used if the bookmark page is unavailable or blank. +.TP +.B \-buried_news +toggles scanning of news articles for buried references, and +converts them to news links. +Not recommended because email +addresses enclosed in angle brackets will be converted to +false news links, and uuencoded messages can be trashed. +.TP +.B \-cache\fR=\fINUMBER +set the NUMBER of documents cached in memory. +The default is 10. +.TP +.B \-case +enable case-sensitive string searching. +.TP +.B \-center +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 +lynx.cfg. +.TP +.B \-child +exit on left-arrow in startfile, and disable save to disk and associated +print/mail options. +.TP +.B \-child_relaxed +exit on left-arrow in startfile, but allow save to disk and associated +print/mail options. +.TP +.B \-cmd_log\fR=\fIFILENAME +write keystroke commands and related information to the specified file. +.TP +.B \-cmd_script\fR=\fIFILENAME +read keystroke commands from the specified file. +You can use the data written using the \fB\-cmd_log\fR option. +\fILynx\fP will ignore other information which the command-logging may have +written to the logfile. +Each line of the command script contains either +a comment beginning with \*(``#\*('', +or a keyword: +.RS +.TP 3 +.B exit +causes the script to stop, and forces \fILynx\fP to exit immediately. +.TP +.B key +the character value, in printable form. +Cursor and other special keys are given as names, e.g., \*(``Down Arrow\*(''. +Printable 7-bit ASCII codes are given as-is, +and hexadecimal values represent other 8-bit codes. +.TP +.B set +followed by a \*(``name=value\*('' allows one to override values set in the +lynx.cfg or \&.lynxrc files. +\fILynx\fP tries the cfg-file setting first. +.RE +.TP +.B \-collapse_br_tags +toggles collapsing of BR tags. +.TP +.B \-color +forces color mode on, if available. +Default color control sequences +which work for many terminal types are assumed if the terminal +capability description does not specify how to handle color. +\fILynx\fP needs to be compiled with the \fBslang\fR library for this flag, +it is equivalent to setting the \fBCOLORTERM\fR environment variable. +(If color support is instead provided by a color-capable curses +library like \fBncurses\fR, \fILynx\fP relies completely on the terminal +description to determine whether color mode is possible, and +this flag is not needed and thus unavailable.) +A saved show_color=always setting found in a \&.lynxrc file at +startup has the same effect. +A saved show_color=never found +in \&.lynxrc on startup is overridden by this flag. +.TP +.B \-connect_timeout\fR=\fIN +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. +.TP +.B \-cookie_save_file\fR=\fIFILENAME +specifies a file to use to store cookies. +If none is specified, the value given by +\fB\-cookie_file\fR is used. +.TP +.B \-cookies +toggles handling of Set-Cookie headers. +.TP +.B \-core +toggles forced core dumps on fatal errors. +Turn this option off to ask \fILynx\fP to force +a core dump if a fatal error occurs. +.TP +.B \-crawl +with \fB\-traversal,\fR output each page to a file. +with \fB\-dump\fR, format output as with \fB\-traversal\fR, +but to the standard output. +.TP +.B \-curses_pads +toggles the use of curses \*(``pad\*('' feature which supports +left/right scrolling of the display. +The feature is normally available for curses configurations, +but inactive. +To activate it, use the \*(``|\*('' character or the LINEWRAP_TOGGLE command. +Toggling this option makes the feature altogether unavailable. +.TP +.B \-debug_partial +separate incremental display stages with MessageSecs delay +.TP +.B \-default_colors +toggles the default-colors feature which is normally set in the lynx.cfg file. +.TP +.B \-delay +add DebugSecs delay after each progress-message +.TP +.B \-display\fR=\fIDISPLAY +set the display variable for X rexec-ed programs. +.TP +.B \-display_charset\fR=\fIMIMEname +set the charset for the terminal output. +.TP +.B \-dont_wrap_pre +inhibit wrapping of text when \fB\-dump\fR'ing and \fB\-crawl\fR'ing, +mark wrapped lines of <pre> in interactive session. +.TP +.B \-dump +dumps the formatted output of the default document or those +specified on the command line to standard output. +Unlike interactive mode, all documents are processed. +This can be used in the following way: +.NS +lynx \fB\-dump\fR http://www.subir.com/lynx.html +.NE +.IP +Files specified on the command line are formatted as HTML if +their names end with one of the standard web suffixes such +as \*(``.htm\*('' or \*(``.html\*(''. +Use the \fB\-force_html\fP option to format files whose names do not follow +this convention. +.TP +.B \-editor\fR=\fIEDITOR +enable external editing, using the specified +EDITOR. +(vi, ed, emacs, etc.) +.TP +.B \-emacskeys +enable emacs-like key movement. +.TP +.B \-enable_scrollback +toggles compatibility with communication programs' scrollback keys +(may be incompatible with some curses packages). +.TP +.B \-error_file\fR=\fIFILE +define a file where \fILynx\fP will report HTTP access codes. +.TP +.B \-exec +enable local program execution (normally not configured). +.TP +.B \-fileversions +include all versions of files in local VMS directory listings. +.TP +.B \-find_leaks +toggle memory leak-checking. +Normally this +is not compiled-into your executable, but when it is, +it can be disabled for a session. +.TP +.B \-force_empty_hrefless_a +force HREF-less \*(``A\*('' elements to be empty +(close them as soon as they are seen). +.TP +.B \-force_html +forces the first document to be interpreted as HTML. +.IP +This is most useful when processing files specified on the command line +which have an unrecognized suffix (or the suffix is associated with a +non-HTML type, such as \*(``.txt\*('' for plain text files). +.IP +\fILynx\fP recognizes these file suffixes as HTML: +.NS +\*(``.ht3\*('', +\*(``.htm\*('', +\*(``.html3\*('', +\*(``.html\*('', +\*(``.htmlx\*('', +\*(``.php3\*('', +\*(``.php\*('', +\*(``.phtml\*('', +\*(``.sht\*('', and +\*(``.shtml\*(''. +.NE +.TP +.B \-force_secure +toggles forcing of the secure flag for SSL cookies. +.TP +.B \-forms_options +toggles whether the Options Menu is key-based or form-based. +.TP +.B \-from +toggles transmissions of From headers. +.TP +.B \-ftp +disable ftp access. +.TP +.B \-get_data +properly formatted data for a \fIget\fP form are read in from +the standard input and passed to the form. +Input is terminated by a line that starts with \*(``\-\-\-\*(''. +.IP +\fILynx\fP issues an HTTP \fBGET\fP, +sending the form to the path or URL given on the +command-line and prints the response of the server. +If no path or URL is given, \fILynx\fP sends the form to the start-page. +.TP +.B \-head +send a HEAD request for the mime headers. +.TP +.B \-help +print the \fILynx\fP command syntax usage message, and exit. +.TP +.B \-hiddenlinks=[option] +control the display of hidden links. +.RS +.TP 3 +.B merge +hidden links show up as bracketed numbers +and are numbered together with other links in the sequence of their +occurrence in the document. +.TP +.B listonly +hidden links are shown only on \fBL)ist\fP screens and listings generated by +.B \-dump +or from the \fBP)rint\fP menu, but appear separately at the end of those lists. +This is the default behavior. +.TP +.B ignore +hidden links do not appear even in listings. +.RE +.TP +.B \-historical +toggles use of \*(``>\*('' or \*(``\-\->\*('' as a terminator for comments. +.TP +.B \-homepage\fR=\fIURL +set homepage separate from start page. +.TP +.B \-image_links +toggles inclusion of links for all images. +.TP +.B \-index\fR=\fIURL +set the default index file to the specified URL. +.TP +.B \-ismap +toggles inclusion of ISMAP links when client-side +MAPs are present. +.TP +.B \-justify +do justification of text. +.TP +.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 +.B \-listonly +for \fB\-dump\fR, show only the list of links. +.TP +.B \-localhost +disable URLs that point to remote hosts. +.TP +.B \-locexec +enable local program execution from local files only (if +\fILynx\fP was compiled with local execution enabled). +.TP +.B \-lss\fR=\fIFILENAME +specify filename containing color-style information. +The default is lynx.lss. +If you give an empty filename, \fILynx\fP uses a built-in monochrome +scheme which imitates the non-color-style configuration. +.TP +.B \-mime_header +prints the MIME header of a fetched document along with its +source. +.TP +.B \-minimal +toggles minimal versus valid comment parsing. +.TP +.B \-nested_tables +toggles nested-tables logic (for debugging). +.TP +.B \-newschunksize\fR=\fINUMBER +number of articles in chunked news listings. +.TP +.B \-newsmaxchunk\fR=\fINUMBER +maximum news articles in listings before chunking. +.TP +.B \-nobold +disable bold video-attribute. +.TP +.B \-nobrowse +disable directory browsing. +.TP +.B \-nocc +disable Cc: prompts for self copies of mailings. +Note that this does not disable any CCs which are incorporated +within a mailto URL or form ACTION. +.TP +.B \-nocolor +force color mode off, overriding terminal capabilities and any +\-color flags, COLORTERM variable, and saved \&.lynxrc settings. +.TP +.B \-noexec +disable local program execution. +(DEFAULT) +.TP +.B \-nofilereferer +disable transmissions of Referer headers for file URLs. +.TP +.B \-nolist +disable the link list feature in dumps. +.TP +.B \-nolog +disable mailing of error messages to document owners. +.TP +.B \-nomargins +disable left/right margins in the default style sheet. +.TP +.B \-nomore +disable \-more\- string in statusline messages. +.TP +.B \-nonrestarting_sigwinch +This flag is not available on all systems, +\fILynx\fP needs to be compiled with HAVE_SIGACTION defined. +If available, this flag \fImay\fR cause \fILynx\fP to react +more immediately to window changes when run within +an \fBxterm\fR. +.TP +.B \-nonumbers +disable link- and field-numbering. +This overrides \fB\-number_fields\fR and \fB\-number_links\fR. +.TP +.B \-nopause +disable forced pauses for statusline messages. +.TP +.B \-noprint +disable most print functions. +.TP +.B \-noredir +prevents automatic redirection and prints a message with a +link to the new URL. +.TP +.B \-noreferer +disable transmissions of Referer headers. +.TP +.B \-noreverse +disable reverse video-attribute. +.TP +.B \-nosocks +disable SOCKS proxy usage by a SOCKSified \fILynx\fP. +.TP +.B \-nostatus +disable the retrieval status messages. +.TP +.B \-notitle +disable title and blank line from top of page. +.TP +.B \-nounderline +disable underline video-attribute. +.TP +.B \-number_fields +force numbering of links as well as form input fields +.TP +.B \-number_links +force numbering of links. +.TP +.B \-partial +toggles display partial pages while loading. +.TP +.B \-partial_thres\fR=\fINUMBER +number of lines to render before repainting display +with partial-display logic +.TP +.B \-passive_ftp +toggles passive ftp connections. +.TP +.B \-pauth\fR=\fIID\fR:\fIPASSWD +set authorization ID and password for a protected proxy server at startup. +Be sure to protect any script files which use this switch. +.TP +.B \-popup +toggles handling of single-choice SELECT options via +popup windows or as lists of radio buttons. +.TP +.B \-post_data +properly formatted data for a \fIpost\fP form are read in from +the standard input and passed to the form. +Input is terminated by a line that starts with \*(``\-\-\-\*(''. +.IP +\fILynx\fP issues an HTTP \fBPOST\fP, +sending the form to the path or URL given on the +command-line and prints the response of the server. +If no path or URL is given, \fILynx\fP sends the form to the start-page. +.TP +.B \-preparsed +show HTML source preparsed and reformatted when used with \fB\-source\fR +or in source view. +.TP +.B \-prettysrc +show HTML source view with lexical elements and tags in color. +.TP +.B \-print +enable print functions. +(default) +.TP +.B \-pseudo_inlines +toggles pseudo-ALTs for inline images with no ALT string. +.TP +.B \-raw +toggles default setting of 8-bit character translations +or CJK mode for the startup character set. +.TP +.B \-realm +restricts access to URLs in the starting realm. +.TP +.B \-read_timeout\fR=\fIN +Sets the read-timeout, where N is given in seconds. +.TP +.B \-reload +flushes the cache on a proxy server +(only the first document given on the command-line is affected). +.TP +.B \-restrictions\fR=\fI[option][,option][,option]... +allows a list of services to be disabled selectively. +Dashes and underscores in option names can be intermixed. +The following list is printed if no options are specified. +.RS +.TP 3 +.B all +restricts all options listed below. +.TP +.B bookmark +disallow changing the location of the bookmark +file. +.TP +.B bookmark_exec +disallow execution links via the bookmark file. +.TP +.B change_exec_perms +disallow changing the eXecute permission on files +(but still allow it for directories) when local file +management is enabled. +.TP +.B default +same as command line option \fB\-anonymous\fR. +Disables default services for anonymous users. +Set to all restricted, except for: +inside_telnet, outside_telnet, +inside_ftp, outside_ftp, +inside_rlogin, outside_rlogin, +inside_news, outside_news, telnet_port, +jump, mail, print, exec, and goto. +The settings for these, +as well as additional goto restrictions for +specific URL schemes that are also applied, +are derived from definitions within userdefs.h. +.TP +.B dired_support +disallow local file management. +.TP +.B disk_save +disallow saving to disk in the download and +print menus. +.TP +.B dotfiles +disallow access to, or creation of, hidden (dot) files. +.TP +.B download +disallow some downloaders in the download menu (does not +imply disk_save restriction). +.TP +.B editor +disallow external editing. +.TP +.B exec +disable execution scripts. +.TP +.B exec_frozen +disallow the user from changing the local +execution option. +.TP +.B externals +disallow some \*(``EXTERNAL\*('' configuration lines +if support for passing URLs to external +applications (with the EXTERN command) is +compiled in. +.TP +.B file_url +disallow using \fBG)oto\fP, served links or bookmarks for +file: URLs. +.TP +.B goto +disable the \*(``g\*('' (goto) command. +.TP +.B inside_ftp +disallow ftps for people coming from inside your +domain (utmp required for selectivity). +.TP +.B inside_news +disallow USENET news posting for people coming +from inside your domain (utmp required for selectivity). +.TP +.B inside_rlogin +disallow rlogins for people coming from inside +your domain (utmp required for selectivity). +.TP +.B inside_telnet +disallow telnets for people coming from inside +your domain (utmp required for selectivity). +.TP +.B jump +disable the \*(``j\*('' (jump) command. +.TP +.B multibook +disallow multiple bookmarks. +.TP +.B mail +disallow mail. +.TP +.B news_post +disallow USENET News posting. +.TP +.B options_save +disallow saving options in \&.lynxrc. +.TP +.B outside_ftp +disallow ftps for people coming from outside your +domain (utmp required for selectivity). +.TP +.B outside_news +disallow USENET news reading and posting for people coming +from outside your domain (utmp required for selectivity). +This restriction applies to +\*(``news\*('', +\*(``nntp\*('', +\*(``newspost\*('', and +\*(``newsreply\*('' URLs, +but not to \*(``snews\*('', \*(``snewspost\*('', +or \*(``snewsreply\*('' in case they are supported. +.TP +.B outside_rlogin +disallow rlogins for people coming from outside +your domain (utmp required for selectivity). +.TP +.B outside_telnet +disallow telnets for people coming from +outside your domain (utmp required for selectivity). +.TP +.B print +disallow most print options. +.TP +.B shell +disallow shell escapes and lynxexec or lynxprog \fBG)oto\fP's. +.TP +.B suspend +disallow Unix Control-Z suspends with escape to shell. +.TP +.B telnet_port +disallow specifying a port in telnet \fBG)oto\fP's. +.TP +.B useragent +disallow modifications of the User-Agent header. +.RE +.TP +.B \-resubmit_posts +toggles forced resubmissions (no-cache) of forms with +method POST when the documents they returned are sought +with the PREV_DOC command or from the History List. +.TP +.B \-rlogin +disable recognition of rlogin commands. +.TP +.B \-scrollbar +toggles showing scrollbar. +.TP +.B \-scrollbar_arrow +toggles showing arrows at ends of the scrollbar. +.TP +.B \-selective +require \&.www_browsable files to browse directories. +.TP +.B \-session\fR=\fIFILENAME +resumes from specified file on startup and saves session to that file on exit. +.TP +.B \-sessionin\fR=\fIFILENAME +resumes session from specified file. +.TP +.B \-sessionout\fR=\fIFILENAME +saves session to specified file. +.TP +.B \-short_url +show very long URLs in the status line with \*(``...\*('' to represent the +portion which cannot be displayed. +The beginning and end of the URL are displayed, rather than suppressing the end. +.TP +.B \-show_cfg +Print the configuration settings, +e.g., as read from \*(``lynx.cfg\*('', and exit. +.TP +.B \-show_cursor +If enabled the cursor will not be hidden in the right hand +corner but will instead be positioned at the start of the +currently selected link. +Show cursor is the default for systems without FANCY_CURSES capabilities. +The default configuration can be changed in userdefs.h or lynx.cfg. +The command line switch toggles the default. +.TP +.B \-show_rate +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 +.B 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. +.TP +.B \-source +works the same as dump but outputs HTML source instead of +formatted text. +For example +.NS +lynx \-source\ .\ >foo.html +.NE +.IP +generates HTML source listing the files in the current directory. +Each file is marked by an HREF relative to the parent directory. +Add a trailing slash to make the HREF's relative to the current directory: +.NS +lynx \-source ./ >foo.html +.NE +.TP +.B \-stack_dump +disable SIGINT cleanup handler +.TP +.B \-startfile_ok +allow non-http startfile and homepage with \fB\-validate\fR. +.TP +.B \-stderr +When dumping a document using \fB\-dump\fR or \fB\-source\fR, +\fILynx\fP normally does not display alert (error) +messages that you see on the screen in the status line. +Use the \fB\-stderr\fR option to tell \fILynx\fP to write these messages +to the standard error. +.TP +.B \-stdin +read the startfile from standard input +(UNIX only). +.TP +.B \-syslog\fR=\fItext +information for syslog call. +.TP +.B \-syslog_urls +log requested URLs with syslog. +.TP +.B \-tagsoup +initialize parser, using Tag Soup DTD rather than SortaSGML. +.TP +.B \-telnet +disable recognition of telnet commands. +.TP +.B \-term\fR=\fITERM +tell \fILynx\fP what terminal type to assume it is talking to. +(This may be useful for remote execution, when, for example, +\fILynx\fP connects to a remote TCP/IP port that starts a script that, +in turn, starts another \fILynx\fP process.) +.TP +.B \-timeout\fR=\fIN +For win32, sets the network read-timeout, where N is given in seconds. +.TP +.B \-tlog +toggles between using a \fILynx\fP Trace Log and stderr for trace output +from the session. +.TP +.B \-tna +turns on \*(``Textfields Need Activation\*('' mode. +.TP +.B \-trace +turns on \fILynx\fP trace mode. +Destination of trace output depends +on \-tlog. +.TP +.B \-trace_mask\fR=\fIvalue +turn on optional traces, which may result in very large trace files. +Logically OR the values to combine options: +.RS +.TP 3 +.B 1 +SGML character parsing states +.TP +.B 2 +color-style +.TP +.B 4 +TRST (table layout) +.TP +.B 8 +configuration +(lynx.cfg, +\&.lynxrc, +\&.lynx-keymaps, +mime.types and +mailcap contents) +.TP +.B 16 +binary string copy/append, used in form data construction. +.TP +.B 32 +cookies +.TP +.B 64 +character sets +.TP +.B 128 +GridText parsing +.TP +.B 256 +timing +.TP +.B 512 +detailed URL parsing +.RE +.TP +.B \-traversal +traverse all http links derived from startfile. +When used with +\fB\-crawl\fR, each link that begins with the same string as startfile +is output to a file, intended for indexing. +.IP +See CRAWL.announce for more information. +.TP +.B \-trim_blank_lines +toggles trimming of trailing blank lines as well as +the related trimming of blank lines while collapsing BR tags. +.TP +.B \-trim_input_fields +trim input text/textarea fields in forms. +.TP +.B \-underline_links +toggles use of underline/bold attribute for links. +.TP +.B \-underscore +toggles use of _underline_ format in dumps. +.TP +.B \-unique_urls +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. +Clicking the right mouse button pops back. +Click on the top line to scroll up. +Click on the bottom line to scroll down. +The first few positions in the top and bottom line may invoke +additional functions. +\fILynx\fP must be compiled with +\fBncurses\fR or \fBslang\fR to support this feature. +If \fBncurses\fR is used, clicking the middle mouse button pops up +a simple menu. +Mouse clicks may only work reliably while \fILynx\fP is +idle waiting for input. +.TP +.B \-useragent=Name +set alternate \fILynx\fP User-Agent header. +.TP +.B \-validate +accept only http URLs (for validation). +Complete security restrictions also are implemented. +.TP +.B \-verbose +toggle [LINK], [IMAGE] and [INLINE] comments with filenames of these images. +.TP +.B \-version +print version information, and exit. +.TP +.B \-vikeys +enable vi-like key movement. +.TP +.B \-wdebug +enable Waterloo tcp/ip packet debug (print to watt debugfile). +This applies only to DOS versions compiled with WATTCP or WATT-32. +.TP +.B \-width\fR=\fINUMBER +number of columns for formatting of dumps, default is 80. +This is limited by the number of columns that \fILynx\fP could display, +typically 1024 (the \fIMAX_LINE\fP symbol). +.TP +.B \-with_backspaces +emit backspaces in output if \fB\-dump\fR'ing or \fB\-crawl\fR'ing +(like \fBman\fP does) +.TP +.B \-xhtml_parsing +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 +More than one key can be mapped to a given command. +Here are some of the most useful: +.bP +Use \fBUp arrow\fR and \fBDown arrow\fR to scroll through hypertext links. +.bP +\fBRight arrow\fR or \fBReturn\fR will follow a highlighted hypertext link. +.bP +\fBLeft Arrow\fR or \*(``\fBu\fR\*('' will retreat from a link. +.bP +Type \*(``\fBH\fR\*('', \*(``\fB?\fR\*('', or \fBF1\fR +for online help and descriptions of key-stroke commands. +.bP +Type \*(``\fBk\fR\*('' or \*(``\fBK\fR\*('' for a list of the current key-stroke +command mappings. +.IP +If the same command is mapped to the same letter differing only +by upper/lowercase only the lowercase mapping is shown. +.bP +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, +\fILynx\fR utilizes several \fILynx\fP-specific environment variables, if they +exist. +.PP +Others may be created or modified by \fILynx\fR to pass data to an external +program, or for other reasons. +These are listed separately below. +.PP +See also the sections on \fBSIMULATED CGI SUPPORT\fR and +\fBNATIVE LANGUAGE SUPPORT\fR, below. +.PP +Note: Not all environment variables apply to all types of platforms +supported by \fILynx\fR, though most do. +Feedback on platform dependencies is solicited. +.PP +Environment Variables Used By \fILynx\fR: +.TP 20 +.B COLORTERM +If set, color capability for the terminal is forced on at startup time. +The actual value assigned to the variable is ignored. +This variable is only meaningful if \fILynx\fR was built using the \fBslang\fR +screen-handling library. +.TP +.B LYNX_CFG +This variable, if set, will override the default location and name of +the global configuration file (normally, \fBlynx.cfg\fR) that was defined +by the LYNX_CFG_FILE constant in the userdefs.h file, during installation. +.IP +See the userdefs.h file for more information. +.TP +.B LYNX_CFG_PATH +If set, this variable overrides the compiled-in search-list of directories +used to find the configuration files, e.g., \fBlynx.cfg\fP and \fBlynx.lss\fP. +The list is delimited with ":" (or ";" for Windows) like the \fBPATH\fP +environment variable. +.TP +.B LYNX_HELPFILE +If set, this variable overrides the compiled-in URL and configuration +file URL for the \fILynx\fP help file. +.TP +.B LYNX_LOCALEDIR +If set, this variable overrides the compiled-in location of the +locale directory which contains native language (NLS) message text. +.TP +.B LYNX_LSS +This variable, if set, specifies the location of the default \fILynx\fR +character style sheet file. +[Currently only meaningful if \fILynx\fR was +built using curses color style support.] +.TP +.B LYNX_SAVE_SPACE +This variable, if set, will override the default path prefix for files +saved to disk that is defined in the \fBlynx.cfg SAVE_SPACE:\fR statement. +.IP +See the \fBlynx.cfg\fR file for more information. +.TP +.B LYNX_TEMP_SPACE +This variable, if set, will override the default path prefix for temporary +files that was defined during installation, as well as any value that may +be assigned to the \fBTMPDIR\fR variable. +.TP +.B MAIL +This variable specifies the default inbox \fILynx\fR will check for new +mail, if such checking is enabled in the \fBlynx.cfg\fR file. +.TP +.B NEWS_ORGANIZATION +This variable, if set, provides the string used in the \fBOrganization:\fR +header of \fBUSENET\fR news postings. +It will override the setting of the +ORGANIZATION environment variable, if it is also set (and, on \fBUNIX\fR, +the contents of an /etc/organization file, if present). +.TP +.B NNTPSERVER +If set, this variable specifies the default NNTP server that will be used +for \fBUSENET\fR news reading and posting with \fILynx\fR, via news: URL's. +.TP +.B ORGANIZATION +This variable, if set, provides the string used in the \fBOrganization:\fR +header of \fBUSENET\fR news postings. +On \fBUNIX\fR, it will override the +contents of an /etc/organization file, if present. +.TP +.I PROTOCOL\fB_proxy\fR +\fILynx\fR supports the use of proxy servers that can act as firewall +gateways and caching servers. +They are preferable to the older gateway +servers (see WWW_access_GATEWAY, below). +.IP +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. +.IP +Depending on your system configuration and supported protocols, +the environment variables recognized by \fIlynx\fP may include +.NS +cso_proxy +finger_proxy +ftp_proxy +gopher_proxy +https_proxy +http_proxy +newspost_proxy +newsreply_proxy +news_proxy +nntp_proxy +no_proxy +snewspost_proxy +snewsreply_proxy +snews_proxy +wais_proxy +.NE +.IP +See \fBLynx Users Guide\fR for additional details and examples. +.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 +.B SSL_CERT_FILE +Set to the full path and filename for your file of trusted certificates. +.TP +.B WWW_\fIaccess\fB_GATEWAY +\fILynx\fR still supports use of gateway servers, with the servers specified +via \*(``WWW_\fIaccess\fP_GATEWAY\*('' variables +(where \*(``\fIaccess\fP\*('' is lower case and can be +\*(``http\*('', \*(``ftp\*('', \*(``gopher\*('' or \*(``wais\*(''). +However most gateway servers have been discontinued. +Note that you do not include a terminal \*(``/\*('' for gateways, but +do for proxies specified by \fIPROTOCOL\fP_proxy environment variables. +.IP +See \fBLynx Users Guide\fR for details. +.TP +.B WWW_HOME +This variable, if set, will override the default startup URL specified +in any of the \fILynx\fR configuration files. +.PP +Environment Variables \fBSet\fR or \fBModified\fR By \fILynx\fR: +.TP 20 +.B LYNX_PRINT_DATE +This variable is set by the \fILynx\fR p(rint) function, to the +\fBDate:\fR +string seen in the document's \*(``\fBInformation about\fR\*('' page (= cmd), +if any. +It is created for use by an external program, as defined in a +\fBlynx.cfg PRINTER:\fR definition statement. +If the field does not exist for the document, the variable is set to a +null string under \fBUNIX\fR, or \*(``No Date\*('' under \fBVMS\fR. +.TP +.B LYNX_PRINT_LASTMOD +This variable is set by the \fILynx\fR p(rint) function, to the +\fBLast Mod:\fR +string seen in the document's \*(``\fBInformation about\fR\*('' page (= cmd), +if any. +It is created for use by an external program, as defined in a +\fBlynx.cfg PRINTER:\fR definition statement. +If the field does not exist for the document, the variable is set to a +null string under \fBUNIX\fR, or \*(``No LastMod\*('' under \fBVMS\fR. +.TP +.B LYNX_PRINT_TITLE +This variable is set by the \fILynx\fR p(rint) function, to the +\fBLinkname:\fR +string seen in the document's \*(``\fBInformation about\fR\*('' page (= cmd), +if any. +It is created for use by an external program, as defined in a +\fBlynx.cfg PRINTER:\fR definition statement. +If the field does not exist for the document, the variable is set to a +null string under \fBUNIX\fR, or \*(``No Title\*('' under \fBVMS\fR. +.TP +.B LYNX_PRINT_URL +This variable is set by the \fILynx\fR p(rint) function, to the +\fBURL:\fR +string seen in the document's \*(``\fBInformation about\fR\*('' page (= cmd), +if any. +It is created for use by an external program, as defined in a +\fBlynx.cfg PRINTER:\fR definition statement. +If the field does not exist for the document, the variable is set to a +null string under \fBUNIX\fR, or \*(``No URL\*('' under \fBVMS\fR. +.TP +.B LYNX_TRACE +If set, causes \fILynx\fR to write a trace file as if the \fB\-trace\fR +option were supplied. +.TP +.B LYNX_TRACE_FILE +If set, overrides the compiled-in name of the trace file, +which is either \fBLynx.trace\fP or \fBLY\-TRACE.LOG\fP +(the latter on the DOS/Windows platforms). +The trace file is in either case relative to the home directory. +.TP +.B LYNX_VERSION +This variable is always set by \fILynx\fR, and may be used by an external +program to determine if it was invoked by \fILynx\fR. +.IP +See also the comments +in the distribution's sample \fBmailcap\fR file, for notes on usage in such +a file. +.TP +.B TERM +Normally, this variable is used by \fILynx\fR to determine the terminal type +being used to invoke \fILynx\fR. +If, however, it is unset at startup time +(or has the value \*(``unknown\*(''), +or if the \fB\-term\fR command-line option is used (see \fBOPTIONS\fR section +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 +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 +When executing such \*(``lynxcgi scripts\*('' (if enabled), +the following variables may be set for simulating a CGI environment: +.PP +.B CONTENT_LENGTH +.PP +.B CONTENT_TYPE +.PP +.B DOCUMENT_ROOT +.PP +.B HTTP_ACCEPT_CHARSET +.PP +.B HTTP_ACCEPT_LANGUAGE +.PP +.B HTTP_USER_AGENT +.PP +.B PATH_INFO +.PP +.B PATH_TRANSLATED +.PP +.B QUERY_STRING +.PP +.B REMOTE_ADDR +.PP +.B REMOTE_HOST +.PP +.B REQUEST_METHOD +.PP +.B SERVER_SOFTWARE +.PP +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 +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 +If configured and installed with \fBNative Language Support\fR, \fILynx\fR +will display status and other messages in your local language. +See the +file \fBABOUT_NLS\fR in the source distribution, or at your local \fBGNU\fR +site, for more information about internationalization. +.PP +The following environment variables may be used to alter default settings: +.TP 20 +.B LANG +This variable, if set, will override the default message language. +It is an \fBISO 639\fR two-letter code identifying the language. +Language codes are \fBNOT\fR the same +as the country codes given in \fBISO 3166\fR. +.TP +.B LANGUAGE +This variable, if set, will override the default message language. +This is a \fBGNU\fR extension that has higher priority for setting +the message catalog than \fBLANG\fR or \fBLC_ALL\fR. +.TP +.B LC_ALL +and +.TP +.B LC_MESSAGES +These variables, if set, specify the notion of native language +formatting style. +They are \fBPOSIXly\fR correct. +.TP +.B LINGUAS +This variable, if set prior to configuration, limits the installed +languages to specific values. +It is a space-separated list of two-letter codes. +Currently, it is hard-coded to a wish list. +.TP +.B NLSPATH +This variable, if set, is used as the path prefix for message catalogs. +.SH NOTES +This is the manual for \fILynx\fP v2.9.0dev.5; +development is in progress for 2.9.0. +.PP +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 +in the body of your message. +.PP +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 +\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 +in the Unix environment. +HYPERREZ was developed by Niel Larson of +Think.com and served as the model for the early versions of \fILynx\fP. +Those versions also incorporated libraries from the Unix Gopher clients +developed at the University of Minnesota, and the later versions of +\fILynx\fP rely on the WWW client library code developed by Tim Berners-Lee +and the WWW community. +Also a special thanks to Foteos Macrides who ported +much of \fILynx\fP to VMS and did or organized most of its development since the +departures of Lou Montulli and Garrett Blythe from the University of Kansas +in the summer of 1994 through the release of v2.7.2, and to everyone +on the net who has contributed to \fILynx\fP's development either directly +(through patches, comments or bug reports) or indirectly +(through inspiration and development of other systems). +.SH AUTHORS +Lou Montulli, Garrett Blythe, Craig Lavender, Michael Grobe, Charles Rezac +.br +Academic Computing Services +.br +University of Kansas +.br +Lawrence, Kansas 66047 +.PP +Foteos Macrides +.br +Worcester Foundation for Biomedical Research +.br +Shrewsbury, Massachusetts 01545 +.PP +Thomas E.\& Dickey +.br +<dickey@invisible\-island.net> |