home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / SLRN0931 / DOC / SLRN.MAN < prev    next >
Text File  |  1997-02-24  |  46KB  |  1,335 lines

  1.  
  2.  
  3.  
  4. SLRN(1)                                                   SLRN(1)
  5.  
  6.  
  7. NAME
  8.        slrn - An easy to use NNTP based newsreader.
  9.  
  10. SYNOPSIS
  11.        slrn  [  -n ] [ -h nntp-server-name ] [ -f newsrc-file ] [
  12.        -create ] [ -C ] [ -help ]
  13.  
  14. DESCRIPTION
  15.        slrn is an easy to use but powerful NNTP based newsreader.
  16.        It  relies  extensively on the S-Lang programmer's library
  17.        for many of its features.
  18.  
  19.        If no server is specified on the command line using the -h
  20.        option, the server specified by the NNTPSERVER environment
  21.        variable will be used.   The  -f  option  specifies  which
  22.        newsrc  file  should  be  used.   If  none is specified, a
  23.        default value of .jnewsrc will be used. This value can  be
  24.        set on a server by server basis using the .slrnrc initial-
  25.        ization file.
  26.  
  27.        The -create option should be used the first time  slrn  is
  28.        used for a particular server. This causes slrn to read the
  29.        entire list of groups available at the  server  and  place
  30.        them  in the selected newsrc file.  If the NNTP connection
  31.        is slow, this process may take  several  minutes.   Fortu-
  32.        nately, this happens only when the -create flag is used.
  33.  
  34.        If  -C  is  specified on the command line, the terminal is
  35.        assumed to support colors.  Colors  may  be  specified  by
  36.        using  the  initialization file.  If the -n option is pre-
  37.        sent, no new newsgroups will be  checked  for.   This  may
  38.        result in a faster startup.
  39.  
  40.  
  41. BASIC OPERATION
  42.        Using  slrn  is simple.  For many, simply typing slrn will
  43.        connect to a news server. After starting, slrn checks  for
  44.        the  existence  of  new  newsgroups and automatically sub-
  45.        scribes to them. Then after new news is checked, slrn goes
  46.        into  ``full  screen''  mode  at  which point the user can
  47.        unsubscribe to one or more groups.  slrn  will  display  a
  48.        list of newsgroups that looks like:
  49.  
  50.        ->  3      sci.research.postdoc                 689-705
  51.            1      comp.databases.olap                  1-1
  52.            4      rec.antiques.radio+phono             1-4
  53.            1      comp.emulators.ms-windows.win        339-349
  54.          113      comp.unix.questions                  74401-74513
  55.           11      gnu.ghostscript.bug                  4874-4884
  56.          100      alt.music.pink-floyd                 7941-8040
  57.           11      rec.sport.baseball.analysis          239-249
  58.            3      rec.sport.baseball.data              267-269
  59.           13      sci.physics.electromag               1159-1171
  60.           65      comp.sys.ibm.pc.hardware.systems     4754-4818
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SLRN(1)                                                   SLRN(1)
  71.  
  72.  
  73.            5      sci.physics.particle                 1069-1073
  74.            2      comp.sources.x                       2362-2363
  75.            2      comp.unix.user-friendly              2603-2604
  76.  
  77.        Here  the  middle column shows the name of a newsgroup and
  78.        the left column shows the number of unread articles in the
  79.        group.  The  right column shows the range of articles pre-
  80.        sent on the server. Note the presence of  the  ->  in  the
  81.        first column on the `sci.research.postdoc' line. This sym-
  82.        bol is used by slrn as a pointer to indicate the currently
  83.        selected  line.  It  may be moved up and down by using the
  84.        arrow keys. Pressing the RETURN key  or  the  SPACEBAR  at
  85.        this point will select the `sci.research.postdoc' group. A
  86.        new screen will appear showing something like:
  87.  
  88.        ->-   703   (P) Lecturer in Comp.        dumontet@nuri.inria.fr (dumo
  89.          -   704   Research & Developnment      dumontet@nuri.inria.fr (dumo
  90.          -   705   Re: Example of proposal      shinbrot@bart.chem-eng.nwu.e
  91.  
  92.        Here, each line consists of four fields and  possibly  the
  93.        ->  cursor.  The first field indicates whether the article
  94.        has been read or not. A hyphen ( - ) in  the  first  field
  95.        indicates  that  the  article  has not been read.  Since a
  96.        hyphen appears in the first field  in  all  three  of  the
  97.        lines  above,  none  of  the  articles have been marked as
  98.        read. A d in this field indicates that an article has been
  99.        read.  The  currently selected article can be changed from
  100.        the read to the unread state by pressing the u key. The  d
  101.        key  may be used to mark the article as read without actu-
  102.        ally reading it.  The c key may be used to  mark  all  the
  103.        articles  as  read  (Actually this is the preferred way to
  104.        use the newsreader: scan the articles by eye  looking  for
  105.        something  interesting then before moving on to next news-
  106.        group, press `c' to mark all articles as read).
  107.  
  108.        The second field displays the server number of  the  arti-
  109.        cle.  The  third and fourth fields contain the subject and
  110.        author of the article, respectively.
  111.  
  112.        Pressing the SPACEBAR or the RETURN key will create a sec-
  113.        ond  window  and  display  the  contents  of the currently
  114.        selected article. The screen will now consist of two  win-
  115.        dows  -  a  large  one  and a small one. The large window,
  116.        known as the article window, will  contain  the  currently
  117.        selected  article  and the small one, known as the summary
  118.        window, will contain the list of articles as shown  above.
  119.        The  space  bar may be used the scroll the article forward
  120.        and the DELETE key or the `B' key may be used to scroll it
  121.        backward. The UP/DOWN arrow keys simply move the -> cursor
  122.        from one line to another in the summary  window.  To  hide
  123.        the  article  window,  press  the h key.This will zoom the
  124.        summary window to full screen.
  125.  
  126.        The f key may be used to post a followup to the  currently
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SLRN(1)                                                   SLRN(1)
  137.  
  138.  
  139.        selected  article.  To  return  to the list of Newsgroups,
  140.        press the Q key to leave this mode.
  141.  
  142. DEFAULT KEYBINDINGS
  143.        These keybindings are always available: These  keybindings
  144.        are always available:
  145.  
  146.        ?      Help
  147.  
  148.        PageUp Ctrl-U
  149.               Page up
  150.  
  151.        PageDn Ctrl-D
  152.               Page down
  153.  
  154.        Ctrl-Z Suspend program
  155.  
  156.        These keybindings may be used at the newsgroup level:
  157.  
  158.        SPACE   Select articles for the current group.
  159.  
  160.        UP P    Move to the previous group
  161.  
  162.        DOWN    Move to the next group
  163.  
  164.        q       Quit the program
  165.  
  166.        p       Post an article
  167.  
  168.        l       Toggle  the display of groups with no unread arti-
  169.                cles on and off
  170.  
  171.        L       Toggle display of unsubscribed  groups  (can  also
  172.                subscribe with this)
  173.  
  174.        u       Unsubscribe from the current group
  175.  
  176.        s       Subscribe to the current group
  177.  
  178.        c       Mark all articles in the current group as read.
  179.  
  180.        a       Subscribe to a specified group
  181.  
  182.        /       Search for a subscribed group
  183.  
  184.        G       Refresh groups from news server
  185.  
  186.        X       Save .newsrc
  187.  
  188.        ESC >   Move to last group
  189.  
  190.        ESC <   Move to first group
  191.  
  192.        The following bindings are valid once a newsgroup has been
  193.  
  194.  
  195.  
  196.                                                                 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SLRN(1)                                                   SLRN(1)
  203.  
  204.  
  205.        selected:
  206.  
  207.        SPACE   Select or scroll currently selected  article  for-
  208.                ward
  209.  
  210.        DELETE, b
  211.                Scroll currently selected article backward
  212.  
  213.        d       Mark  currently  selected article as read and move
  214.                to the next unread article.
  215.  
  216.        u       Mark the currently selected article as unread
  217.  
  218.        #       Numerically tag the article for multiple save (see
  219.                o command)
  220.  
  221.        g       Skip to next digest
  222.  
  223.        h       Hide  the  article  window  by zooming the summary
  224.                window to full screen
  225.  
  226.        Ctrl-^  Decrease the size of  the  header  window  by  one
  227.                line.
  228.  
  229.        ^       Increase  the  size  of  the  header window by one
  230.                line.
  231.  
  232.        f       Post follow-up to the currently selected article
  233.  
  234.        F       Forward the currently selected article to someone
  235.  
  236.        r       Reply directly to  the  author  of  the  currently
  237.                selected article
  238.  
  239.        o       Save the currently selected article or thread to a
  240.                file in a Unix mail format by appending it to  the
  241.                the  specified  file,  then  optionally decode the
  242.                articles with uudecode or unshar.  If  numerically
  243.                tagged articles (see # ) are present, then option-
  244.                ally save and then  decode  the  tagged  articles.
  245.                The  built-in uudecoder can decode files that con-
  246.                tain multiple multi-part uuencoded articles.  How-
  247.                ever,  they  must  be  tagged in the proper order.
  248.                The key ESC # may be used to un-tag articles.
  249.  
  250.        q       Quit and go back to the list of newsgroups
  251.  
  252.        T       Toggle quote display
  253.  
  254.        K       Toggle scoring
  255.  
  256.        TAB     Skip over quotes in article
  257.  
  258.        t       Toggle the current articles headers between hidden
  259.  
  260.  
  261.  
  262.                                                                 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. SLRN(1)                                                   SLRN(1)
  269.  
  270.  
  271.                and  un-hidden  states.  By default, uninteresting
  272.                ones are hidden
  273.  
  274.        UP      Move to the previous article
  275.  
  276.        DOWN    Move to the next article
  277.  
  278.        ESC DOWN, RETURN
  279.                Scroll the article down one line
  280.  
  281.        <       Jump to the beginning of the article
  282.  
  283.        ESC UP  Scroll the article up one line
  284.  
  285.        ESC >   Move to last article
  286.  
  287.        ESC <   Move to first article
  288.  
  289.        RIGHT   Pan the article window to the right
  290.  
  291.        LEFT    Pan the article window to the left
  292.  
  293.        n       Move to the next unread article
  294.  
  295.        o       Append article to a file; optionally, decode  with
  296.                uudecode or shar
  297.  
  298.        p       Move to a previously unread article
  299.  
  300.        PageUp, PageDn
  301.                Page up and down through the header list.
  302.  
  303.        /       Search forward in the article
  304.  
  305.        ?       Search backward through article.
  306.  
  307.        a       Author search forward.
  308.  
  309.        A       Author search backward.
  310.  
  311.        s       Subject search forward.
  312.  
  313.        S       Subject search backward
  314.  
  315.        H       Hide the article  (make its window disappear)
  316.  
  317.        N       Skip to next news group
  318.  
  319.        j       Move to an article
  320.  
  321.        P       Post  an  article  (also see f to post a follow-up
  322.                article)
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                                                 5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. SLRN(1)                                                   SLRN(1)
  335.  
  336.  
  337.        SEMICOLON
  338.                Set a mark at the current article.
  339.  
  340.        COMMA   Return to a previously set mark setting  the  mark
  341.                first.
  342.  
  343.        *       Flag  the article as 'important' (prevents catchup
  344.                in header window from marking the article deleted)
  345.  
  346.        |       Pipe article to an external command
  347.  
  348.        ESC Ctrl-C
  349.                Cancel the current article.
  350.  
  351.        c       Mark all articles as read
  352.  
  353.        ESC C   Mark articles to here as read
  354.  
  355.        ESC U   Mark articles to here as UN-read
  356.  
  357.        Ctrl-R, Ctrl-L
  358.                Redraw the screen.
  359.  
  360.        ESC R   Toggle ROT 13 decryption on and off
  361.  
  362.        ESC S   Toggle header threading on and off
  363.  
  364.        ESC T   Toggle collapse of header threading
  365.  
  366.        ESC A   Switch between header display methods
  367.  
  368.        ESC p   Find parent header
  369.  
  370.        ESC Ctrl-P
  371.                Find child header
  372.  
  373.        ?       Show help
  374.  
  375.        Ctrl-Z  Suspend the newsreader.
  376.  
  377.        E       Edit  score  parameters using this article as tem-
  378.                plate
  379.  
  380. ENVIRONMENT VARIABLES
  381.        slrn uses the following list of environment variables:
  382.  
  383.        NNTPSERVER  NNTP Server to connect to  if  none  specified
  384.                    when slrn is started.
  385.  
  386.        EDITOR
  387.  
  388.        SLANG_EDITOR
  389.                    Editor  to  use  when  composing messages. The
  390.                    '%s' and `%d' format descriptors may  be  used
  391.  
  392.  
  393.  
  394.                                                                 6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. SLRN(1)                                                   SLRN(1)
  401.  
  402.  
  403.                    to   specify  the  filename  and  line  number
  404.                    respectively. For example, if  `jed'  is  your
  405.                    editor,  then  you  can  use  something  like:
  406.                    setenv SLANG_EDITOR 'jed %s  -g  %d'  in  your
  407.                    shell  startup  file.  If you are using a bash
  408.                    shell, you  could  instead  use  the  command:
  409.                    export  SLANG_EDITOR='jed  %s  -g  %d' in your
  410.                    shell startup file.  SLANG_EDITOR is the pref-
  411.                    ered  environment  variable  since  all slang-
  412.                    applications that use an editor look for  this
  413.                    variable and understand this syntax.
  414.  
  415.        REPLYTO     Address  to  be  inserted  into the `Reply-To'
  416.                    field.
  417.  
  418.        ORGANIZATION
  419.                    String to be used in the `Organization' field.
  420.  
  421. slrn INITIALIZATION FILE
  422.        If  a  file  called  .slrnrc  is present in the users HOME
  423.        directory, slrn will use it  as  an  initialization  file.
  424.        This  file can contain list of personalized keybindings as
  425.        well as a list of server -- newsrc mappings.
  426.  
  427.  
  428.        BINDING KEYS
  429.  
  430.        To bind a key to a particular function use the syntax:
  431.  
  432.        setkey keymap function key-sequence
  433.  
  434.        The setkey function  requires  three  arguments.The  first
  435.        argument specifies the keymap to be used for the bindings.
  436.        Valid keymaps are: group and article.  The function  argu-
  437.        ment  spacifies the function that is executed when keys in
  438.        the last argument are pressed. For example,
  439.  
  440.                               setkey  group  quit "x"
  441.  
  442.        indicates that if x is pressed at  the  group  level,  the
  443.        quit  function  will  be  executed. Note that although not
  444.        normally necessary, the last argument should  be  enclosed
  445.        in double quotes since it may contain SPACE characters.
  446.  
  447.        The  key-sequence  argument can consist of several charac-
  448.        ters. For example, on  many  terminals,  the  RIGHT  arrow
  449.        sends  the three characters ESC, `[' and `C' to the termi-
  450.        nal. To bind the RIGHT  key  to  `select_group'  function,
  451.        use:
  452.  
  453.                                setkey group select_group "\e[C"
  454.  
  455.        Sometimes,  it  is necessary to unbind a key from a keymap
  456.        before binding the key. For example, one cannot do:
  457.  
  458.  
  459.  
  460.                                                                 7
  461.  
  462.  
  463.  
  464.  
  465.  
  466. SLRN(1)                                                   SLRN(1)
  467.  
  468.  
  469.                                setkey group quit "\e"
  470.  
  471.        to bind the ESC key to the  quit  function  without  first
  472.        unsetting  it.   This  is because the default bindings use
  473.        the ESC character as  the  prefix  character  for  certain
  474.        keymaps. To achieve this goal, use the unsetkey function:
  475.  
  476.                                 unsetkey group "\e"
  477.                                 setkey group quit "\e"
  478.  
  479.        Here  the  unsetkey  function  has been used to remove the
  480.        binding for the ESC character before  binding  it  to  the
  481.        `quit'  function.   Please note that unsetting the ESC key
  482.        will also unset any key sequence been with  the  ESC  key.
  483.        This includes most function keys.
  484.  
  485.        See  the example initialization file below for the list of
  486.        functions and their meaning.
  487.  
  488.        USING MULTIPLE SERVERS
  489.  
  490.        The easiest way to use multiple servers is through the use
  491.        of  the  server  command in the .slrnrc file. This command
  492.        simple associates a server name with a newsrc file:
  493.  
  494.        server nntp-server newsrc-file
  495.  
  496.        For example, suppose that you use three servers with host-
  497.        names       `red.news.edu',      `blue.news.edu',      and
  498.        `green.news.edu'. The the lines:
  499.  
  500.        server red.news.edu .jnewsrc-red
  501.  
  502.        server blue.news.edu .jnewsrc-blue
  503.  
  504.        server green.news.edu .jnewsrc-green
  505.  
  506.        specify that the file .jnewsrc-red is to be used when  the
  507.        server red.news.edu connected to, etc...
  508.  
  509.        DEFINING COLORS
  510.  
  511.        Color  support is enabled when suing the `-C' command line
  512.        switch.  The colors may be defined through the use of  the
  513.        `color' keyword in the `.slrnrc' file.  The syntax is:
  514.  
  515.            color OBJECT-NAME FOREGROUND-COLOR BACKGROUND-COLOR
  516.  
  517.          Here, OBJECT-NAME can be any one of the following items:
  518.  
  519.            menu           --  Line at the top of the display (menu bar)
  520.            menu_press     --  Menu bar entry when activated
  521.            status         --  Status line attached to windows
  522.            cursor         --  The --> position indicator
  523.  
  524.  
  525.  
  526.                                                                 8
  527.  
  528.  
  529.  
  530.  
  531.  
  532. SLRN(1)                                                   SLRN(1)
  533.  
  534.  
  535.            error          --  Error messages
  536.            group          --  Newsgroup names (group mode)
  537.            description    --  Newsgroup descriptions (group mode)
  538.            article        --  The body of the article (not headers)
  539.            headers        --  The lines that constitute the headers of the article
  540.            author         --  Author's name
  541.            subject        --  Subject
  542.            signature      --  Author's signature
  543.            quotes         --  Quoted material
  544.            high_score     --  Articles with high scores
  545.            tree           --  Article tree
  546.            tilde          --  Tildes (tilde mode)
  547.            thread_number  --  Thread numbers
  548.            normal         --  anything not included above
  549.  
  550.          The foreground/background color names can be any of  the
  551.        following:
  552.  
  553.            black                gray
  554.            red                  brightred
  555.            green                brightgreen
  556.            brown                yellow
  557.            blue                 brightblue
  558.            magenta              brightmagenta
  559.            cyan                 brightcyan
  560.            lightgray            white
  561.  
  562.          Most terminals do not support the second group of colors
  563.        for the background.
  564.  
  565.  
  566.        HIDING QUOTED ARTICLES
  567.        
  568.          Often articles  contain  quotes  of  previous  articles.
  569.        slrn is capable of not displaying lines in an article that
  570.        match a given regular expression.  The regular  expression
  571.        may be specified by putting a line of the form
  572.  
  573.             ignore_quotes  REGULAR-EXPRESSION
  574.  
  575.        in  the .slrnrc startup file.  The default regular expres-
  576.        sion is
  577.  
  578.             "^ ?[:>=]"
  579.  
  580.        which matches any line that begins with or without a space
  581.        followed by either a colon, greater than sign, or an equal
  582.        sign.
  583.  
  584.        To toggle the display of such lines on or off,  press  the
  585.        `T' key when in article mode.
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.                                                                 9
  593.  
  594.  
  595.  
  596.  
  597.  
  598. SLRN(1)                                                   SLRN(1)
  599.  
  600.  
  601. ARTICLE SCORING
  602.        (For a complete description of the flexibility in the slrn
  603.        scorefile system, see the files KILL_FAQ and score.txt  in
  604.        the slrn distribution)
  605.  
  606.        slrn incorporates a sophisticated system for scoring arti-
  607.        cles.  In other newsreaders, one of  slrn's  scoring  fea-
  608.        tures  would  be  called  a " killfile ".  But unlike some
  609.        other newsreaders, slrn provides for  a  great  degree  of
  610.        flexibility  and  the  capability to mark articles in ways
  611.        other than merely killing them.
  612.  
  613.        Four levels of scoring are provided:
  614.  
  615.        -9999  The scored article is deleted  (as  with  a  common
  616.               killfile) and will not appear in the header window
  617.  
  618.        -1 through -9998
  619.               The  scored  article  appears  with  a  " D " as in
  620.               "Deleted" flag in the header window
  621.  
  622.        0 normal article
  623.  
  624.        1 through 99999
  625.               The scored article's header appears with a "  !   "
  626.               flag to indicate importance
  627.  
  628.        CONFIGURING THE SCOREFILE
  629.  
  630.        The  scorefile  system is disabled until you set scorefile
  631.        to the pathname of the file slrn should use  to  hold  the
  632.        scoring parameters.
  633.  
  634.        Once  set, scorefile may be accessed through the E command
  635.        at the header window, or may  be  edited  manually.   When
  636.        accessed  with  E , slrn appends a template based upon the
  637.        currently selected article to the scorefile  with  various
  638.        parameters  taken  from  the article and you are placed in
  639.        your editor.  To enable scoring, delete the % comment sym-
  640.        bol  from  the first column of the header line(s) you wish
  641.        to score upon.
  642.  
  643.        The other way to configure your scorefile  is  by  editing
  644.        the  file  directly, with a text editor.  Here is a sample
  645.        scorefile (remember the KILL_FAQ and score.txt  files  are
  646.        the definitive references for the score system):
  647.  
  648.          [news.software.readers]
  649.             Score: 9999
  650.             % All slrn articles are good
  651.             Subject: slrn
  652.  
  653.             Score: 9999
  654.             % This is someone I want to hear from
  655.  
  656.  
  657.  
  658.                                                                10
  659.  
  660.  
  661.  
  662.  
  663.  
  664. SLRN(1)                                                   SLRN(1)
  665.  
  666.  
  667.             From: davis@space.mit.edu
  668.  
  669.             Score = -9999
  670.             Subject: <f?agent>
  671.  
  672.          [comp.os.linux.*]
  673.             Score: -10
  674.             Expires: 1/1/1996
  675.             Subject: swap
  676.  
  677.             Score: 20
  678.             Subject: SunOS
  679.  
  680.             Score: 50
  681.             From: Linus
  682.  
  683.  
  684.             % Kill all articles cross posted to an advocacy group
  685.             Score: -9999
  686.             Xref: advocacy
  687.             ~From: Linus
  688.  
  689.             % This person I want nothing to do with unless he posts about
  690.             % `gizmos' but only in comp.os.linux.development.*
  691.  
  692.             Score: -9999
  693.             From: someone@who.knows.where
  694.             ~Subject: gizmo
  695.             ~Newsgroup: development
  696.  
  697.             % These stooges post massive .sigs all the time.  I like
  698.             % to track them
  699.  
  700.             [alt.fan.warlord]
  701.             Score:: 20
  702.             Subject: larry
  703.             Subject: curly
  704.  
  705.  
  706.        This  file  consists  of  two sections.  The first section
  707.        defines    a    set    of    tests    applied    to    the
  708.        news.software.readers   newsgroups.   The  second  section
  709.        applies to the comp.os.linux newsgroups.
  710.  
  711.        The first section consists of three tests.  The first test
  712.        applies  a  score of 9999 to any subject that contains the
  713.        string `slrn'.  The second test applies to the `From'.  It
  714.        says that any article from davis@space.mit.edu gets scores
  715.        9999.  The third test gives a score of -9999 to any  arti-
  716.        cle  whose subject contains the word `agent'.  Since tests
  717.        are applied in order, if an article contains  both  `slrn'
  718.        and  `agent',  it will be given a score of 9999 since 9999
  719.        is a special score value.
  720.  
  721.  
  722.  
  723.  
  724.                                                                11
  725.  
  726.  
  727.  
  728.  
  729.  
  730. SLRN(1)                                                   SLRN(1)
  731.  
  732.  
  733.        The second section is more complex.   It  applies  to  the
  734.        newsgroups  comp.os.linux  newsgroups  and  consists  of 5
  735.        tests.  The first three are simple: -10 points  are  given
  736.        if  the  subject contains `swap', 20 if it contains SunOS,
  737.        and 50 if the article is from someone named `Linus'.  This
  738.        means  that if Bill@Somewhere writes an article whose sub-
  739.        ject is `Swap,  Swap,  Swap',  the  article  is  give  -10
  740.        points.   However, if the Linus writes an article with the
  741.        same title, it is given -10 + 50 = 40 points.   Note  that
  742.        the first test expires at the beginning of 1996.
  743.  
  744.        The  fourth test kills all articles that were cross posted
  745.        to an advocay newsgroup UNLESS they were posted by  Linus.
  746.        Note  that if a keyword begins with the `~' character, the
  747.        effect of the regular expression is reversed.
  748.  
  749.        The fourth test serves to  filter  out  posts  from  some-
  750.        one@who.knows.where  unless he posts about `gizmos' in one
  751.        of the comp.os.development newsgroups.  Again note the `~'
  752.        character.
  753.  
  754.        The  last test marks as important messages from mentioning
  755.        Moe or  Curly  in  the  alt.fan.warlord  newsgroup.   This
  756.        demonstrates use of an "OR" condition in a scorefile.
  757.  
  758.  
  759.  
  760. COURTESY COPY
  761.        If  you  elect  to  send  a courtesy copy of your followup
  762.        article to the original poster, you may easily  do  so  by
  763.        adding  a "Cc:" header to the article.  Here is an example
  764.        of how to send a courtesy  copy  of  a  followup  to  John
  765.        Davis' (slrn's author) announcement of a new slrn version:
  766.  
  767.         Newsgroups: news.software.readers
  768.         Subject: Re: slrn 0.8.0 Released!
  769.         References: <46c6b8$e2@news.mit.edu>
  770.         Organization: a clean well lit place
  771.         Reply-To: hg@n2wx.ampr.org
  772.         Followup-To:
  773.         Cc: davis@space.mit.edu
  774.  
  775.  
  776.         On   22   Oct   1995    01:26:45    GMT,    John    Davis
  777.        <davis@space.mit.edu> wrote:
  778.         ...
  779.  
  780.        John will receive a copy of the followup by email with the
  781.        article text preceded by a line of text stating that [This
  782.        message  has  also  been  posted.]   (The  text within the
  783.        brackets   may   be   customized    with    the    .slrnrc
  784.        cc_followup_string parameter.)
  785.  
  786.  
  787.  
  788.  
  789.  
  790.                                                                12
  791.  
  792.  
  793.  
  794.  
  795.  
  796. SLRN(1)                                                   SLRN(1)
  797.  
  798.  
  799.        MISCELLANEOUS SETTINGS
  800.  
  801.        The  .slrnrc initialization file also supports the follow-
  802.        ing commands:
  803.  
  804.           signature             <signature file name>
  805.           organization          <Your organization name>
  806.           replyto               <Email address to be used reply to>
  807.           quote_string          <string to be used to quote an article>
  808.           editor_command        <string used to invoke editor>
  809.           scorefile             <score file name>
  810.  
  811.  
  812.        For example,
  813.  
  814.           signature         .news-signature
  815.           organization      "Society of Famous Outlaws"
  816.           signature         "Billy the Kid"
  817.           quote_string      ">"
  818.           editor_command    "jed %s -g %d -tmp"
  819.           scorefile         "News/Score"
  820.  
  821.  
  822.  
  823.  
  824. FILES
  825.        $HOME/.slrnrc - the slrn's initialization file
  826.  
  827.        $HOME/.jnewsrc - default newsrc file for slrn.
  828.  
  829. EXAMPLE OF AN INITIALIZATION FILE
  830.         % This is a sample startup file for the slrn news reader.  The percent
  831.         % character is used for comments.
  832.  
  833.         % SERVER to NEWSRC mapping
  834.         %server hsdndev.harvard.edu .jnewrc-hsdndev
  835.         %server news.uni-stuttgart.de .jnewsrc-stuttgart
  836.  
  837.         % The next line is for those servers that require a password.
  838.         %nnrpaccess HOSTNAME USERNAME PASSWORD
  839.  
  840.  
  841.         %hostname "YOUR.HOSTNAME"
  842.         %username "jdoe"
  843.         %realname "John Doe"
  844.         %replyto  "jd@somthing.com"
  845.  
  846.         % Name of signature file to use
  847.         %set signature ".signature"
  848.  
  849.         The quote string will be used when following up/replying
  850.         quote_string ">"
  851.  
  852.         % This regular expression defines lines that are consider to be quoted lines.
  853.  
  854.  
  855.  
  856.                                                                13
  857.  
  858.  
  859.  
  860.  
  861.  
  862. SLRN(1)                                                   SLRN(1)
  863.  
  864.  
  865.         % It says that any lines beginning with 0-2 spaces followed by a either
  866.         % a >, <, :, |, or = character is a quoted line.
  867.         ignore_quotes "^ ? ?[><:=|]"
  868.  
  869.         % This sets the follow-up string.  Here, the following format specifiers are
  870.         % recognized: %d:date, %r:real name, %f:email address, %s:subject,
  871.         %             %m:msgid, %n:newsgroups, %%: percent
  872.         followup "On %d, %r <%f> wrote:"
  873.  
  874.         %Custom headers to add to post/followup
  875.         %set custom_headers "X-Whatever: bla0-Misc: bla bla"
  876.  
  877.         % WWW browser to use.  The 'U' key in article mode searches the current article
  878.         % for a URL and then calls X browser if slrn appears to be run in X windows
  879.         % and non_Xbrowser otherwise.
  880.         set Xbrowser "netscape %s &"
  881.         set non_Xbrowser "lynx %s"
  882.  
  883.         % If autobaud is present, output rate will be synced to baud rate
  884.         %autobaud
  885.  
  886.         % if non-zero, display first article when entering article-mode.
  887.         set show_article 0
  888.  
  889.         % if non-zero, show description of newsgroup if available
  890.         set show_descriptions 1
  891.  
  892.         % column where group descriptions start
  893.         set group_dsc_start_column 40
  894.  
  895.         % If non-zero, backups of the newsrc file are not performed.
  896.         set no_backups 0
  897.  
  898.         % If 0, do not beep terminal.  If 1, send audible beep.  If 2, send only
  899.         % visible bell.  If 3, send both.
  900.         set beep 1
  901.  
  902.         % If non-zero, slrn will automatically subscribe new groups.  The default is 0.
  903.         set unsubscribe_new_groups 0
  904.  
  905.         % If non-zero, all subject titles will be displayed even though many are
  906.         % duplicated.  A zero value makes the screen look less busy.
  907.         set show_thread_subject 0
  908.  
  909.         % Enable xterm mouse support: 1 to enable, 0 to disable
  910.         set mouse 0
  911.  
  912.         % Setting either of these to 0 will enable you to move directly to the
  913.         % next article/group without confirmation
  914.         set query_next_group 1
  915.         set query_next_article 1
  916.  
  917.         % if zero, you will not see the "next group:" prompt.  This is NOT the same
  918.         % as the 'query_next_group' variable.
  919.  
  920.  
  921.  
  922.                                                                0n
  923.  
  924.  
  925.  
  926.  
  927.  
  928. SLRN(1)                                                   SLRN(1)
  929.  
  930.  
  931.         set prompt_next_group 1
  932.  
  933.         % Set this to 0 for no-confirmation on follow, reply, quit, etc...
  934.         set confirm_actions 1
  935.  
  936.         % If 0, do not display the name of the author.
  937.         % If 1, display subject then name.  If 2, display name then subject.
  938.         set author_display 2
  939.  
  940.         % If 0, save all groups when writing newsrc file
  941.         % if 1, do not save any unsubscribed groups
  942.         % if 2, do not save any unread-unsubscribed groups
  943.         set write_newsrc_flags 1
  944.  
  945.         % If greater than 0, a Cc: header to poster will automatically be generated on
  946.         % followups.  If -1, prompt first.
  947.         set cc_followup 0
  948.         cc_followup_string "[This message has also been posted.]"
  949.  
  950.         % The sendmail command allows you to substitute another mailer.  Be sure that
  951.         % it implements the same interface as sendmail!
  952.         %set sendmail_command "/usr/lib/sendmail -oi -t -oem -odb"
  953.  
  954.  
  955.         % Name of score file  (relative to HOME directory)
  956.         scorefile "News/Score"
  957.  
  958.         % Name of directory where decoded files are placed (relative to HOME)
  959.         set decode_directory "News"
  960.         % Directory where all other files are saved.
  961.         set save_directory "News"
  962.  
  963.         % Command used to invoke editor.  In the following example, %s represents
  964.         % the file name and %d represents the starting line number
  965.         %editor_command "jed %s -g %d -tmp"
  966.  
  967.         % If  non-zero, files used for posting, followup and reply will be regarded as
  968.         % temporary files in the directory specified by the TMPDIR environment
  969.         % variable or /tmp.
  970.         set use_tmpdir 0
  971.  
  972.         % If 0, do not sort.  If 1, perform threading.  If 2, sort by subject
  973.         % If 3, thread then sort result by subject
  974.         % If 4, sort by score.  If 5, thread then sort by score.
  975.         set sorting_method 3
  976.         set display_score 0
  977.  
  978.         % If non-zero, threads will be uncollapsed when a group is entered
  979.         set uncollapse_threads 0
  980.  
  981.         % If non-zero, slrn will read the active file when starting.   This may lead to
  982.         % faster startup times IF your network connection is fast.  If it slow,
  983.         % DO NOT USE IT.  If you can, I recommend setting it to 1.
  984.         set read_active 0
  985.  
  986.  
  987.  
  988.                                                                0o
  989.  
  990.  
  991.  
  992.  
  993.  
  994. SLRN(1)                                                   SLRN(1)
  995.  
  996.  
  997.         % If non-zero and read_active is zero, slrn will attempt to use the NNTP
  998.         % XGTITLE command when listing unsubscribed groups.
  999.         set use_xgtitle 0
  1000.  
  1001.         % What to wrap when wrapping an article:
  1002.         %  0 or 4 ==> wrap body
  1003.         %  1 or 5 ==> wrap headers, body
  1004.         %  2 or 6 ==> wrap quoted text, body
  1005.         %  3 or 7 ==> wrap headers, quoted text, body
  1006.         % The higher number indicates that every article will be automatically
  1007.         % wrapped.
  1008.         set wrap_flags 4
  1009.  
  1010.         % Maximum number of articles to read before slrn will prompt.  Default is 100.
  1011.         % Set this to zero to turn of prompting.
  1012.         set query_read_group_cutoff 100
  1013.  
  1014.         % Numes of lines to read from the server between percentage counter updates
  1015.         % This number will vary with the speed of the connection to your server
  1016.         set lines_per_update 100
  1017.  
  1018.         %---------------------------------------------------------------------------
  1019.         % Mime support
  1020.         %---------------------------------------------------------------------------
  1021.         set use_mime 1
  1022.         set mime_charset "iso-8859-1"
  1023.         % If non-zero, call metamail for mime formats that slrn does not handle
  1024.         set use_metamail 1
  1025.  
  1026.         % If non-zero, header numbers will be displayed in the left-margin of the
  1027.         % header window.  These numbers may be used as ``thread selectors''.
  1028.         set use_header_numbers 1
  1029.  
  1030.         % If non-zero, prompt for reconnection if the NNTP connection drops.  If zero,
  1031.         % attempt reconnection without asking user.
  1032.         set query_reconnect 1
  1033.  
  1034.         % Character to use to hide spoiler text:
  1035.         set spoiler_char '*'
  1036.  
  1037.  
  1038.         %---------------------------------------------------------------------------
  1039.         %  Local spool configuration
  1040.         %---------------------------------------------------------------------------
  1041.         % set spool_inn_root "/export/opt/inn"
  1042.         % set spool_root "/export/news"
  1043.         % set spool_nov_root "/export/news"
  1044.         %
  1045.         %% -- The following filenames are relative to spool_root
  1046.         %
  1047.         % set spool_nov_file ".overview"
  1048.         % set spool_active_file "data/active"
  1049.         % set spool_activetimes_file "data/active.times"
  1050.         % set spool_newsgroups_file "data/newsgroups"
  1051.  
  1052.  
  1053.  
  1054.                                                                0p
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. SLRN(1)                                                   SLRN(1)
  1061.  
  1062.  
  1063.         %---------------------------------------------------------------------------
  1064.         %  GroupLens Support
  1065.         %---------------------------------------------------------------------------
  1066.         %set use_grouplens 1
  1067.         %color grouplens_display blue white
  1068.         %set grouplens_host          "grouplens.cs.umn.edu"
  1069.         %set grouplens_port          9000
  1070.         %set grouplens_pseudoname    "YOUR_PSEUDONAME"
  1071.         %grouplens_add "rec.cooking.recipes"
  1072.         %grouplens_add "comp.os.linux.misc"
  1073.  
  1074.         %------------
  1075.         % Colors
  1076.         %------------
  1077.         color header_number green white
  1078.         color normal black white
  1079.         color error red white
  1080.         color status yellow blue
  1081.         color normal black white
  1082.         color error red white
  1083.         color status yellow blue
  1084.         color group blue white
  1085.         color article blue white
  1086.         color cursor brightgreen white
  1087.         color author magenta white
  1088.         color subject black white
  1089.         color headers brightcyan white
  1090.         color menu yellow blue
  1091.         color menu_press yellow blue
  1092.         color tree red white
  1093.         color quotes red white
  1094.         color thread_number blue white
  1095.         color high_score red white
  1096.         color signature red white
  1097.         color description blue white
  1098.         color tilde green white
  1099.  
  1100.         %-----------------------------------------------------
  1101.         % Monochrome attributes for monochrom terminals
  1102.         %-----------------------------------------------------
  1103.         mono normal        none
  1104.         mono header_number none
  1105.         mono error         blink bold
  1106.         mono status        reverse
  1107.         mono group         bold
  1108.         mono article       none
  1109.         mono cursor        bold reverse
  1110.         mono author        none
  1111.         mono subject       none
  1112.         mono headers       bold
  1113.         mono menu          reverse
  1114.         mono menu_press         none
  1115.         mono tree          bold
  1116.         mono quotes        underline
  1117.  
  1118.  
  1119.  
  1120.                                                                0q
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. SLRN(1)                                                   SLRN(1)
  1127.  
  1128.  
  1129.         mono thread_number bold
  1130.         mono high_score         bold
  1131.         mono signature          none
  1132.         mono description   none
  1133.  
  1134.         %------------------------  Group keymap------------------------------------
  1135.  
  1136.         setkey group  add_group "A"    %  add a new newsgroup
  1137.         setkey group  bob       "\<"  %  beg of buffer
  1138.         setkey group  bob       "^K\OA"
  1139.         setkey group  bob       "^K\[A"
  1140.         setkey group  catch_up  "C"    %  mark group as read
  1141.         setkey group  down      "\OB" %  next group
  1142.         setkey group  down      "\[B"
  1143.         setkey group  down      "^N"
  1144.         setkey group  eob       "\>"  %  end of buffer
  1145.         setkey group  eob       "^K\OB"
  1146.         setkey group  eob       "^K\[B"
  1147.         setkey group  group_search_forward     "/"
  1148.         setkey group  help      "?"
  1149.         setkey group  pagedown  "^D"   %  next page of groups
  1150.         setkey group  pagedown  "\[6~"
  1151.         setkey group  pagedown  "^V"
  1152.         setkey group  pageup         "\V"  %  previous page of groups
  1153.         setkey group  pageup         "^U"
  1154.         setkey group  pageup         "\[5~"
  1155.         setkey group  post      "P"
  1156.         setkey group  quit      "Q"
  1157.         setkey group  redraw         "^L"
  1158.         setkey group  redraw         "^R"
  1159.         setkey group  refresh_groups "G"
  1160.         setkey group  save_newsrc    "X""  %  read articles from group
  1161.         setkey group  select_group   "
  1162.         setkey group  select_group   " "
  1163.         setkey group  subscribe "S"    %  subscribe to group (See unsubscribe)
  1164.         setkey group  suspend        "^Z"
  1165.         setkey group  toggle_group_display     " 33A"
  1166.         setkey group  toggle_score   "K"
  1167.         setkey group  toggle_hidden  "l"
  1168.         setkey group  toggle_list_all     "L"
  1169.         setkey group  unsubscribe    "U"    %  unsubscribe
  1170.         setkey group  up        "\OA" %  previous line
  1171.         setkey group  up        "\[A"
  1172.         setkey group  up        "^P"
  1173.  
  1174.         %---------------- Article mode keymap -------------------------------------
  1175.  
  1176.         setkey article     goto_article   "j"
  1177.         setkey article     pipe_article   "|"
  1178.         setkey article     skip_quotes    ""
  1179.  
  1180.         setkey article     pageup         "^U"
  1181.         setkey article     pageup         "\[5~"
  1182.         setkey article     pageup         "\V"
  1183.  
  1184.  
  1185.  
  1186.                                                                0r
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192. SLRN(1)                                                   SLRN(1)
  1193.  
  1194.  
  1195.         setkey article     pagedn         "\[6~"
  1196.         setkey article     pagedn         "^D"
  1197.         setkey article     pagedn         "^V"
  1198.  
  1199.         setkey article post "P"
  1200.         setkey article toggle_show_author "\a"
  1201.         setkey article get_parent_header "\p"
  1202.         setkey article     catchup_all    "c"
  1203.         setkey article     catchup_all    "\c"
  1204.         setkey article     uncatchup_all  "\u"
  1205.         setkey article     catchup        "\C"
  1206.         setkey article     uncatchup "\U"
  1207.         setkey article     scroll_dn " "  % scroll to next page of article or select article
  1208.         setkey article     scroll_up "^?" % scroll to next page of article
  1209.         setkey article     scroll_up "b"  % (scroll_up or article_pageup)
  1210.         setkey article  article_lineup     "\\[A"    % Scroll article one line up
  1211.         setkey article  article_lineup     "\\OA"
  1212.         setkey article  article_linedn     "\e\e[B"    % Scroll article one line down
  1213.         setkey article  article_linedn     "\e\eOB"
  1214.         setkey article  article_linedn "\r"
  1215.         setkey article  article_search    "/"  % Search forward through article
  1216.         setkey article  author_search_forward  "a"  % Search forward for an author
  1217.         setkey article  author_search_backward "A"  % Search backward for an author
  1218.         setkey article  cancel       "\^C"     % Cancel the article
  1219.         setkey article  delete       "d"  % Mark current article as read and move to the next unread one
  1220.         setkey article  down         "^N" % Move to the next article
  1221.         setkey article  down         "\[B"
  1222.         setkey article  down         "\OB"
  1223.         setkey article  mark_spot    ";"  % Set mark at current article
  1224.         setkey article  exchange_mark     ","  % Set the mark and return to the location of the previous mark.
  1225.         setkey article  followup     "f"  % Followup on the article
  1226.         setkey article  forward      "F"  % Forward the article to someone
  1227.         setkey article  help         "?"  % Show help screen
  1228.         setkey article  hide_article "H"  % Hide the article window.
  1229.         setkey article  art_eob ">"  % goto end of article
  1230.         setkey article  left         "\OD"
  1231.         setkey article  left         "\[D"
  1232.         setkey article  next         "n"  % next unread article
  1233.         setkey article  skip_to_next_group     "N"  % next group
  1234.         setkey article  prev         "p"  % previous unread article
  1235.         setkey article  quit         "q"  % Quit back to group mode.
  1236.         setkey article  redraw       "^L" % Redraw the display
  1237.         setkey article  redraw       "^R"
  1238.         setkey article  reply        "r"  % Reply to the author of the current article
  1239.         setkey article  art_bob "<"  % Goto beginning of article
  1240.         setkey article  right        "\[C"
  1241.         setkey article  right        "\OC"
  1242.         setkey article  save         "O"  % append to a file in Unix mail format
  1243.         setkey article  subject_search_forward "s"  % Search forward/backward for an article with a specific subject
  1244.         setkey article  subject_search_backward     "S"
  1245.         setkey article  suspend      "^Z" % Suspend the newsreader
  1246.         setkey article     toggle_rot13   "\R"
  1247.         setkey article     toggle_sort    "\S"
  1248.         setkey article  toggle_headers    "t"  % Toggle the display of some headers on and off
  1249.  
  1250.  
  1251.  
  1252.                                                                0s
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. SLRN(1)                                                   SLRN(1)
  1259.  
  1260.  
  1261.         setkey article  toggle_quotes     "T"
  1262.         setkey article  undelete     "u"  % Mark the current article as unread
  1263.         setkey article  up      "^P" % Move to the previous article
  1264.         setkey article  up      "\OA"
  1265.         setkey article  up      "\[A"
  1266.         setkey article     header_bob     "\<" % Move to first article in list
  1267.         setkey article     header_eob     "\>" % Move to last article in list
  1268.         setkey article     shrink_window  "^^" % Ctrl-6 or Ctrl-^  % Shrink header window
  1269.         setkey article     enlarge_window "^"  % Shift-6 or just ^ % Enlarge header window
  1270.  
  1271.         %setkey article  skip_to_prev_group ""     % No default binding
  1272.         %setkey article  fast_quit          ""     % No default binding
  1273.  
  1274.         % This is a special hack for HP terminals to get the arrow keys working.
  1275.         % Are there any other terminals being used with non-ANSI arrow keys?
  1276.         #if$TERM hpterm
  1277.           setkey group up "\A"       % "^(ku)"
  1278.           setkey group down "\B"     % "^(kd)"
  1279.           setkey article down "\B"
  1280.           setkey article up "\A"
  1281.           setkey article left "\D"
  1282.           setkey article right "\C"
  1283.         #endif
  1284.  
  1285.  
  1286. SEE ALSO
  1287.        environ(5)
  1288.  
  1289.        Questions about  slrn  may  be  posted  to  the  newsgroup
  1290.        news.software.readers  where  they will be answered by the
  1291.        author of the program.  In addition, announcements of  new
  1292.        versions of slrn are posted there.
  1293.  
  1294.        The  latest  version of slrn is available via anoymous ftp
  1295.        from space.mit.edu in pub/davis/slrn.
  1296.  
  1297.  
  1298. AUTHOR
  1299.        John E. Davis <davis@space.mit.edu>
  1300.  
  1301.  
  1302. ACKNOWLEDGEMENTS
  1303.        (This list is still incomplete)
  1304.  
  1305.        Howard Goldstein <hg@n2wx.ampr.org> for updating this  man
  1306.        page.
  1307.  
  1308.        Andrew Greer <Andrew.Greer@vuw.ac.nz> for the VMS port.
  1309.  
  1310.        Jay Maynard <jmaynard@admin5.hsc.uth.tmc.edu> for the OS/2
  1311.        port.
  1312.  
  1313.        Michael Elkins <elkins@aero.org> for the MIME code.
  1314.  
  1315.  
  1316.  
  1317.  
  1318.                                                                0t
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324. SLRN(1)                                                   SLRN(1)
  1325.  
  1326.  
  1327.        Lloyd Zusman  <ljz@ingress.com>  performed  some  cosmetic
  1328.        improvements.
  1329.  
  1330.        J.B. Nicholson-Owens <jbn@mystery-train.cu-online.com> for
  1331.        extensive testing.
  1332.  
  1333.        Mark Olesen <olesen@weber.me.queensu.ca>  for  suggestions
  1334.        and help with AIX version.
  1335.