home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / usenet / software / slrn-faq < prev   
Encoding:
Internet Message Format  |  2000-09-24  |  16.2 KB

  1. Path: senator-bedfellow.mit.edu!dreaderd!not-for-mail
  2. Message-Id: <slrn8sr8il.58.davis@space.mit.edu>
  3. Supersedes: <slrn6bggu1.3ua.davis@space.mit.edu>
  4. From: davis@space.mit.edu
  5. Newsgroups: news.software.readers,alt.lang.s-lang,news.answers,alt.answers
  6. Followup-To: news.software.readers
  7. Subject: slrn FAQ
  8. Keywords: slrn newsreader
  9. Approved: news-answers-request@MIT.EDU
  10. Date: 24 Sep 2000 07:19:45 GMT
  11. Lines: 374
  12. NNTP-Posting-Host: ALUCHE.MIT.EDU
  13. X-Trace: dreaderd 969779985 9442 18.75.2.45
  14. Xref: senator-bedfellow.mit.edu news.software.readers:79208 alt.lang.s-lang:1853 news.answers:192506 alt.answers:51411
  15.  
  16. Archive-name: usenet/software/slrn-faq
  17. Posting-Frequency: bi-weekly
  18. Last-Modified: Sept 12, 2000
  19.  
  20. This is the slrn FAQ.  Send comments, suggestions, or corrections to
  21. davis@space.mit.edu.
  22.  
  23. slrn is a newsreader that runs under Unix, VMS, OS/2, Win32, and BeOS
  24. operating systems.  The latest version of slrn is available via
  25. anonymous ftp from <ftp://space.mit.edu/pub/davis/slrn/>.  It is also
  26. available from:
  27.  
  28.   ftp://ftp.uni-stuttgart.de/pub/unix/misc/slang/
  29.   ftp://ftp.fu-berlin.de/pub/unix/news/slrn/
  30.   ftp://ftp.ntua.gr/pub/lang/slang/
  31.  
  32. More information about slrn is available from the slrn home page at
  33. <http://www.slrn.org>.
  34.  
  35. If you are viewing this FAQ with slrn, press `g' to go from one subject to
  36. the next.
  37.  
  38. Questions addressed:
  39.  
  40. 0.  Where can I find more information about slrn?
  41. 1.  Instead of drawing lines for the thread tree, I see `mq'.  Why?
  42. 2.  I do not see a thread tree. Why?
  43. 3.  When I mark an article as read, why aren't cross-posts marked as read also?
  44. 4.  What is a prefix argument?
  45. 5.  How do I re-read articles in a newsgroup that I have already read?
  46. 6.  Can I use the mouse with slrn?
  47. 7.  How do I use the mouse in an Xterm to cut/paste?
  48. 8.  What is the easiest way to uudecode articles?
  49. 9.  How do I cross-post an article?
  50. 10. How do I find the previously read articles of a thread?
  51. 11. Why doesn't the `L' command work as advertised?
  52. 12. How can I set my `From' line for my posts?
  53. 13. Why doesn't set_author_display work?
  54.  
  55. Answers:
  56.  
  57. ------------------------------
  58.  
  59. Subject: 0. Where can I find more information about slrn?
  60.  
  61.     Perhaps the best source of slrn information is available from the
  62.     slrn home page at http://www.slrn.org.  Be sure to check it out.
  63.  
  64.     Although there is a man page, it probably does not cover the
  65.     latest slrn features.  A better source of information about new
  66.     features may be found in the `changes.txt' file that is
  67.     distributed with slrn.  Also, all .slrnrc options are described in
  68.     the example `slrn.rc' file that is distributed with slrn.
  69.  
  70.     The newsgroup news.software.readers frequently contains articles
  71.     that pertain to slrn.  Many knowledgeable slrn users actively
  72.     participate in the newsgroup making the group a great slrn
  73.     resource.
  74.  
  75.     You can also participate in the development of slrn by improving
  76.     its documentation.  If you would like to submit some documentation
  77.     for slrn, please use a text-only format.  At some point, I plan to
  78.     put all of slrn's documentation in SGML format and then process
  79.     the SGML document to produce man pages, html pages, TeX, RTF,
  80.     etc...
  81.  
  82. ------------------------------
  83.  
  84. Subject: 1. Instead of drawing lines for the thread tree, I see `mq'.  Why?
  85.  
  86.     There are a couple of reasons for this.  The simplest may be that the
  87.     font that you are using does not support line drawing characters.
  88.     Simply switching fonts to a dec-vt220 compatible font may solve the
  89.     problem.  This is usually the case with Windows telnet applications.
  90.  
  91.     Another reason for this is that your terminfo file may not be set up
  92.     properly. The obvious solution is fix the terminfo file.  However, this
  93.     may not be possible without the correct tools (untic and tic) and many
  94.     systems do not have those tools installed.
  95.  
  96.     Although slang is a terminfo based system, there is another solution
  97.     based on termcap if you are using version 0.99.18 of slang or later.
  98.     First of all, get a termcap entry that contains the appropriate
  99.     capabilities for an alternate character set, that is, the termcap `ac',
  100.     `ae', `as', and possibly `eA' capabilities.  Let's call this file
  101.     `my_termcap'.  Then do:
  102.  
  103.       setenv TERMCAP `pwd`/my_termcap
  104.       eval `tset -s terminal-name`
  105.  
  106.     (Replace `terminal-name' by your terminal name).  `tset' will then read
  107.     and parse the my_termcap file and set the TERMCAP variable
  108.     appropriately. You will want to put this in your .login file.
  109.  
  110. ------------------------------
  111.  
  112. Subject: 2. I do not see a thread tree. Why?
  113.  
  114.     See the answer to the previous question.
  115.  
  116. ------------------------------
  117.  
  118. Subject: 3. When I mark an article as read, why aren't cross-posts marked
  119.             as read also?
  120.  
  121.     For slrn to mark an article as read in more than one group, it needs
  122.     information about what groups the article was cross-posted to.  This
  123.     information is provided by the Xref header.  Not all servers provide
  124.     this header so this feature will not work with those servers.
  125.  
  126.     Now suppose that your server provides the Xref header as one of the
  127.     headers of the article and at the same time, provides support for the
  128.     NOV database (via the XOVER nntp command).  In this case, unless the
  129.     server has been configured to provide the Xref header as part of the NOV
  130.     database, slrn will not be able to get the header without accessing the
  131.     article.  Unfortunately, Xref is optional under NOV so many systems do
  132.     not automatically provide it even though it is one of the recommended
  133.     headers.
  134.  
  135.     To summarize, make sure that your server provides the Xref header AND if
  136.     it supports NOV, make sure that the Xref header is part of the NOV
  137.     database.
  138.  
  139. ------------------------------
  140.  
  141. Subject: 4. What is a prefix argument?
  142.  
  143.     Many key-bindings accept prefix arguments.  A prefix argument is an
  144.     integer that is generated prior to a key sequence and is used as a way
  145.     of controlling the behavior the key sequence.  It is generated by
  146.     pressing the ESC key and then pressing the keys that correspond to the
  147.     integer.  For example, to generate a prefix argument of 314, simply
  148.     press the 4 keys: ESC 3 1 4.
  149.  
  150.     Some functions use such arguments as repeat factors.  That is, the
  151.     function bound to the key sequence that they modify will be repeated the
  152.     number of times specified by the prefix argument.
  153.  
  154.     Some other functions may simply use it as a way of slightly modifying
  155.     the behavior of the function.  For example, if a prefix argument is
  156.     used as a modifier for the `followup' function, the original article's
  157.     headers will be included in the followup message.  Without a prefix
  158.     argument, the headers will not be included in followups.
  159.  
  160. ------------------------------
  161.  
  162. Subject: 5. How do I re-read articles in a newsgroup that I have already read?
  163.  
  164.     When entering a newsgroup, simply use a `prefix argument'.  This means,
  165.     press ESC and then a number followed by the key sequence that you use to
  166.     enter the newsgroup.  For example, if you use the RETURN key, then press
  167.     `ESC 1 RETURN'.
  168.  
  169. ------------------------------
  170.  
  171. Subject: 6. Can I use the mouse with slrn?
  172.  
  173.      If slrn is run in an Xterm or on a win32 system, it can use the
  174.      mouse.  To enable it, add the line 
  175.      
  176.         set mouse 1
  177.  
  178.      to your .slrnrc file.  This will cause slrn to enable mouse
  179.      reporting on systems that support it. If run on Unix, the TERM
  180.      environment variable is used to determine whether or not mouse
  181.      support is available.
  182.  
  183.      To force the mouse to be used, startup slrn using the -m option, e.g.,
  184.      `slrn -m'.
  185.  
  186.      The actions defined for the mouse are specified in the following table:
  187.  
  188.      Group Mode:
  189.  
  190.          Object                 Button         Action
  191.          ------------------------------------------------
  192.          Top Status line        any            specified by button label
  193.          Group Name             any            select group
  194.          Bottom Status line     middle         toggle display of unread groups
  195.          Bottom Status line     left           page-down
  196.          Bottom Status line     right          page-up         
  197.  
  198.      Article Mode:
  199.  
  200.          Object                 Button         Action
  201.          ------------------------------------------------
  202.          Top status line        any            specified by button label
  203.  
  204.          Header status line     left           header page down
  205.                                 right          header page up
  206.                                 middle         hide article window
  207.  
  208.          Article status line    left           next unread
  209.                                 right          previous unread
  210.                                 middle         toggle quotes
  211.  
  212.          Header item            any            select item
  213.  
  214.          Article window         left           article page down
  215.                                 right          article page up
  216.                                 middle         hide article window
  217.  
  218. ------------------------------
  219.  
  220. Subject: 7. How do I use the mouse in an Xterm to cut/paste?
  221.  
  222.     The easiest way is to hold down the shift key when using the mouse for
  223.     cut/paste operations.  The other way is to simply get an slrn prompt,
  224.     e.g., search for something then after cut/paste abort the search.
  225.  
  226. ------------------------------
  227.  
  228. Subject: 8. What is the easiest way to uudecode articles?
  229.  
  230.     Fortunately, the easiest way is also the most efficient.  Basically this
  231.     involves using the `#' key to numerically tag articles that you want to
  232.     decode and then the `:' key to start the decode process.  The only
  233.     restriction is that multi-part uuencoded articles must be tagged in
  234.     their proper order.  There is no need to uudecode one article at a time.
  235.     Simply mark everything that you would like to decode then press `:'.
  236.  
  237.     Here is an actual example taken from alt.binaries.pictures.fractals:
  238.  
  239.     -    9:[Mike In Indy]    Kaboom! - kaboom.gif (0/1)
  240.     - 3078:[Mike In Indy]    Kaboom! - kaboom.gif (1/1)
  241.     -   23:[Gumbycat    ]    lucifer.gif  (0/7)
  242.     -  433:[Gumbycat    ]    lucifer.gif -  for Halloween  (5/7)
  243.     -  433:[Gumbycat    ]    lucifer.gif  -  for Halloween (3/7)
  244.     -  433:[Gumbycat    ]    lucifer.gif  -  for Halloween (4/7)
  245.     -  433:[Gumbycat    ]    lucifer.gif  -  for Halloween (6/7)
  246.     -  244:[Gumbycat    ]    lucifer.gif  -  for Halloween (7/7)
  247.     -  434:[Gumbycat    ]    lucifer.gif  - for Halloween (1/7)
  248.     -  433:[Gumbycat    ]    lucifer.gif - for Halloween (2/7)
  249.     -   16:[Paul Carlson]    My Halloween Fractal - devil.gif (0/1)
  250.     - 4310:[Paul Carlson]    My Halloween Fractal - devil.gif (1/1)
  251.  
  252.     As you can see, 3 files have been posted: kaboom.gif, lucifer.gif, and
  253.     devel.gif (At the time of this writing, it is Halloween weekend). Both
  254.     kaboom.gif and devel.gif are single part files whereas lucifer.gif is a
  255.     seven part series.  Since lucifer.gif is displayed out of order, care
  256.     must be exercised when tagging it (slrn will sort threads by subject and
  257.     in this case the poster used an inconsistent subject format--- usually,
  258.     sorting will result in the correct ordering).  Assuming that we wish to
  259.     decode these three gif images, the `#' key will be used to tag them.
  260.     The result of using the `#' key is shown below:
  261.  
  262.     -    9:[Mike In Indy]    Kaboom! - kaboom.gif (0/1)
  263.    1- 3078:[Mike In Indy]    Kaboom! - kaboom.gif (1/1)
  264.     -   23:[Gumbycat    ]    lucifer.gif  (0/7)
  265.    6-  433:[Gumbycat    ]    lucifer.gif -  for Halloween  (5/7)
  266.    4-  433:[Gumbycat    ]    lucifer.gif  -  for Halloween (3/7)
  267.    5-  433:[Gumbycat    ]    lucifer.gif  -  for Halloween (4/7)
  268.    7-  433:[Gumbycat    ]    lucifer.gif  -  for Halloween (6/7)
  269.    8-  244:[Gumbycat    ]    lucifer.gif  -  for Halloween (7/7)
  270.    2-  434:[Gumbycat    ]    lucifer.gif  - for Halloween (1/7)
  271.    3-  433:[Gumbycat    ]    lucifer.gif - for Halloween (2/7)
  272.     -   16:[Paul Carlson]    My Halloween Fractal - devil.gif (0/1)
  273.    9- 4310:[Paul Carlson]    My Halloween Fractal - devil.gif (1/1)
  274.  
  275.     Now 9 headers have been numerically tagged.  To decode these, simply
  276.     press the `:' key.  slrn will prompt for a filename to save the articles
  277.     to and after saving, it will prompt to go ahead and decode.  The decoded
  278.     files will be placed in the directory specified by the
  279.     `decode_directory' variable that one can set in the .slrnrc file.  The
  280.     end result is that after tagging with the `#' key, one presses `:' and
  281.     hits return twice.
  282.  
  283.     To un-tag articles, press `ESC #'.
  284.  
  285. ------------------------------
  286.  
  287. Subject: 9. How do I cross-post an article?
  288.  
  289.     There are two ways:
  290.  
  291.        1. When slrn prompts for a newsgroup, simply specify a comma
  292.           separated list of newsgroups.  DO NOT USE SPACES!
  293.  
  294.        2. Edit the Newsgroup header line when editing the message.  Again,
  295.           the list of newsgroups must be comma separated with no whitespace.
  296.           Also make sure that you do not wrap this line.
  297.  
  298.     Helpful hint:
  299.  
  300.        If you forget the name of a newsgroup while inside the editor,
  301.        suspend the editor with Ctrl-Z and use more/less/most to view your
  302.        .newsrc file.  If your editor is sophisticated enough, you can really
  303.        simplify this process by using the `editor_command' keyword in your
  304.        .slrnrc file.  For example, if you use jed as your editor, you can
  305.        set your editor command to something like:
  306.  
  307.           editor_command "jed ~/.jnewsrc -2 %s -g %d"
  308.  
  309.        This says to load the file ~/.jnewsrc into the editor, split the
  310.        window, then load the file that slrn wants to edit in one of the
  311.        windows and then goto a specified line number.
  312.  
  313. ------------------------------
  314.  
  315. Subject: 10. How do I re-read previously read articles of a thread?
  316.  
  317.      `ESC p' will attempt to find the parent as specified by the references
  318.      header of the current article querying the server if necessary.  To
  319.      find the children of the current article (articles that reference it),
  320.      use `ESC Ctrl-P'.  Finally, to reconstruct the entire tree (all parents
  321.      and all children), use `ESC 1 ESC p'.
  322.  
  323. ------------------------------
  324.  
  325. Subject: 11. Why doesn't the `L' command work as advertised?
  326.  
  327.      Capital L lists all un-subscribed groups that slrn knows about.
  328.      Slrn gets this information through one of three sources.  It
  329.      tries the following in order and stops when one is successful:
  330.  
  331.     a.  From the server via the active file.  It only does this if the
  332.         line `set read_active 1' is in your .slrnrc file.  By default,
  333.         slrn does not read the active file.
  334.         
  335.     b.  By querying the server using the XGTITLE nntp command.  This
  336.         requires your server to support this command and the line
  337.         `set use_xgtitle 1' must be in your .slrnrc file.
  338.         
  339.         c.  From the groups listed in your newsrc file.  The `L' command
  340.         will only list unsubscribed groups that are present in this file.
  341.  
  342.      The last one (c) always succeeds with results that may be less than
  343.      desirable.  If you have a fast network connection to your server,
  344.      simply put
  345.      
  346.          set read_active 1
  347.  
  348.      in your .slrnrc file.  If your connection is slow via something like
  349.      ppp and you do not want slrn to read the active file, then see whether
  350.      or not your server supports XGTITLE command.  If it does, allow slrn to
  351.      use it via
  352.  
  353.          set use_xgtitle 1
  354.      
  355.      As a last resort, try to keep a full list of newsgroups in your newsrc
  356.      file.
  357.  
  358.  
  359. ------------------------------
  360.  
  361. Subject: 12. How can I set my `From' line for my posts?
  362.  
  363.      Use the .slrnrc settings:
  364.      
  365.          set hostname "YOUR.HOST.NAME"
  366.      set username "USERNAME"
  367.      set realname "YOUR REAL NAME"
  368.      
  369.     This will cause slrn to use a From line of the form:
  370.     
  371.         From: USERNAME@YOUR.HOST.NAME (YOUR REAL NAME)
  372.  
  373.     Finally, if a slang function called `make_from_string_hook'
  374.     exists, then it will be used to generate the `From' header, e.g.,
  375.     
  376.         define make_from_string_hook ()
  377.     {
  378.        return "W. J. Clinton <president@whitehouse.gov>";
  379.     }
  380.  
  381. ------------------------------
  382.  
  383. Subject: 13. Why doesn't set_author_display work?
  384.  
  385.     This variable is nolonger meaningful and is ignored by recent
  386.     versions of slrn.  Instead, the user is encouraged to use the much
  387.     more flexible interface provided by `header_display_format'
  388.     variable.  See the documentation in changes.txt and in the sample
  389.     slrn.rc file. 
  390.