home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 February / PCO2_97.ISO / filesbbs / os2 / lynxos25.arj / README.OS2 < prev    next >
Encoding:
Text File  |  1996-07-20  |  10.5 KB  |  278 lines
  1.                           Lynx/2 - Beta version 0.4
  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.     setup.cmd
  52.     
  53.     about dir:
  54.         about_ly.htm
  55.         readme.htm
  56.     docs dir:
  57.         readme.htm
  58.         readme.txt
  59.         rfc-mail.txt
  60.     help dir:
  61.         keystrok.com
  62.         lynx_hel.htm
  63.         lynx_use.htm    
  64.  
  65.     help\keystrok.com dir:
  66.             bookmark.htm
  67.             dired_he.htm
  68.             gopher_t.htm
  69.             history_.htm
  70.             keystrok.htm
  71.             movement.htm
  72.             option_h.htm
  73.             other_he.htm
  74.             print_he.htm
  75.             scrollin.htm
  76.             xterm_he.htm
  77.     Samples dir:
  78.         jumpsuni.htm
  79.         jumpsvms.htm
  80.         lynx.cfg
  81.         lynx.com
  82.         mime.typ
  83.         new_inst.htm
  84.         readme.htm
  85.     test dir:
  86.         iso_lati.htm
  87.         readme.txt
  88.  
  89. Lynx/2 requires the EMXRT 0.9b runtime libraries to run. These should be 
  90. available from the same FTP site you obtained Lynx/2 from.
  91.  
  92. All of the files required for proper operation of Lynx/2 meet the criteria 
  93. for 8.3 FAT compatibility.  Now, all of the temp files produced by Lynx/2 do
  94. as well.    
  95.  
  96. Lynx/2 uses environment variables (those things you set with the SET command
  97. in config.sys) in order to find its ancillary files.  In particular, Lynx/2
  98. will use files named bookmark.htm and lynxrc in the HOME directory, and a
  99. configuration file named lynx.cfg in the ETC directory.  Lynx/2 will also 
  100. put it's temporary files in the directory pointed to by the TMP environment
  101. variable, so there's no need to have a TMP dir under the current working dir
  102. when running Lynx/2.  
  103.  
  104. The next step in the installation procedure is to run setup.cmd. Setup.cmd is
  105. a rudimentary setup script - it checks for the presence of HOME, TMP, and ETC 
  106. environment variables, and if they are all present, copies the correct files
  107. to the correct directories and exits, reminding you to ensure to include the
  108. directory Lynx/2 is installed in in the path.  If it does not find everything
  109. it's looking for, it will complain and exit.  If you should be the recipient
  110. of such complaints, please set up the appropriate environment variables in your
  111. config.sys file, reboot, and run setup.cmd again.
  112.  
  113. If you wish to be able to read/post news with Lynx/2, you may need to add an
  114. additional environment variable to your config.sys.  Lynx/2, and its associated
  115. news posting utility, Inews.cmd, use a default of 'news.' for an NNTP server 
  116. address, which works in a surprisingly large number of cases.  If, however,
  117. this does not work for you, place a 
  118.     
  119.     "SET NNTPSERVER=news.myserver.com"
  120.  
  121. (with, of course, the proper address for your newsserver) in your config.sys, and
  122. both Lynx/2 and Inews.cmd will receive and post news correctly.
  123.  
  124. The final step for installation is to edit the lynx.cfg file to reflect 
  125. the setup for your local site.  In particular, the LOCAL_DOMAIN entry 
  126. should be changed to reflect your local domain name.  You may wish to 
  127. modify the PRINTER entry "HP Deskjet", which reflects my personal 
  128. configuration.  The usage of the included prt.cmd file for printing is
  129. encouraged. Documentation for all the lynx.cfg entries may be found 
  130. within the file itself.  There is additional documentation on the 
  131. lynx.cfg file in the LYNX_2.INF file included in the distribution.
  132.  
  133.  
  134. RUNNING LYNX/2
  135.  
  136. Start Lynx/2 by typing "lynx" at the command line, after ensuring that 
  137. you are connected to the Internet.  Lynx should start and automatically 
  138. connect to its default start page - the LYNX page at U Kansas.  You may 
  139. enter your own favorite start page by editing the appropriate entry in 
  140. your lynx.cfg file, as described above.  Help for Lynx/2 is available 
  141. at any time by means of the '?' key, set by default to the LYNX Help Page.
  142.  
  143. You may start lynx with a command line parameter to connect you 
  144. directly to a particular URL. For instance, the command line 
  145.  
  146.          "lynx ftp://hobbes.nmsu.edu"
  147.      
  148. will start lynx and connect directly to the hobbes ftp site.  You 
  149. may also specify a local file URL.  Please note that local file
  150. URLs have the form:
  151.  
  152.          "file:///e:/webpage/djd/index.html", or
  153.          "file://localhost/e:/webpage/djd/index.html"
  154.  
  155. WHAT TO DO IF IT DOESN'T WORK
  156.  
  157. Email me, Derek J Decker, at djd@cris.com - I'll try to determine what 
  158. is going wrong and come up with a fix.  You may also try to catch me in 
  159. the #os/2 channel on IRC - I show up there from time to time.  
  160.  
  161. Before you send me email, you may want to try running lynx with the 
  162. -trace command line option, and including the section of the resulting 
  163. trace that shows where the problem occurs. A good description of how 
  164. Lynx/2 is installed on your system, what you are trying to do that is 
  165. causing a problem, and specific problem symptoms always helps to ensure 
  166. an accurate and enthusiastic response.
  167.  
  168. Unfortunately, the press of other work at Decker Automation prevents me 
  169. from being able to support this via telephone.  
  170.  
  171. THINGS THAT ARE FIXED IN THIS RELEASE
  172.  
  173. Manual Java Support.
  174.  
  175. See Lynx_2.inf for a description of how ths works.
  176.  
  177. Support for local editing of files.
  178.  
  179. INF - based help file.
  180.  
  181. Added Inews.cmd for posting News.
  182.  
  183. Complete OS/2 file system support
  184.  
  185. Lynx/2 now has the capability of using URLs of the form 
  186. "file:///e:/webpage/index.html".  
  187.  
  188. Allow for User-Specified Colors and attributes
  189.  
  190. Documentation for these and how to set them may be found near the end of
  191. the LYNX.CFG file.
  192.  
  193. Enable Abort from Download 
  194.  
  195. So you've started a multi-megabyte download you don't really want, and
  196. you want to abort? Hit the 'Z' key!
  197.  
  198. Fix version reported Information
  199.  
  200. Lynx/2 now says so, when asked.
  201.  
  202. Support for Umlauts and other 8-bit characters
  203.  
  204. For all of you Germans and Swedes who have been complaining, Lynx/2 now 
  205. displays 8-bit characters without highlighting them, greatly enhancing
  206. readability of those northern European WWW pages.
  207.  
  208. Lynx/2 no longer requires cp.exe for printing and downloads
  209.  
  210. LYNXCP.EXE, a simpler program supplied with this distribution, is used instead.
  211. It's dumb and slow, but it works.
  212.  
  213. THINGS I KNOW ARE WRONG AND WILL BE FIXED IN FUTURE VERSIONS
  214.  
  215. This is, as stated above, the Beta 0.4 of this program.  As such, it 
  216. is currently a better than rough port of the UNIX version of Lynx.  You Have 
  217. Been  Warned!  The rate at which this program gets updated depends proportionally 
  218. upon the rate at which I receive feedback indicating that folks are trying 
  219. to use it - there's no sense in spending tons of effort enhancing and fixing
  220. something no-one uses.
  221.  
  222. The following items are on my to-do list, in no apparent order:
  223.  
  224.     -Add WAIS Access Capability
  225.         -Create non-horrible icon (my 4 year old did this one)
  226.     -Fix other bugs as reported by you
  227.  
  228. REQUIRED LEGAL STUFF
  229.  
  230. It's a sad world we live in, but this is kinda obligatory these days:
  231.  
  232.      THERE IS NO WARRANTY FOR THIS PROGRAM, TO THE EXTENT PERMITTED BY     
  233.      APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING DECKER
  234.      AUTOMATION PROVIDES THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY  
  235.      KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO,   
  236.      THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  237.      PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND
  238.      PERFORMANCE OF THE PROGRAM LIES WITH THE USER.
  239.  
  240.      IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN    
  241.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY  
  242.      MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE   
  243.      LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,  
  244.      INCIDENTAL OR CONSEQUENTIAL DAMANGES ARISING OUT OF THE USE OF  
  245.      INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO THE
  246.      LOSS OF DATA OR DATA BEING RENDERED INACURATE OR LOSSES SUSTAINED BY
  247.      YOU OR THIRD PARTIES OR A FIALURE OF THE PROGRAM TO OPERATE WITH   
  248.      ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
  249.      ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  250.  
  251. LICENSE AGREEMENT
  252.  
  253. After I have completed some portion of the to-do list specified above, 
  254. Lynx/2 may still become a shareware product.  The current release is freeware,
  255. so use it in good health - this one's on me!
  256.  
  257. I would encourage you to send me email (djd@cris.com) to let me know 
  258. what you think of Lynx/2 so far, good or bad.  Suggestions for improvements
  259. will be given consideration commensurate with the thoughtfullness of the 
  260. suggestion.  Large sums of cash, as always, will be accepted.
  261.  
  262. ABOUT DECKER AUTOMATION
  263.  
  264. Heck - you've got a WWW Browser - point it at http://www.cris.com/~djd and 
  265. find out more about Decker Automation, Derek J Decker, and what we REALLY 
  266. do here.   
  267.  
  268. ACKNOWLEDGEMENTS
  269.  
  270. Major Kudos go to the LYNX Team, as well as Eberhard Mattes who brought us the 
  271. EMX/gcc development system for OS/2. Thanks also to Rupa Schomaker(rupa@rupa.com)
  272. for the Inews.cmd file for posting news.  Thanks to Dave Simons for an icon that
  273. doesn't look like it was drawn by a 4 year old. And thanks to Jacques JAMAIN, who
  274. took time out from the beach on the French Riviera to 'fatify' all the Lynx/2
  275. help files.
  276.  
  277. Thanks also to all those who emailed with bug reports - keep those cards and letters
  278. coming, folks!