home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / SLRN_CP / README < prev    next >
Text File  |  1996-12-09  |  5KB  |  119 lines
  1. slrn is an NNTP based news reader.
  2.  
  3. VMS users:   READ VMSNOTES.TXT  !!!
  4. OS/2 users:  Use the makefile called Makefile.os2
  5.  
  6. (See also INSTALL for more installation tips--- especially for a multiuser
  7. system)
  8.  
  9. (Note: For VMS, use either VMSMAKE.COM or DESCRIPT.MMS.  In addition, names
  10. like .jnewsrc should be read as jnews.rc, etc...)
  11.  
  12. To build slrn, build the S-Lang library first.  S-Lang is available from
  13. space.mit.edu.  slrn uses S-Lang for most of the dirty work such as keymaps,
  14. terminal i/o, and screen management. Once S-Lang has been compiled, compile
  15. slrn.  Under Unix, this is accomplished by running the configure script via:
  16.  
  17.     ./configure
  18.     [edit src/slrnfeat.h and src/Makefile]
  19.     make
  20.     make install
  21.  
  22. Notes:
  23.  
  24.    *  It may be necessary to edit the Makefile in src/Makefile.  
  25.    *  Be sure to look at src/sysconf.h after running the configure script 
  26.        but BEFORE running make.
  27.    *  If you want support for a local news spool or for inews, edit 
  28.        src/slrnfeat.h. 
  29.    *  The executable will be created in src/objs.
  30.  
  31. Once slrn has been created, you will need to creat a .jnewsrc file in your
  32. $HOME directory.  The simplist way to do this is to simply do:
  33.  
  34.     cp $HOME/.newsrc $HOME/.jnewsrc
  35.  
  36.    [Actually, slrn will do this for you automatically.  If no newsrc file is
  37.     specified, and .newsrc exists, it will create .jnewsrc from .newsrc]
  38.     
  39. slrn will use a different name for this file while it is under development.
  40. Finally, make sure the environment variable NNTPSERVER is set to point to
  41. your news server (e.g., setenv NNTPSERVER nntp.where-ever.com).  This is
  42. only necessary when using NNTP.
  43.  
  44.    [ If you do not already have a .newsrc file, it will be necessary to create
  45.      one.  To do so, at the unix prompt, type:
  46.      
  47.         slrn -f .jnewsrc -create
  48.     
  49.      This starts the newsreader and retrieves all active newsgroups from the
  50.      news server.  The act of retrieving all groups can be quite slow for
  51.      slow connections.  Fortunately, this only happens when the create flag
  52.      is used.
  53.      
  54.      From within the news reader, you may subscribe to
  55.      desired groups.  Press the `L'  (capital-L!!) key to list all groups
  56.      matching a specified pattern, e.g., comp.*unix*.
  57.      
  58.      Use the `s' key to subscribe.
  59.    ]
  60.  
  61. For run-time configuration of slrn such as new keybindings, change in
  62. location of local spool directories, etc. copy the file `slrn.rc' to your
  63. home directory and rename it `.slrnrc' (Unix-- VMS and OS/2 use a different
  64. name).  Edit this file to change the keybindings and to associate different
  65. newsrc files with different servers, etc...
  66.  
  67. To post articles, slrn will look for the following environment variables for
  68. an editor:
  69.  
  70.     SLANG_EDITOR
  71.     EDITOR
  72.     VISUAL
  73.     
  74. If it fails, it will resort  to vi.  `SLANG_EDITOR' is the most versatile
  75. since one can define it to include a command line.  For example, if JED is
  76. your editor, use:
  77.  
  78.     setenv SLANG_EDITOR 'jed %s -g %d -tmp'
  79.     
  80. That's it, type: slrn
  81. Also, try: slrn --help
  82.  
  83.    [If you have a color terminal, use `./slrn -C'.  You may need to change
  84.     the colors by setting them in your .slrnrc file.  If you run under
  85.     X Windows, you may consider getting a good color Xterm such as rxvt.
  86.     (color_xterm itself is somewhat buggy so I recommend rxvt.  See
  87.     http://space.mit.edu/~davis for pointers to rxvt.]
  88.  
  89. After connecting to the server and getting news for the subscribed groups in
  90. you .jnewsrc file, slrn will enter full screen mode listing the newsgroups
  91. that you have subscribed to.  Use the UP/DOWN (^P/^N) arrow keys to move
  92. from one group to another.  To read news from that group, press the SPACE
  93. bar or simply hit RETURN.
  94.  
  95. slrn will display the headers for unread articles after getting the required
  96. headers for the group from the server.  Use the UP/DOWN arrow keys to move
  97. from one to the other.  To delete the current header (i.e., mark as read),
  98. hit the `d' key.  `u' will undelete the article.  To read the article under
  99. the cursor, press RETURN or SPACE.  The screen will split into two windows--
  100. a small one for the headers and a large one for the article.  Press SPACE to
  101. scroll through the article and `b' to page backwards.  The `t' key may be
  102. used to toggle hiding of selected headers.
  103.  
  104. The `f' key may be used to followup on the article.  `q' will return to the
  105. list of newsgroups.  Also, one may use the `n' key to go to thye next unread
  106. article.  If there are no more unread articles, pressing `n' will also take
  107. you to the next group.  Press the arrow keys to choose one.
  108.  
  109. At the group level, a new message may be posted by using the `p' key.
  110.  
  111. Enjoy.  However, since this slrn is still in its infancy and is still under
  112. development, please send me your comments regarding the user interface.
  113.  
  114. I follow the news.software.readers newsgroup.  Feel free to post questions
  115. there.  Before posting, read the files FAQ, KILL_FAQ, score.txt.  Finally
  116. look at the sample slrn.rc file.
  117.  
  118. davis@space.mit.edu
  119.