owner=Michael Grobe
%%owner_address=grobe@ukanaix.cc.ukans.edu
%%owner_info=University of Kansas, Academic Computing Services
link_delimiter=<


		   Summary of the Lynx Link Syntax

This section presents the syntax for links  recognized by Lynx.  Under
some conditions Lynx will ignore links that  fit  the syntax  as it is
presented below.   For  example, if any  of  the  defined data  fields
(filenames, character  counts,  or   target  strings)   exceed certain
limits, Lynx will treat a link as non-link text.


Link to a local file:

	link_delimiter   pathname   token_delimiter   character_count
		token_delimiter   target_string
			end_delimiter

	Example:		<<pathname:99:target_string>



Link to a file on a Gopher server:

	link_delimiter   gopher_filetype - gopher_pathname
		@hostname   gopher_port    
			token_delimiter   character_count
				token_delimiter   target_string
					end_delimiter

	Examples:	<<0-0/cs200@kugopher1 70:99:target_string>
			<<0-0/IBM/COMPARISION@gopher.micro.umn.edu 153>

The default gopher_port is 70,  but  may be reset  on the Lynx command
line, so it should be explicitly specified.



Comment link:

	link_delimiter   *   comment_text   end_delimiter

	Example:	

	<<* This file points to files on the database server. >



Link to execute a local shell command or script:

	link_delimiter   !   program_path   program_arguments
		token_delimiter   character_count
			token_delimiter   target_string
				end_link_delimiter

where program_path may  be the pathname of a  local command or one  of
TELNET,    TN3270, or RLOGIN.   If   a  local  command   is specified,
program_arguments  will   be passed  to it.  If  one of   the standard
programs is specified, the  program_path and program_arguments  should
look like:

	TELNET  hostname  [port_number]
	TN3270  hostname  [port_number]
	RLOGIN  hostname  [-user=xxxxx]   [-password=yyyyy]

	Examples:
		<<!man -k info:16>More Information
		<<!man -k fortran  \>LYNX:16:xlf>For Fortran Info
		<<!program_path  pathname\@hostname :99:target_string>
		<<!TELNET kufacts.cc.ukans.edu>Connect to the KU CWIS!
		<<!TN3270 ukanvm>Connect to the KU VM system.
		<<!RLOGIN kufacts -user kufacts>Connect to the KU CWIS!

The string LYNX   appearing  in program_arguments  as \>LYNX  will  be
replaced with the name of a local temporary file.   Any character used
by   Lynx to delimit  link  information  (e.g.,  the  link  and target
delimiters, the colon, or the at-sign (@) appearing in a command to be
executed must be preceded   by a  backslash (\).   The string  DISPLAY
appearing in program_arguments  will be  replaced with  the  user's  X
windows display  address if it  can be  determined  (usually  from the
execution environment variable DISPLAY on UN*X systems).


Link to connect to a program listening on a (remote) socket:

	link_delimiter   !   port@hostname   end_delimiter

	Example:	<<!7777@ukanaix.cc.ukans.edu:99>


Link to connect to a gopher server:

	link_delimiter   1-@hostname
		token_delimiter   character_count
			token_delimiter   target_string
				end_link_delimiter

	Examples:	<<1-@ukanaix.cc.ukans.edu  70>KU Gopher server

The default value of gopher_port is 70 for these  links, but it may be
reset on the   Lynx command line, so  the  port  should  be explicitly
specified to avoid confusion.


Link to execute a remote program (particularly an X Windows client):

	link_delimiter   !   program_path   program_arguments 
		@hostname   -user login_name
			token_delimiter   character_count
				token_delimiter   target_string
					end_link_delimiter

	or

	link_delimiter   !   program_path   program_arguments  
		@hostname   -user login_name   -password   login_password
			token_delimiter   character_count
				token_delimiter   target_string
					end_link_delimiter

	Examples:

	<<!events  @kurexec.cc.ukans.edu  -user=rexec>
	<<!man  print  \>LYNX  @hostname  -user  info::enq>
	<<!xevents -display DISPLAY @kurexec.cc.ukans.edu -user rexec>

The  string  DISPLAY appearing  in program_arguments  will be replaced
with  the user's X  windows display address if  it  can be  determined
(usually   from  the execution  environment  variable  DISPLAY on UN*X
systems).  Likewise, the string LYNX appearing in program_arguments as
\>LYNX will be replaced with the name of a local temporary file.   Any
character used by Lynx to delimit link information (e.g., the link and
target delimiters,   the colon,  or  the at-sign   (@)  appearing in a
command to be executed must be preceded by a backslash (\).


Links reserved for future development:

	link_delimiter   #	Text	end_delimiter

	link_delimiter   %	Text	end_delimiter

	Examples:	<<#   Reserved for future use.   >
			<<%   Reserved for future use.   >

