home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / bbs / fn132bin / help / read.hlp < prev    next >
Encoding:
Text File  |  1991-09-04  |  5.3 KB  |  102 lines
  1.    Fnordadel Read Tutorial
  2.  
  3.    To send information from the system to you -- usually messages or files,
  4. but also some other miscellaneous things -- you use one of the many .R(ead)
  5. commands.
  6.  
  7.    Typically, .R(ead) is used for viewing messages.  To read new messages in
  8. the current room, for instance, you could use either the single-key command
  9. [N]ew, or the extended command .R(read) N(ew).  In practise, the long form of
  10. the command is never used in this basic fashion.  Instead, it is used with an
  11. array of options that do all sorts of things.
  12.  
  13.    The general form of message- and file-related .R(ead) commands is this:
  14.  
  15.    .R(ead) [<protocol>] [<options>] <command>
  16.  
  17. where <protocol> is optional, and may be one of the following:
  18.  
  19.    X(modem)  -- the standard, 128-byte packet protocol
  20.    Y(modem)  -- Xmodem with 1024-byte packets
  21.    W(xmodem) -- Windowed Xmodem (may not be available)
  22.    V(anilla) -- a pseudo-ASCII transfer terminated by 2 CAN (CTRL-X) chars
  23.    T(ext)    -- display a text file, formatting it as messages are done
  24.    C(apture) -- read anything and capture it in your held message buffer
  25.  
  26. and <options> is optional, and may be a combination of the following:
  27.  
  28.    M(ore)     -- pause between msgs or files
  29.    U(ser)     -- read only msgs from a user
  30.    L(ocal)    -- in a shared room, read only locally-entered msgs
  31.    +(After)   -- msgs/files after a certain date
  32.    -(Before)  -- msgs/files before a certain date
  33.    ~(not)     -- negate a command (use with More, Local, User, Invited)
  34.    =(Headers) -- read only headers of messages
  35.  
  36. and <command> is one of:
  37.  
  38.    A(ll)          -- displays all messages in the room (like [F]orward)
  39.    G(lobal)       -- displays all new messages on the entire system
  40.    N(ew)          -- displays new messages in the room (like [N]ew)
  41.    O(ld)          -- displays old messages in the room (like [O]ld)
  42.    R(everse)      -- displays all messages reversed (like [R]everse)
  43.    D(irectory)    -- lists files in the current directory room
  44.    E(xtended-dir) -- lists files with descriptions
  45.    F(ile)         -- displays or downloads one file
  46.    B(atch file)   -- downloads multiple files in batch mode
  47.  
  48.    Not all of the <protocol> and <options> values make sense together, but a
  49. fair number of combinations are possible.  The bottom line is, try it!  If it
  50. makes any kind of sense, it will probably work!
  51.  
  52.    The M(ore) option is particularly useful, and applies to either message-
  53. reading or directory-viewing.  When used to read messages, M(ore) causes the
  54. system to stop after each message is displayed.  You are given a command
  55. prompt at which a variety of commands are available.  Hit [?] to see them all.
  56. Likewise, when viewing files in a directory, M(ore) causes the system to stop
  57. after each file and give you a command prompt.  Various things can be done at
  58. the prompt, and [?] will show you a list of them all.
  59.  
  60.    The U(ser) option will cause the system to prompt you for a user name.
  61. You need not enter a complete name.  If you enter only a part, the system
  62. will search for that part in each message's author.  So entering "foo" will
  63. match with messages from users "Foo" and "FOObar".
  64.  
  65.    With the +(After) and -(Before) options, the system will prompt you for a
  66. date.  The date should be in normal Citadel format, "YYMMMDD", for example
  67. "91Jun30".  If you leave off the year, the system will assume the current one.
  68.  
  69.    Using a <protocol> with one of the message-reading commands lets you grab
  70. a pile of messages onto your own system, where you can peruse them at great
  71. length without tying up the BBS.  If you compose your replies on your own
  72. system as well, you can upload them to the BBS in a similar fashion using
  73. .E(nter).  See .H(elp) ENTER.
  74.  
  75.    The D(irectory), (Extended-directory), F(ile) and B(atch file) commands
  76. will all need you to indicate a file name template of some kind.  (Also, if
  77. you've set expert mode in .EC, the system will NOT prompt you for the file
  78. mask!)  They're not all the same, however.  For example, .RD, .RE and .RB will
  79. all accept a file name containing wild-cards ("*" to match any number of
  80. characters, and "?" to match any single character).  .RD and .RE will both
  81. take a carriage return to mean "*.*" (i.e., all files), whereas .RB will take
  82. a carriage return to mean all files in your batch list (you set this up in
  83. the file browser, .RME).  .RF is much less flexible; it will take neither
  84. wild-cards nor a carriage return -- you must give a single unique file name.
  85.   
  86.    Other available .R(ead) commands include the following:
  87.  
  88.    .R(ead archive-)H(eader) FOO.ARC -- view the contents of an ARC file; may
  89.                                        also be usable with LZH, ZOO, etc.
  90.                                        files if your Sysop has set them up
  91.    .R(ead) I(nvited)                -- get a list of people invited to the
  92.                                        current room, if private
  93.    .R(ead) S(tatus)                 -- see some user and system status info
  94.    .R(ead) # (message number)       -- read a specifically numbered message.
  95.                                        This is useful in anonymous rooms.
  96.  
  97.    Use ".R(ead) [?]" to get a list of available .R(ead) options.
  98.  
  99. %%SEE ALSO:
  100. %ENTER The Enter command %FILES All about uploading and downloading
  101. %TOPICS Main help topics list
  102.