home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / c / crr0150a.zip / CRR.DOC < prev    next >
Text File  |  1993-03-20  |  33KB  |  946 lines
  1.  
  2.  
  3.  
  4.                          =============================                         =============================                         =============================
  5.                          = CRR - CP/M offline reader =                         = CRR - CP/M offline reader =                         = CRR - CP/M offline reader =
  6.                          =============================                         =============================                         =============================
  7.  
  8.  
  9.                          Documentation for version 1.50                         Documentation for version 1.50
  10.  
  11.  
  12.  
  13.      ____________     ____________     ____________     Introduction     Introduction     Introduction
  14.  
  15.      CRR     CRR works with Fidonet bulletin boards allowing you to read your
  16.      messages offline (which is supposed to save you money). You download
  17.      the messages in a batch, view them at leisure, and upload your replies
  18.      in another batch.
  19.  
  20.      CRR     CRR works in conjunction with Mike Ratledge's XRSDoor which can be
  21.      found on QBBS, RemoteAccess, and SuperBBS bulletin boards bulletin
  22.      boards, and is the CP/M equivalent of XRS. XRSDoor used to be called
  23.      variously: QMX, RAX, RAQMX, and RQSeX. CRR will work with Opus,
  24.      Maximus, and XBBS boards when the interface software for these is
  25.      written. CRR also works with Rudi Kuster's XCS (PKT2XRS) 0.47 and
  26.      later. CRR will work with QWK format mail, too.
  27.  
  28.      To be able to use CRR you will need ARK.COM or ARC.COM, UNARC.COM,
  29.      CPMUNARJ.COM or UNZIP.COM, and a text editor which can take a filename
  30.      as a command line argument. For a long time I have used VDE. I now use
  31.      ZDE, the descendent of CP/M VDE. I recommend it.
  32.  
  33.      If you're not using CRR on an Amstrad CPC/PCW or Sinclair Spectrum +3
  34.      in CP/M Plus, you'll need to install it for your terminal. This is
  35.      done by using the supplied program CRRINST.
  36.  
  37.      ----------------------------------------------------------------------
  38.  
  39.      CRR is copyright (C) 1990-1992 Paul Martin.     CRR is copyright (C) 1990-1992 Paul Martin.
  40.  
  41.      CRR is shareware. You are allowed to use it for evaluation purposes
  42.      for a month. After that time you should register it. CRR is not
  43.      crippled if you don't register -- I leave the persuasion to your
  44.      conscience and peer pressure. Please see the file REGISTER.CRR for
  45.      further details.
  46.  
  47.      No charge must be made for CRR's propagation other than that of the
  48.      cost price of the media on which it is distributed. In particular,
  49.                       not     this program may not be distributed by shareware or public domain
  50.                                     express written permission     libraries without the author's express written permission.
  51.  
  52.      No responsibility whatsoever can be taken for any effects of using
  53.                                               as is     this software. This software is supplied as is, and no warranty,
  54.      express or implied, is given for this software.
  55.  
  56.      ----------------------------------------------------------------------
  57.  
  58.      Paul Martin, 85 Hollin Lane, Middleton, Manchester, GB M24 3FE
  59.      Fidonet: Paul Martin 2:250/107        Internet: pm@nowster.demon.co.uk
  60.  
  61.  
  62.  
  63.                            (c) 1990-1992 Paul Martin
  64.  
  65.  
  66.  
  67.      Page [2]                                        CRR 1.50 Documentation
  68.  
  69.      _______ __     _______ __     _______ __     Setting up     Setting up     Setting up
  70.  
  71.      Create a file called DEFAULTS.CRR. This file is not necessary for CRR
  72.      to function, but it allows you to configure your copy. The file should
  73.      contain pairs of lines of the form
  74.  
  75.              PROPERTY
  76.              value
  77.  
  78.      You do not have to specify everything. The properties are:
  79.  
  80.      SCREEN    The length of your screen in lines. (Defaults to 20)
  81.  
  82.      DRIVE     The drive on which the message packet files can be found.
  83.                (eg. B:) (Defaults to current drive)
  84.  
  85.      FASTDRIVE The drive on which temporary files should be put (eg. a
  86.                RAMdisc) (Defaults to current drive)
  87.  
  88.      PACKER    This tells CRR what to call to start your archive program.
  89.                CRR substitutes $1 with the name of the archive, and $2 with
  90.                the intermediate file to be packed. To include a $ in the
  91.                line use $$.
  92.                (Defaults to "ARK $1 $2")
  93.  
  94.      EDITOR    This tells CRR what to call to run your editor. CRR
  95.                substitutes $1 with the name of the file to be edited. To
  96.                include a $ in the line use $$.
  97.                (Defaults to "VDE $1")
  98.  
  99. |    PACKTO    This allows you to have your replies packed onto a different
  100. |              drive from the one you have started CRR on.
  101.  
  102.      SIGN      A one line "signature" that will be put on the bottom of
  103.                every message you write. You can specify up to nine different
  104.                signatures. After the last one you should leave a blank line.
  105.  
  106.      SOFTCR    This property, which has no accompanying value, tells CRR
  107.                that you are using VDE in Ascii mode, and so it can leave
  108.                paragraph formatting to the bulletin board.
  109.  
  110.      KLUDGES   This property, which has no accompanying value, allows CRR to
  111.                display the Fidonet "kludge" lines starting with CTRL-A in
  112.                messages. (Advanced feature)
  113.  
  114.      USEPID    This property, which has no accompanying value, forces CRR to
  115.                use the ^aPID: kludge instead of putting its name on the
  116.                tear line. (Advanced feature)
  117.  
  118.      PADNULL   If your sysop complains that your messages are producing "bad
  119.                packet" errors, you can try including this option. (It
  120.                switches from padding the end of your reply PKT file with end
  121.                of file characters to padding with nulls).
  122.  
  123.      SUMMSKIP  Setting this makes the summary display skip all the preamble
  124.                and just display the "Messages that you selected to read".
  125.  
  126.                            (c) 1990-1992 Paul Martin
  127.  
  128.  
  129.  
  130.      Page [3]                                         CRR 1.50 Documentation
  131.  
  132.  
  133.      NOSTRIP   CRR normally removes spaces from the left hand side of quoted
  134.                messages. Including this stops CRR from stripping the spaces.
  135.  
  136.      USETAG    If this keyword is included CRR will not put a tear line on
  137.                local messages, but put a QWK style tag line instead. This
  138.                option is included for completeness, but it is very unlikely
  139.                that you will ever need to use it.
  140.  
  141. |    VISIBLE   If the bulletin board you use strips tear lines or tag lines,
  142. |              and people can't see you're using CRR, you might like to try
  143. |              this option.
  144.  
  145. |    MAXQUOTE  The maximum length of a quoted line that CRR will put in a
  146. |              reply. Longer lines are split in half. The default for this
  147. |              is 75 characters.
  148.  
  149. |    INTRO     This is the introduction line that is put at the top of
  150. |              replies. A combination of a dollar sign "$" and another
  151. |              character is expanded as follows:
  152.  
  153. |              $F   Who from originally      $T   Who to originally
  154. |              $1   First name of $F         $2   Last name of $F
  155. |              $S   Subject of message       $D   Date of message
  156. |              $/   Start a new line         $$   Dollar sign "$"
  157.  
  158. |              The default for INTRO is "In a message to $T <$D> $F said:"
  159.  
  160.      ORIGIN    The name put in the origin line of messages. More than one
  161.                bulletin board can be specified. There should be a blank line
  162.                after the last entry. The lines contain the node number of
  163.                the bulletin board, a space, and the origin text.
  164.                (eg. 250/107 Aspects, Manchester UK [061-792 0260])
  165.  
  166.      Please note that origin lines are a contentious issue. If the bulletin
  167.      board provides an XORIGIN.XRS file in the message packet, that will be
  168.      used by CRR in preference to the one in your defaults file. Put any
  169.      personal "marks" in the signature line -- that's what it's there for.
  170.  
  171.      It may be that the bulletin board allows you to use your own origin
  172.      line for some message areas, but not others.
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.                            (c) 1990-1992 Paul Martin
  190.  
  191.  
  192.  
  193.      Page [4]                                        CRR 1.50 Documentation
  194.  
  195.      An example file might be:
  196.  
  197.              ORIGIN
  198.              250/107 ASPECTS, Manchester UK [+44 617920260]
  199.              250/102 /\/\erkinstead, Manchester [+44 614347059]
  200.  
  201.              SIGN
  202.              CP/M systems never die, they just get more BIOSed with age.
  203.              There's life in CP/M yet.
  204.  
  205.              SCREEN
  206.              21
  207.              SOFTCR
  208.              SUMMSKIP
  209.              DRIVE
  210.              B:
  211.              EDITOR
  212.              ZDE16 $1 /A
  213.              PACKER
  214.              B:ARK $1 $2
  215. |            PACKTO
  216. |            C:
  217. |            INTRO
  218. |            In a message to $T <$D> $F wrote:$/$/Hello $1,
  219.  
  220.      Having set up the defaults file, put your editor and packer in the
  221.      places that CRR can find them.
  222.  
  223.      You should then configure CRR for your screen using CRRINST.
  224.  
  225.      (Currently the screen is set up to clear the screen on the sequence
  226.      "ESC-E ESC-H", turn on inverse video with "ESC-p", and turn it off
  227.      with "ESC-q". This is for a Heath H19, Zenith or VT52 terminal
  228.      emulator.)
  229.  
  230.      If you have a Real Time Clock and are using CP/M 2.2, or your version
  231.      of CP/M does not read your Real Time Clock, consult the section on
  232.      CRRTIM.Z.
  233.  
  234.      Configure your editor to word wrap. This will make things simpler when
  235.      people quote your messages.
  236.  
  237.      The next step is to log on to the bulletin board, enter its XRSDoor
  238.      section, configure it to read the message areas you want, and select
  239.      the PKZIP or PKARC packing method. This can seem daunting, but it only
  240.      needs to be done once. Then get XRSDoor to pack the messages. You will
  241.      then be asked to download the file BAT1MAIL.ZIP or BAT1MAIL.ARC (this
  242.      is your message packet). Log off the bulletin board. Later versions of
  243.      XRSDoor only support named mail packets (such as ASPECTS1.ZXR or
  244.      ASPECTS1.AXR). These have the same structure. ZXR is a ZIP, LXR is an
  245.      LZH, and AXR is an ARC archive.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.                            (c) 1990-1992 Paul Martin
  253.  
  254.  
  255.  
  256.      Page [5]                                        CRR 1.50 Documentation
  257.  
  258.      If pre-packing of mail is set up on the bulletin board, any pre-packed
  259.      mail will have a different filename which is based on your name. The
  260.      filenames will be similar to "936FA354.ZXR", "936FA354.ZX1", and so
  261.      on. The bit before the dot should be the same for all the bulletin
  262.      boards you use.
  263.  
  264.      The program UNZIP099.COM truncates certain files, and so should not be
  265.      used. If you want to use ZIP compression, use the UNZIP program by
  266.      Dave Goodenough -- not only does it work properly, but it is also
  267.      about eight times smaller. It is supplied with CRR.
  268.  
  269.      Unpack the message packet by typing
  270.  
  271.              UNARC A:BAT1MAIL B:
  272.              or
  273.              UNARC A:ASPECTS1.AXR B:
  274.              or
  275.              UNZIP A:ASPECTS1.ZXR B:
  276.  
  277.      or whatever necessary to put the messages where CRR has been told to
  278.      expect them.
  279.  
  280.      Out of the packet should come
  281.  
  282.              AREAS1.XRS
  283.              BAT1MAIL.XRS
  284.              MAIL1IDX.XRS
  285.              SUMMARY1.XRS
  286.              USER1.XRS
  287.  
  288.      and possibly a few other files with the XRS extension.
  289.  
  290.      You now have enough to start using CRR.
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.                            (c) 1990-1992 Paul Martin
  316.  
  317.  
  318.  
  319.      Page [6]                                        CRR 1.50 Documentation
  320.  
  321.      UNZIP.COM     UNZIP.COM     UNZIP.COM
  322.  
  323.      This program, which is included in the CRR archive, is the latest
  324.      version of an archive extractor program for ZIP-type archives. The
  325.      original author is Dave Goodenough (dg@pallio.uucp). Many
  326.      modifications have been made to the original.
  327.  
  328.      The syntax of UNZIP is:
  329.  
  330.              UNZIP archive[.ext] [dr:][afname]
  331.  
  332.      The file must be a PKZIP-compatible archive. If no destination is
  333.      given, UNZIP just lists the contents of the archive.
  334.  
  335.      Example uses:
  336.  
  337.      UNZIP BAT1MAIL
  338.              lists the contents of BAT1MAIL.ZIP
  339.      UNZIP B:ASPECTS1.ZXR
  340.              lists the contents of B:ASPECTS1.ZXR
  341.      UNZIP BAT1MAIL B:
  342.              extracts all the contents of BAT1MAIL.ZIP to drive B:
  343.      UNZIP ASPECTS1.ZXR B:*.XRS
  344.              extracts all .XRS files to drive B:
  345.  
  346.      Please note that it will only work with files produced by PKZip 1.10     Please note that it will only work with files produced by PKZip 1.10
  347.      and earlier.     and earlier.
  348.  
  349.      CPMUNARJ.COM     CPMUNARJ.COM     CPMUNARJ.COM
  350.  
  351.      There exists a CPMUNARJ.COM by Paul Hunt (a user of ZNODE 62 in Perth,
  352.      Western Australia) which can uncompress .ARJ files. Some old, corrupt
  353.      versions of this (without documentation) are being passed around. The
  354.      version contained in CPMUNARJ.ARK (which also has DARJ.COM for showing
  355.      the contents of .ARJ files) is known to be good.
  356.  
  357.      CPMUNARJ is not supplied with CRR.
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.                            (c) 1990-1992 Paul Martin
  379.  
  380.  
  381.  
  382.      Page [7]                                        CRR 1.50 Documentation
  383.  
  384.      _____ ___     _____ ___     _____ ___     Using CRR     Using CRR     Using CRR
  385.  
  386.      Assuming that you have an unpacked packet, enter the program CRR. (It
  387.      is important that you run CRR on the current drive, and that the file
  388.      CRR.000     CRR.000 is on the current drive too).
  389.  
  390.      After about 15-30 seconds of disc drive whirring you should get a
  391.      copyright message from the XRSDoor package. You will be asked to press
  392.      a key. If you have a correct origin line set it will also be displayed
  393.      at this time.
  394.  
  395.      You will be then shown the main menu which gives you the following
  396.      options:
  397.  
  398. |            (C)ontinue reading
  399.              (R)ead messages [all]
  400.              (M)y mail only
  401.              (O)ne area only
  402.              (S)elect message from summary
  403.  
  404.              (E)nter new message
  405.              (N)etmail enter
  406.  
  407.              (V)iew replies
  408.              (P)ack the responses
  409.  
  410.              (X)ternal command
  411.              (Q)uit
  412.  
  413.      You will not get the netmail option if you have not been allowed to
  414.      send netmail by the sysop of the board you are using.
  415.  
  416.      Packing messages should be the last thing done before you next log on
  417.      to the bulletin board. If there are no replies at the moment, the (V)
  418.      and (P) options do not appear.
  419.  
  420.  
  421.      Reading messages     Reading messages     Reading messages
  422.  
  423.              (R)ead messages [all]
  424.              (M)y mail only
  425.              (O)ne area only
  426.              (S)elect message from summary
  427.  
  428.      These options allow you to read the messages you have downloaded.
  429.  
  430.             R     Option R shows all the messages in the order they were downloaded.
  431.  
  432.             M     Option M shows you all the mail addressed to you.
  433.  
  434.             O     Option O shows you a menu of available message areas, allowing you to
  435.      read the messages in only one area. You enter the number which is
  436.                                       Q     associated with the area name or Q to quit.
  437.  
  438.             S     Option S shows the summary file a screen at a time, allowing you to
  439.                      +     -     browse it using + and -. You can also type in the number of the
  440.  
  441.                            (c) 1990-1992 Paul Martin
  442.  
  443.  
  444.  
  445.      Page [8]                                        CRR 1.50 Documentation
  446.  
  447.      message at which you wish to start reading. If the SUMMSKIP option is
  448.      set then there will be a delay of a few seconds while the summary file
  449.      preamble is skipped. If you press any key whilst it is "skipping" or
  450.      displaying the summary file, it will stop and allow you to enter your
  451.      choice.
  452.  
  453.      While you are reading a message, CRR will pause after every screen.
  454.            SPACE                            ENTER    RETURN     Press SPACE to see the next screenful, ENTER or RETURN to show the
  455.      next line. Any other key will be taken as a menu selection. You can
  456.      also press a menu selection key while the message is displaying -- it
  457.      will be acted upon immediately. (This is similar to "hotkeys" on
  458.      bulletin boards).
  459.  
  460.      At the end of a message you will be shown a menu:
  461.  
  462.      [14/43] (R)eply (-+) (N)ext (P)rev (H)elp:
  463.  
  464.             R     Option R allows you to reply to a message. Upon selecting this option,
  465.      you will be asked whether you want to quote the current message in
  466.                                    Y  N     G           G     your reply. The responses are Y, N and G. Response G allows the tear
  467.      lines, origin lines, and signature lines to be quoted.
  468.  
  469.              N     P     Options N and P move you forwards and backwards through the messages.
  470.  
  471.              -     +     Options - and +, when shown, allow you to follow a "thread" of
  472.                                    -    +     messages. If the message that - or + would take you to is not
  473.      available, nothing will happen. (This function will only work properly
  474.      with XRS-Door/RAQMX 1.40 and later).
  475.  
  476.             H|    Option H shows a full list of the options available.
  477.  
  478.             V     Option V shows the current message again (useful if it's very long).
  479.  
  480.             F|    Option F allows you to forward a message to anyone in an other echo,
  481. |    or netmail area.
  482.  
  483.             Y                                                If there is no     Option Y prints out the current message on the printer. If there is no
  484.      printer attached your computer may crash if you select this option.     printer attached your computer may crash if you select this option.
  485.  
  486.             X     Option X prints out the current message to a file. You will be asked
  487.      for the file name. If the file exists the message will be tagged on to
  488.      the end of existing file.
  489.  
  490.             M|    Option M stops reading and shows the main menu. The difference between
  491.                             Q|    this option and option Q is that you can resume reading at the same
  492.                                                               M|    point after using an option off the main menu if you use M.
  493.  
  494.              <     >|    Options < and > allow you to move one area back or forward, when you
  495. |    are viewing "One area only".
  496.  
  497.             S     Option S saves your position and exits CRR. When you subsequently
  498.      restart CRR it will resume at that same point.
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                            (c) 1990-1992 Paul Martin
  505.  
  506.  
  507.  
  508.      Page [9]                                        CRR 1.50 Documentation
  509.  
  510.      Entering new messages     Entering new messages     Entering new messages
  511.  
  512.              (E)nter new message
  513.              (N)etmail enter
  514.  
  515.             E     Option E allows you to enter a new message in a particular area. You
  516.      will be shown a menu of area names. Enter the number associated with
  517.                       Q     the area name or Q to quit. You will then asked who the message is to,
  518.      and what subject the message should have.
  519.  
  520.             N     Option N, if present, allows you to enter a netmail message. You will
  521.      be asked who the message is to, the netmail address to which this
  522.      message should be sent, and the subject of the message.
  523.  
  524.      To send a netmail message, you will need the FidoNet address of the
  525.      recipient. This should be typed in the normal format. Acceptable
  526.      address types are:
  527.  
  528.              250/107
  529.              250/107.3
  530.              2:250/107
  531.              2:250/107.3
  532.  
  533.  
  534.      Message editing     Message editing     Message editing
  535.  
  536.      When editing a message, do not touch the top four lines:
  537.  
  538.              To: Xxxxx Yyyyyy
  539.              Subject: Test message
  540.              Area: General
  541.  
  542.              Rhubarb rhubarb rhubarb
  543.              rhubarb rhubarb custard
  544.  
  545.      You can edit the name following the To:, and the Subject, but if you
  546.      change the order of the To:, Subject: or Area: lines your message will
  547.      be ignored. You may also edit the Area: line. CRR will try to match
  548.      the area you give firstly with the sysop's name for that area (eg.
  549.      Local Chatter), then with the area's tag (eg. CHATTERBOX), and finally
  550.      interpret it as an area's number (eg. 25). The area name can be
  551.      entered in any case (eg. cHaTTerBoX would match with CHATTERBOX).
  552.  
  553.      There should be a blank line after the Area: line.
  554.  
  555. |    There may be lines starting with ^A or a reverse video A -- don't
  556. |    touch them. In a reply there will be lines starting with ^B or a
  557. |    reverse video B -- if you change them remove the ^B.
  558.  
  559.      If the bulletin board is using a new version of XRSDoor, you will see
  560.      a line with REPLY and a series of numbers at the start of the reply.
  561.      Write beneath it and don't touch it -- it's used by some bulletin
  562.      boards to link together message threads.
  563.  
  564.  
  565.  
  566.  
  567.                            (c) 1990-1992 Paul Martin
  568.  
  569.  
  570.  
  571.      Page [10]                                       CRR 1.50 Documentation
  572.  
  573.      When you've finished editing, use the "Save and Exit" function of your
  574.      editor. In VDE/ZDE this is CTRL-K X. You will be automatically be
  575.      returned to CRR.
  576.  
  577.      Viewing and Packing up     Viewing and Packing up     Viewing and Packing up
  578.  
  579.              (V)iew replies
  580.              (P)ack the responses
  581.  
  582.              (X)ternal Command
  583.              (Q)uit
  584.  
  585.             V     Option V shows you what messages you have written, and allows you to
  586. |    look at the first screen of messages, edit them again, delete them, or
  587. |    forward a copy to anyone in an other message area.
  588.  
  589.             P     Option P packs up the outgoing messages into an archive to be sent to
  590.      the bulletin board. While it is doing this it displays a summary of
  591.      what it is doing. When the packing has completed you will be left in
  592.      CP/M.
  593.  
  594.             X     Option X allows you to execute a CP/M command and return to CRR.
  595.  
  596.             Q     Option Q quits CRR and returns to CP/M.
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.                            (c) 1990-1992 Paul Martin
  631.  
  632.  
  633.  
  634.      Page [11]                                       CRR 1.50 Documentation
  635.  
  636.      ____ ________     ____ ________     ____ ________     User Requests     User Requests     User Requests
  637.  
  638.      All versions of XRS-Door from 1.44 onwards support "user requests".
  639.  
  640.      A user request is a message you send to XRS-Door to turn on/off
  641.      message areas and request files.
  642.  
  643.      To send a request you put a message addressed to XRS in the LOCAL area
  644.      (area 0). Put "UserRequest" in the subject. You then put your requests
  645.      in the body of the message.
  646.  
  647.      To turn on a message area put that area's tag (eg. CPM), the sysop's
  648.      name for it (eg. CPM Echo), or the area number (as shown by the "One
  649.      message area only" option) on one line. If the area name has a dot in
  650.      it, you should "escape" the name by putting a "`" in front of the
  651.      name. The case is not significant.
  652.  
  653.      To turn off a message area you do the same as to turn it on, except
  654.      that you put a minus (-) in front of the name.
  655.  
  656.      To request a file (which will be sent with your mailbag) just put its
  657.      name on a line. The sysop may have turned off the file request
  658.      feature. Please note that any requests containing any of "*?\:" will
  659.      be ignored.
  660.  
  661.      For example:
  662.  
  663.              To: XRS
  664.              Subject: UserRequest
  665.              Area: LOCAL
  666.  
  667.              CPM
  668.              amstrad
  669.              -IBM
  670.              `ENET.SYSOP
  671.              34
  672.              -56
  673.              `-comp.os.cpm
  674.              CRR0140.ZIP
  675.              ZDE16.LBR
  676.  
  677.      would request that areas CPM, AMSTRAD, ENET.SYSOP, and number 36 are
  678.      turned on, and that areas IBM, number 56 and comp.os.cpm are turned
  679.      off. The files CRR0140.ZIP and ZDE16.LBR are requested.
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.                            (c) 1990-1992 Paul Martin
  694.  
  695.  
  696.  
  697.      Page [12]                                       CRR 1.50 Documentation
  698.  
  699.      __________     __________     __________     CRRQWK.CHN     CRRQWK.CHN     CRRQWK.CHN
  700.  
  701.      CRR will work with QWK format mail, and comes with a conversion
  702.      program. If your bulletin board offers XRS-Door and QWK mail, use
  703.      XRS-Door.
  704.  
  705.      CRRQWK has a few extra keywords that can be put in your DEFAULTS.CRR:
  706.  
  707.      QWKIN     With this you tell CRRQWK on which drive it expects to find
  708.                the unpacked QWK mail. The default is the current drive.
  709.                CRRQWK converts from the QWKIN drive to your DRIVE drive.
  710.  
  711.      QWKTIDY   If you include this keyword, CRRQWK will delete any XRS files
  712.                that are on the DRIVE drive, and delete most of the QWK files
  713.                after converting them.
  714.  
  715.      QWKTEAR   If you include this, CRRQWK will put a Fidonet style tear
  716.                line on the end of your messages instead of a QWK tag line.
  717.  
  718. |    QWKCAPS   If the bulletin board you are using expects user names to be
  719. |              in upper case, add this keyword.
  720.  
  721.      eg. part of your DEFAULTS.CRR might look like this:
  722.  
  723.              QWKIN
  724.              C:
  725.              QWKTIDY
  726.              QWKTEAR
  727.  
  728.      To convert a QWK packet into something CRR can work with, extract all
  729.      the files (CRRQWK only really needs the *.DAT files) to your QWKIN
  730.      drive, and run CRR by typing:
  731.  
  732.              CRR QWK
  733.  
  734.      CRR will then run, and execute the CRRQWK.CHN file to convert. When
  735.      the conversion has completed CRR will continue as normal. The
  736.      conversion only has to be done once. Once converted, CRR can be used
  737.      as with an XRS-Door packet.
  738.  
  739.  
  740.      ________     ________     ________     CRRTIM.Z     CRRTIM.Z     CRRTIM.Z
  741.  
  742.      This file is the Z80 assembler language source code for an overlay
  743.      allowing you to change the method which CRR uses to get the current
  744.      time. The file supplied is the one actually used in the supplied
  745.      CRR.COM.
  746.  
  747.      There should be enough source code in CRRTIM.Z to allow any competent
  748.      Z80 programmer to get CRR to read any Real Time Clock.
  749.  
  750.      The version supplied will read the CP/M 3 software clock or with CP/M
  751.      2.2 implement a crude counter.
  752.  
  753.  
  754.  
  755.  
  756.                            (c) 1990-1992 Paul Martin
  757.  
  758.  
  759.  
  760.      Page [13]                                       CRR 1.50 Documentation
  761.  
  762.      ____ _________     ____ _________     ____ _________     Fido Etiquette     Fido Etiquette     Fido Etiquette
  763.  
  764.      When using quoting, only quote the minimum necessary for people to
  765.      follow the thread of the conversation. In general, there should be
  766.      more message than quote.
  767.  
  768.      Keep your messages as short as you can. If a message is more than two
  769.      screens in length it's probably too long.
  770.  
  771.      Leave a blank line between your message and any quote line.
  772.  
  773.      Leave a blank line between paragraphs.
  774.  
  775.      Separate your message into paragraphs. It makes it easier for the eye
  776.      to follow.
  777.  
  778.      Large amounts of blank lines in a message look untidy, especially at
  779.      the end of a message.
  780.  
  781.      Don't feel obliged to reply to every message.
  782.  
  783.      Don't leave private messages in public areas. CRR now only allows
  784.      public messages unless told otherwise by the ACCESSx.XRS file. Private
  785.      messages are always allowed in the LOCAL area. If you want to send a
  786.      private message to someone on another board use netmail.
  787.  
  788.      Don't use echo areas for local chatter.
  789.  
  790.      Don't leave offensive messages. Don't leave messages that would bring
  791.      FidoNet into ill-repute.
  792.  
  793.      Some message areas do not allow the use of signatures. In these areas
  794.      don't include a signature line.
  795.  
  796.      Pedantry for its own sake does not engender good feelings.
  797.  
  798.      Don't use netmail without getting the sysop's consent.
  799.  
  800.      Don't send international netmail without getting the sysop's blessing.
  801.      Grovelling may help. You may be asked to pay. An air-mail letter will
  802.      almost certainly take less time, and may in the long term be cheaper.
  803.  
  804.      Remember that FidoNet is run by enthusiasts who give up their own time
  805.      and money to provide the service.
  806.  
  807.      In short, show due consideration to others.
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.                            (c) 1990-1992 Paul Martin
  820.  
  821.  
  822.  
  823.      Page [14]                                       CRR 1.50 Documentation
  824.  
  825.      ________ __ _______ ______     ________ __ _______ ______     ________ __ _______ ______     Glossary of Fidonet Jargon     Glossary of Fidonet Jargon     Glossary of Fidonet Jargon
  826.  
  827.      Tear line     Tear line. This is a line at the bottom of a message which starts with
  828.      three minus signs, and tells you which software created that message.
  829.      eg.
  830.      --- CRR 1.45+
  831.  
  832.      Origin line     Origin line. This is a line at the bottom of an echomail message which
  833.      tells you on which bulletin board the message was sent. The numbers in
  834.      the brackets are the Fidonet address of that bulletin board. eg.
  835.       * Origin: Aspects Manchester UK [+44-61-792-0260] (RA 2:250/107.3)
  836.  
  837.      Kludge     Kludge. This is a line that starts with a CTRL-A character, and
  838.      contains additional information for the use of mail processing
  839.      software.
  840.  
  841.      PID     PID. This is a kludge, which has the same purpose as a tear line, ie.
  842.      to tell you what software created a message.
  843.  
  844.      Tag line     Tag line. This is a line at the bottom of a message which tells you
  845.      which software was used to create that message. Its use is not popular
  846.      in Fidonet, as software ought to be using tear lines. It is a part of
  847.      the (now outmoded) QWK specification. eg.
  848.       * CRR 1.45+ *
  849.  
  850.      Echomail     Echomail. Messages entered in an echomail conference are "echoed" to
  851.      other bulletin boards that participate in that conference.
  852.  
  853.      Netmail     Netmail. Netmail messages are sent from one bulletin board to another
  854.      (where as echomail is one to many).
  855.  
  856.      Alias     Alias. A "handle" or pseudonym sometimes allowed in some message
  857.      areas. In general, the use of aliases is banned in most echomail
  858.      conferences.
  859.  
  860.      Retearing     Retearing. The incorrect practice of some mail processing software of
  861.      changing the tear line or the PID of a message which passes through
  862.      it.
  863.  
  864.      XRS     XRS. eXpress Response System, the name of the offline message reader
  865.      developed by Mike Ratledge for IBM-PC compatible computers.
  866.  
  867.      QWK     QWK. An offline message reader format. Possibly from QWiK?
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.                            (c) 1990-1992 Paul Martin
  883.  
  884.  
  885.  
  886.      Page [15]                                       CRR 1.50 Documentation
  887.  
  888.      _____ ____ __ ___     _____ ____ __ ___     _____ ____ __ ___     Files used by CRR     Files used by CRR     Files used by CRR
  889.  
  890.      Temporary files:     Temporary files:
  891.  
  892.      EDIT    .CRR   Response currently being edited.
  893.      M???????.CRR   Outgoing messages.
  894.      M00?????.CRR   Outgoing message index.
  895.  
  896.      $$$     .SUB   This is a special record-type submit file, which does
  897.                     not need SUBMIT.COM.
  898.  
  899.      Permanent files:     Permanent files:
  900.  
  901.      CRR     .COM   CRR itself.
  902.      CRR     .000   CRR's overlays.
  903.      CRRSTATE.CRR   Various internal pointers.
  904.  
  905.      User provided files:     User provided files:
  906.  
  907.      DEFAULTS.CRR   Setup file
  908.  
  909.      Message packet files:     Message packet files:
  910.  
  911.      ACCESS1 .XRS (used if present)
  912.      AREAS1  .XRS
  913.      BAT1MAIL.XRS
  914.      MAIL1IDX.XRS
  915.      SUMMARY1.XRS
  916.      USER1   .XRS
  917.      XORIGIN .XRS (used if present)
  918.  
  919.      Response packets:     Response packets: (to be uploaded)
  920.  
  921.      ????????.XXY   ???????? is an 8 digit hex number, unique to you
  922.                     XX is the first two letters of the current day name
  923.                     Y  is the number of the packet
  924.                     eg. 7452FF9B.MO1
  925.  
  926.      The response packet and the .CRR files should be on the same drive as
  927.      the CRR program itself.
  928.  
  929.      ---------------------------------------------------------------------
  930.  
  931.      XRS, XRS-Door, QMX, RAX, and RAQMX are trademarks of Mike Ratledge and
  932.      Smokin' Software.
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.                            (c) 1990-1992 Paul Martin
  946.