home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / LYNXOS27 / LYNXOS27.ZIP / readme.os2 < prev    next >
Text File  |  1997-02-16  |  12KB  |  312 lines
  1.                           Lynx/2 - Beta version 0.7
  2.  
  3. INTRODUCTION
  4.  
  5. Lynx/2 is a fully-featured World Wide Web (WWW) client for OS/2 text mode 
  6. sessions.  It will display hypertext markup language (HTML) documents 
  7. containing links to files residing on the local system as well as files 
  8. residing on remote systems running Gopher, HTTP, FTP, and NNTP servers.  
  9. Lynx/2 may also be used with Telnet, TN3270, and Rlogin clients.
  10.  
  11. Other current versions of Lynx run on UNIX and VMS.  A Beta version for DOS
  12. is also available.  See the accompanying Lynx documentation for more details.
  13.  
  14. Lynx/2 is based on the 2-4-1 release of Lynx.
  15.  
  16. WHY BOTHER?
  17.  
  18. I mean, isn't Webexplorer a much better WWW browser than any text-based 
  19. program could be?  Well, yes, but that doesn't mean that there's not a place 
  20. for Lynx/2 as well.  Lynx/2 can be used as a BBS Door, providing BBS users 
  21. with a way to cruise the Web.  Because Lynx/2 doesn't bother loading all 
  22. that graphics nonsense, it's very quick.  And I use it to ensure that the 
  23. WWW pages designed by Decker Automation look OK to the text-based world.
  24.  
  25. Plus, I had some time between paying gigs, and needed something to do.  
  26. What's your favorite excuse for using Lynx/2 instead of a graphical 
  27. browser?  I'd sure like to know!
  28.  
  29. INSTALLATION
  30.  
  31. Unzip this file in a directory of your choice.  It is best if the directory
  32. that Lynx/2 is installed in is in the PATH. The file tree should be created 
  33. as follows:
  34.  
  35.     acro.cmd
  36.     bookmark.htm
  37.     buzlynx.ico
  38.     gif.cmd
  39.     inews.cmd
  40.     LYNX.CFG
  41.     lynx.cmd
  42.     lynx.exe
  43.     lynx_2.inf
  44.     lynxcp.exe
  45.     lynxmv.exe
  46.     lynxos25.txt
  47.     lynxrc
  48.     prt.cmd
  49.     readme.os2
  50.     sayit.cmd
  51.         sendmail.lyx
  52.     setup.cmd
  53.     
  54.     about dir:
  55.         about_ly.htm
  56.         readme.htm
  57.     docs dir:
  58.         readme.htm
  59.         readme.txt
  60.         rfc-mail.txt
  61.     help dir:
  62.         keystrok.com
  63.         lynx_hel.htm
  64.         lynx_use.htm    
  65.  
  66.     help\keystrok.com dir:
  67.             bookmark.htm
  68.             dired_he.htm
  69.             gopher_t.htm
  70.             history_.htm
  71.             keystrok.htm
  72.             movement.htm
  73.             option_h.htm
  74.             other_he.htm
  75.             print_he.htm
  76.             scrollin.htm
  77.             xterm_he.htm
  78.     Samples dir:
  79.         jumpsuni.htm
  80.         jumpsvms.htm
  81.         lynx.cfg
  82.         lynx.com
  83.         mime.typ
  84.         new_inst.htm
  85.         readme.htm
  86.     test dir:
  87.         iso_lati.htm
  88.         readme.txt
  89.  
  90. Lynx/2 requires the EMXRT 0.9c runtime libraries to run. These should be 
  91. available from the same FTP site you obtained Lynx/2 from.
  92.  
  93. All of the files required for proper operation of Lynx/2 meet the criteria 
  94. for 8.3 FAT compatibility.  Now, all of the temp files produced by Lynx/2 do
  95. as well.    
  96.  
  97. Lynx/2 uses environment variables (those things you set with the SET command
  98. in config.sys) in order to find its ancillary files.  In particular, Lynx/2
  99. will use files named bookmark.htm and lynxrc in the HOME directory, and a
  100. configuration file named lynx.cfg in the ETC directory.  Lynx/2 will also 
  101. put it's temporary files in the directory pointed to by the TMP environment
  102. variable, so there's no need to have a TMP dir under the current working dir
  103. when running Lynx/2.  
  104.  
  105. The next step in the installation procedure is to run setup.cmd. Setup.cmd is
  106. a rudimentary setup script - it checks for the presence of HOME, TMP, and ETC 
  107. environment variables, and if they are all present, copies the correct files
  108. to the correct directories and exits, reminding you to ensure to include the
  109. directory Lynx/2 is installed in in the path.  If it does not find everything
  110. it's looking for, it will complain and exit.  If you should be the recipient
  111. of such complaints, please set up the appropriate environment variables in your
  112. config.sys file, reboot, and run setup.cmd again.
  113.  
  114. If you wish to be able to read/post news with Lynx/2, you may need to add an
  115. additional environment variable to your config.sys.  Lynx/2, and its associated
  116. news posting utility, Inews.cmd, use a default of 'news.' for an NNTP server 
  117. address, which works in a surprisingly large number of cases.  If, however,
  118. this does not work for you, place a 
  119.     
  120.     "SET NNTPSERVER=news.myserver.com"
  121.  
  122. (with, of course, the proper address for your newsserver) in your config.sys, and
  123. both Lynx/2 and Inews.cmd will receive and post news correctly.
  124.  
  125. The final step for installation is to edit the lynx.cfg file to reflect 
  126. the setup for your local site.  In particular, the LOCAL_DOMAIN entry 
  127. should be changed to reflect your local domain name.  You may wish to 
  128. modify the PRINTER entry "HP Deskjet", which reflects my personal 
  129. configuration.  The usage of the included prt.cmd file for printing is
  130. encouraged. Documentation for all the lynx.cfg entries may be found 
  131. within the file itself.  There is additional documentation on the 
  132. lynx.cfg file in the LYNX_2.INF file included in the distribution.
  133.  
  134.  
  135. RUNNING LYNX/2
  136.  
  137. Start Lynx/2 by typing "lynx" at the command line, after ensuring that 
  138. you are connected to the Internet.  Lynx should start and automatically 
  139. connect to its default start page - the LYNX page at U Kansas.  You may 
  140. enter your own favorite start page by editing the appropriate entry in 
  141. your lynx.cfg file, as described above.  Help for Lynx/2 is available 
  142. at any time by means of the '?' key, set by default to the LYNX Help Page.
  143.  
  144. You may start lynx with a command line parameter to connect you 
  145. directly to a particular URL. For instance, the command line 
  146.  
  147.          "lynx ftp://hobbes.nmsu.edu"
  148.      
  149. will start lynx and connect directly to the hobbes ftp site.  You 
  150. may also specify a local file URL.  Please note that local file
  151. URLs have the form:
  152.  
  153.          "file:///e:/webpage/djd/index.html", or
  154.          "file://localhost/e:/webpage/djd/index.html"
  155.  
  156. WHAT TO DO IF IT DOESN'T WORK
  157.  
  158. Email me, Derek J Decker, at djd@cris.com - I'll try to determine what 
  159. is going wrong and come up with a fix.  You may also try to catch me in 
  160. the #os/2 channel on IRC - I show up there from time to time.  
  161.  
  162. Before you send me email, you may want to try running lynx with the 
  163. -trace command line option, and including the section of the resulting 
  164. trace that shows where the problem occurs. A good description of how 
  165. Lynx/2 is installed on your system, what you are trying to do that is 
  166. causing a problem, and specific problem symptoms always helps to ensure 
  167. an accurate and enthusiastic response.
  168.  
  169. Unfortunately, the press of other work at Decker Automation prevents me 
  170. from being able to support this via telephone.  
  171.  
  172. THINGS THAT ARE FIXED/Added IN THIS INTERIM RELEASE
  173.  
  174. Editable Input Fields - hit Insert to put it in Insert mode, too.
  175.  
  176. Key Management - Now DEL/INS work for up_two_lines and down_two_lines,
  177. as does +/-.
  178.  
  179. Lynx/2 now recognizes ® - prints a small circle in 8-bit mode, and
  180. (r) in 7 bit approximation mode.
  181.  
  182. Flagging, and Optional auto-running, of Java Applets.  Lynx/2 will tell 
  183. you if a page contains Java Applets. If the Auto-Run Java Applets option
  184. is set on in the options menu, it will automatically run all applets on
  185. a given page.
  186.  
  187. You can now feed URLs to Lynx/2 via a named pipe.  Lynx/2 listens on 
  188. \PIPE\LYNXURL, and will load any valid URL written to that pipe.  An
  189. example program, LynxURL.exe, is included.  This program takes as it's
  190. first parameter a URL, and as it's optional second parameter the file
  191. name/path/parameters of the program to start if the /PIPE/LYNXURL pipe
  192. is not found. An example batch file, feedlynx.cmd, that I use in 
  193. conjunction with NewsLifter/2, is also included.
  194.  
  195. Table Support
  196.  
  197. Frames Support
  198.  
  199. Fix for Warp 4 sendmail.  Use of sendmail.lyx, vs default
  200. of sendmail.cf (to keep tcpcfg happy).
  201.  
  202. Inclusion of an example Sendmail.lyx file
  203.  
  204. Lynx/2 now identifies itself explicitly as an OS/2 app, for all you
  205. Browserwatch stats mavens.
  206.  
  207. If LINES and COLS are not specified in Lynx.cfg, then Lynx/2 will use 
  208. the current window size, instead of defaulting to 80x24.
  209.  
  210. Manual Java Support.  See Lynx_2.inf for a description of how this works.
  211.  
  212. Support for local editing of files.
  213.  
  214. INF - based help file.
  215.  
  216. Added Inews.cmd for posting News.
  217.  
  218. Complete OS/2 file system support
  219.  
  220. Lynx/2 now has the capability of using URLs of the form 
  221. "file:///e:/webpage/index.html".  
  222.  
  223. Allow for User-Specified Colors and attributes
  224.  
  225. Documentation for these and how to set them may be found near the end of
  226. the LYNX.CFG file.
  227.  
  228. Enable Abort from Download 
  229.  
  230. So you've started a multi-megabyte download you don't really want, and
  231. you want to abort? Hit the 'Z' key!
  232.  
  233. Fix version reported Information
  234.  
  235. Lynx/2 now says so, when asked.
  236.  
  237. Support for Umlauts and other 8-bit characters
  238.  
  239. For all of you Germans and Swedes who have been complaining, Lynx/2 now 
  240. displays 8-bit characters without highlighting them, greatly enhancing
  241. readability of those northern European WWW pages.
  242.  
  243. Lynx/2 no longer requires cp.exe for printing and downloads - LYNXCP.EXE, 
  244. a simpler program supplied with this distribution, is used instead.
  245. It's dumb and slow, but it works.
  246.  
  247. THINGS I KNOW ARE WRONG AND WILL BE FIXED IN FUTURE VERSIONS
  248.  
  249. This is, as stated above, the Beta 0.6i of this program.  As such, it 
  250. is currently a better than rough port of the UNIX version of Lynx.  You Have 
  251. Been  Warned!  The rate at which this program gets updated depends proportionally 
  252. upon the rate at which I receive feedback indicating that folks are trying 
  253. to use it - there's no sense in spending tons of effort enhancing and fixing
  254. something no-one uses.
  255.  
  256. The following items are on my to-do list, in no apparent order:
  257.  
  258.     -Add WAIS Access Capability
  259.         -Fix FTP for silly NT-based servers
  260.     -Fix other bugs as reported by you
  261.  
  262. REQUIRED LEGAL STUFF
  263.  
  264. It's a sad world we live in, but this is kinda obligatory these days:
  265.  
  266.      THERE IS NO WARRANTY FOR THIS PROGRAM, TO THE EXTENT PERMITTED BY     
  267.      APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING DECKER
  268.      AUTOMATION PROVIDES THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY  
  269.      KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO,   
  270.      THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  271.      PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND
  272.      PERFORMANCE OF THE PROGRAM LIES WITH THE USER.
  273.  
  274.      IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN    
  275.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY  
  276.      MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE   
  277.      LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,  
  278.      INCIDENTAL OR CONSEQUENTIAL DAMANGES ARISING OUT OF THE USE OF  
  279.      INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO THE
  280.      LOSS OF DATA OR DATA BEING RENDERED INACURATE OR LOSSES SUSTAINED BY
  281.      YOU OR THIRD PARTIES OR A FIALURE OF THE PROGRAM TO OPERATE WITH   
  282.      ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
  283.      ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  284.  
  285. LICENSE AGREEMENT
  286.  
  287. After I have completed some portion of the to-do list specified above, 
  288. Lynx/2 may still become a shareware product.  The current release is freeware,
  289. so use it in good health - this one's on me!
  290.  
  291. I would encourage you to send me email (djd@cris.com) to let me know 
  292. what you think of Lynx/2 so far, good or bad.  Suggestions for improvements
  293. will be given consideration commensurate with the thoughtfullness of the 
  294. suggestion.  Large sums of cash, as always, will be accepted.
  295.  
  296. ABOUT DECKER AUTOMATION
  297.  
  298. Heck - you've got a WWW Browser - point it at http://www.cris.com/~djd and 
  299. find out more about Decker Automation, Derek J Decker, and what we REALLY 
  300. do here.   
  301.  
  302. ACKNOWLEDGEMENTS
  303.  
  304. Major Kudos go to the LYNX Team, as well as Eberhard Mattes who brought us the 
  305. EMX/gcc development system for OS/2. Thanks also to Rupa Schomaker(rupa@rupa.com)
  306. for the Inews.cmd file for posting news.  Thanks to Dave Simons for an icon that
  307. doesn't look like it was drawn by a 4 year old. And thanks to Jacques JAMAIN, who
  308. took time out from the beach on the French Riviera to 'fatify' all the Lynx/2
  309. help files.
  310.  
  311. Thanks also to all those who emailed with bug reports - keep those cards and letters
  312. coming, folks!