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