home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / hl_news.zip / News / readme < prev   
Text File  |  1999-04-26  |  6KB  |  139 lines
  1.  
  2. HL_News: A  Headline News Viewer (ver 1.0)
  3. By Tom Fredrickson
  4. 4-21-1999
  5.  
  6.  
  7. Citation:
  8.    Headline News Viewer is based on  the  Deja News Reader  by
  9.    Eric Walker (ftp.highboskage.com/dnreader)
  10.  
  11.    It also has some modified code taken from HTML_TXT by 
  12.    Daniel Hellerstein 
  13.  
  14. Requirements:
  15.    Headline News requires the following dynamic link libraries (DLL):
  16.        REXXLIB.DLL and RXWIN30.DLL from Quercus Systems at
  17.               http://www.quercus-sys.com/files/rexxlib.zip
  18.        RXSOCK.DLL:  the IBM EWS RxSock library is usually installed with 
  19.                 OS/2. If you do not have a copy of RXSOCK.DLL, you  can find it at
  20.                  ftp.ibm.com/pub/pccbbs/os2_ews/rxsock.zip
  21.    These DLL library files must be in your LIBPATH (say, in x:\os2\dll, where
  22.     x: is your boot drive), or in the same directory as HL_NEWS.CMD
  23.  
  24. Installation:
  25.   a)  Copy HL_NEWS.CMD., NEWS.CFG, and  possibly the aforementioned DLLs
  26.         to one of your applications directory.
  27.   b)  create a LOADS and SAVE subdirectories under this directory --
  28.        these are used for workspace.
  29.        If you want to use diffferent names for these workspace directories,
  30.       you can modify NEWS.CFG.
  31.  
  32.  
  33.   Caution:
  34.          The  LOADS subdirectory is subject to bulk erasal -- do NOT put anything in
  35.          LOADS that you want to keep!
  36.  
  37.  
  38.  Acknowlegements:
  39.    *  This program  downloads a list, maintained by Derek Decker, of article
  40.       headlines for viewing in a textmode window. You can check this list,
  41.       at http://www.iglou.com/DeckerAutomation/news.html, with a java
  42.       enabled  browser. 
  43.  
  44.       For more info about Decker Automation, and what Derek J Decker REALLY does,
  45.         take a look at    http://www.cris.com/~djd
  46.  
  47.   * I must give specal thanks to Daniel Hellerstein author of HTML_TXT
  48.      Without his help I would have probably not been able to get the text
  49.      formatted in such a nice way.
  50.  
  51. Disclaimer:
  52.  
  53.    This is freeware that is to be used at your own risk -- the 
  54.    author and any potentially affiliated persons disclaim all 
  55.    responsibilties for any consequence arising from the use, misuse, or abuse 
  56.    of this software.
  57.  
  58.  
  59. Disclaimer:
  60.  
  61.    This is freeware that is to be used at your own risk -- the 
  62.    author and any potentially affiliated persons disclaim all 
  63.    responsibilties for any consequence arising from the use, misuse, or abuse 
  64.    of this software .
  65.  
  66.  
  67. Running Headline News:
  68.    a)you must be online to run Headline News.
  69.    b)check News.cfg to set some user variables 
  70.     
  71.       (line_len) is used to set the length of lines displayed the default is 78.
  72.  
  73.       (Hi_asc) is used used to turn on or off the display of hi ascii characters 
  74.       used in html markup. This may be turned on or off. 1=on 0=off
  75.  
  76.               *some characters may still show as this only controls &#num;
  77.               elements of the markup.
  78.  
  79.       (h_mark) is used to set the display of headings as an hierarchical outline
  80.       the default is '' and will display indented with the number.    1)like so
  81.  
  82.          *you may set this to display a specific character buy using D2C(num)
  83.          with num being a three digit number from 128 - 255
  84.     
  85.   
  86.    c)Geting around
  87.  
  88.                  **Using the keyboard  navigating in Headline News**
  89.        
  90.     Most of the windows have a help screen that can be read by pressing
  91.     the F1 key.
  92.     The ESC key will leave any current window.
  93.      
  94.     The first time the Headline News is run you must fetch the list of 
  95.     articles. This is accomplished  by pressing D key at the main selection 
  96.     window.  Otherwise you may chose to browse an existing list by pressing 
  97.     the B key.
  98.        
  99.     A list of articles is  then displayed. You should then select an article by pressing
  100.     the corresponding letter key (A-V).
  101.         *    Use the PAGE_UP or PAGE_DOWN keys to go through the list.
  102.         *    The HOME key will take you to the top of the list. 
  103.         *    The END key goes to the end of the list.
  104.        
  105.    After selecting the letter(A-V) key, that matches the article you wish to view,
  106.    Headline News will download, format, and display the text of the article.
  107.      
  108.         *  If the text is displayed off the screen, you can use the LEFT and RIGHT 
  109.            arrow keys to scroll.
  110.  
  111.         *  The PAGE_UP PAGE_DOWN HOME and END keys are all active.
  112.        
  113.    The article may be saved by pressing the ALT-S key. This displays a window to enter
  114.    the direcotyr where the file is to be placed along, with the name of the file.
  115.   
  116.           * The default directory can be set by modifying the savesdir parameter 
  117.             (in News.cfg)
  118.  
  119.           * Caution: 
  120.                 The cursor is at the left end of the line -- so it must be
  121.                 moved to the proper location to before typing in the name
  122.                 (you can use the END key). 
  123.        
  124.    After the article has been read the ESC key will bring the selection list 
  125.    screen back up.
  126.        
  127.    To exit Headline News press ESC until a window pop's up asking if you 
  128.    wish to exit  (pressing the Y key will exit).
  129.  
  130. Cavities: 
  131.            From time to time then news servers will move or discontinue an 
  132.            article. If errors about (text start or text end) get frequent try 
  133.            downloading a new list of articles.
  134.  
  135.                  * At any time a site may decide to reformat their web pages
  136.                  making this program inoperable until changes are made.
  137.  
  138. [end of file] 
  139.